Out-Host
将输出发送到命令行。
语法
All
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 使用 分页 参数一次显示一页数据。
示例 2：使用变量作为输入
此示例使用存储在变量中的对象作为 Out-Host的输入。
$io = Get-History
Out-Host -InputObject $io
Get-History 获取 PowerShell 会话的历史记录，并将对象存储在 $io 变量中。
Out-Host 使用 InputObject 参数来指定 $io 变量并显示历史记录。
参数
-InputObject
指定写入控制台的对象。 输入包含对象的变量，或键入获取对象的命令或表达式。
参数属性
| 类型: | PSObject |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Paging
指示 Out-Host 一次显示一页输出。 页面大小由主机的特征决定。
输出第一页后，命令在显示剩余页面之前等待用户输入。 按 空格键 显示下一页输出或 Enter 键以查看下一行输出。 按 Q 退出。
使用 分页 类似于使用 更多 命令。
注释
PowerShell ISE 主机不支持 分页 参数。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
PSObject
你可以通过管道将任何对象传递给此 cmdlet。
输出
None
此 cmdlet 不返回任何输出。 它将对象发送到主机进行显示。
备注
PowerShell 包含以下与 Out-Host相关的别名：
- 所有平台：
oh
并非所有 PowerShell 主机都支持 分页 参数。 例如，如果在 Windows PowerShell ISE 中使用 分页 参数，则会显示以下错误：
out-lineoutput：未实现方法或作。
包含 Out 谓词 Out-的 cmdlet 不会设置对象的格式。 它们呈现对象并将其发送到指定的显示目标。 如果将未格式化的对象发送到 Out- cmdlet，则 cmdlet 会在呈现之前将其发送到格式化 cmdlet。
cmdlet Out- 不会从文件读取输入。 若要将数据发送到 Out- cmdlet，请使用管道将数据发送到 cmdlet。 或者，可以将数据存储在变量中，并使用 InputObject 参数将数据传递给 cmdlet。
Out-Host 仅将数据发送到主机。 Tt 不会向管道生成输出对象。 如果将 Out-Host 输出管道到 Get-Member cmdlet，Get-Member 则报告未指定任何对象。
