Out-Host
将输出发送到命令行。
语法
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]
说明
cmdlet Out-Host
将输出发送到 PowerShell 主机进行显示。 该主机在命令行上显示输出。 因为 Out-Host
是默认值,所以除非要使用其参数,否则不必指定它。
Out-Host
会自动追加到执行的每个命令。 它将管道的输出传递给执行命令的主机。 Out-Host
忽略 ANSI 转义序列。 转义序列由主机处理。 Out-Host
将 ANSI 转义序列传递给主机,而不尝试解释或更改它们。
示例
示例 1:一次显示一页输出
此示例显示系统一次处理一页。
Get-Process | Out-Host -Paging
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
30 24.12 36.95 15.86 21004 14 ApplicationFrameHost
55 24.33 60.48 10.80 12904 14 BCompare
<SPACE> next page; <CR> next line; Q quit
9 4.71 8.94 0.00 16864 14 explorer
<SPACE> next page; <CR> next line; Q quit
Get-Process
获取系统进程,并在管道中向下发送对象。 Out-Host
使用 分页 参数一次显示一页数据。
示例 2:使用变量作为输入
此示例使用存储在变量中的 对象作为 的 Out-Host
输入。
$io = Get-History
Out-Host -InputObject $io
Get-History
获取 PowerShell 会话的历史记录,并将 对象存储在 变量中 $io
。
Out-Host
使用 InputObject 参数指定 $io
变量并显示历史记录。
参数
-InputObject
指定要写入控制台的对象。 输入一个包含对象的变量,或键入可获取对象的命令或表达式。
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Paging
指示一 Out-Host
次显示一页输出,并在显示剩余页面之前等待用户输入。 默认情况下,所有输出都显示在单个页面上。 页大小由主机的特征确定。
按 空格 键显示下一页输出,或按 Enter 键查看下一行输出。 按 Q 退出。
分页 类似于 more 命令。
注意
PowerShell ISE 主机不支持 分页 参数。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
你可以通过管道将任何对象传递给此 cmdlet。
输出
None
此 cmdlet 不返回任何输出。 它将对象发送到主机进行显示。
备注
PowerShell 包含以下别名 Out-Host
:
- 所有平台:
oh
并非所有 PowerShell 主机都支持 分页 参数。 例如,如果在 PowerShell ISE 中使用 分页 参数,则会显示以下错误: out-lineoutput : The method or operation is not implemented.
包含 Out 谓词 Out-
的 cmdlet 不会设置对象的格式。 它们呈现对象并将其发送到指定的显示目标。 如果将未格式化的对象发送到 Out-
cmdlet,该 cmdlet 会在呈现前将其发送到格式化 cmdlet。
cmdlet Out-
没有名称或文件路径的参数。 若要将数据发送到 Out-
cmdlet,请使用管道将 PowerShell 命令的输出发送到 cmdlet。 或者,可以将数据存储在变量中,并使用 InputObject 参数将数据传递给 cmdlet。
Out-Host
发送数据,但不生成任何输出对象。 如果将 的 Out-Host
输出管道传递给 Get-Member
cmdlet, Get-Member
则报告未指定任何对象。