Out-Host

  • 参考
模块:
Microsoft.PowerShell.Core

将输出发送到命令行。

语法

Out-Host
   [-Paging]
   [-InputObject <PSObject>]
   [<CommonParameters>]

说明

Out-Host cmdlet 将输出发送到 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使用Paging参数一次显示一页数据。

示例 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 退出。

Paging与more命令类似。

注意

PowerShell ISE 主机不支持Paging参数。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

PSObject

你可以通过管道将任何对象传递给此 cmdlet。

输出

None

此 cmdlet 不返回任何输出。 它将对象发送到主机进行显示。

备注

PowerShell 包含 Out-Host 的以下别名：

  • 所有平台：
    • oh

并非所有的 PowerShell 主机都支持Paging参数。 例如，如果在 PowerShell ISE 中使用Paging参数，则会显示以下错误：out-lineoutput : The method or operation is not implemented.

包含Out 谓词 Out- 的 cmdlet 不会设置对象格式。 它们会呈现对象，并将对象发送到指定的显示目标。 如果将未进行格式设置的对象发送给 Out- cmdlet，则该 cmdlet 会在呈现该对象之前，将它发送到格式设置 cmdlet。

Out- cmdlet 没有用于名称或文件路径的参数。 若要将数据发送到 Out- cmdlet，请使用管道将 PowerShell 命令的输出发送到该 cmdlet。 也可将数据存储在变量中，使用InputObject参数将数据传递给 cmdlet。

Out-Host 发送数据，但不生成任何输出对象。 如果将 Out-Host 的输出通过管道传送到 Get-Member cmdlet，则 Get-Member 会报告未指定任何对象。