Out-Host 帮助信息

如下说明是翻译: help Out-Host 产生的帮助信息.

译者: Edengundam(马涛)

 

Out-Host

 

大纲

将输出发送至命令行.

 

语法

Out-Host [-paging] [-inputObject <psobject>] [<CommonParameters>]

 

详细描述

Out-Host cmdlet发送输出到Windows PowerShell宿主进行显示. 宿主在命令行显示输出. 由于Out-Host是默认设置, 除非你想使用它的参数改变显示, 否则你不需要指定它.

 

参数

 

-paging <SwitchParameter>

一次显示输出的一页, 并且在输出其余页之前等待用户输入, 类似传统的"more"命令. 默认情况下, 所有的输出被显示在一页. 页的尺寸由宿主的特性决定.

 

强制参数?	false
参数位置?	named
默认值	False
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-inputObject <psobject>

指定被写入控制台的对象. 输入一个包含对象的变量, 或者一个能够产生对象的命令或表达式.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	true (根据值)
允许通配符扩展?	false

 

<公共参数>

此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".

 

输入类型

Any

 

返回类型

None

 

注意

 

更多信息, 输入"Get-Help Out-Host -detailed".需要技术信息, 输入"Get-Help Out-Host -full".

 

如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".

 

你可以使用Out-Host内建别名"oh". 需要更多信息, 查看About_Alias.

 

Out cmdlets不会对对象进行格式化; 他们只显示这些对象, 然后将他们发送到指定的目标. 如果你给Out cmdlet发送一个没有格式化的对象, cmdlet在显示它前, 先将该对象发送给格式化cmdlet.

 

Out cmdlets没有任何名称或文件路径的参数. 要给Out cmdlets发送数据, 使用管道运算符(|)将Windows PowerShell命令的输出发送给cmdlet. 你也可以将数据存储在变量中, 使用InputObject参数来讲数据传递给cmdlet. 帮助信息, 请看例子.

 

Out-Host发送数据, 但是它不发出任和输出对象. 如果你将Out-Host的输出通过管道发送给Get-Member, Get-Member将会报告没有任何对象被指定.

 

例1

 

C:/PS>get-process | out-host -paging

 

此命令显示系统上的进程, 一次输出一页. 它使用Get-Process取得系统上的进程. 管道运算符(|)将输出发送到Out-Host, 后者在控制台上显示输出. Paging参数一次显示数据的一页.

 

相似的命令格式用于内建在Windows Powershell中的Help函数. 函数从Get-Help取的数据, 然后使用Out-Host的Paging参数一次显示数据的一页: get-help $args[0] | out-host -paging).

 

例2

 

C:/PS>$a = get-history

 

C:/PS>out-host -InputObject $a

 

这些命令显示会话中命令的历史记录. 第一个命令使用Get-History cmdlet获取会话的历史, 然后它将历史信息存储在$a变量中. 第二个命令使用Out-Host显示变量$a中的内容, 并使用InputObject参数为Out-Host指定参数.

 

相关链接

Out-Printer

Out-Null

Out-File

Out-String

Out-Default

Write-Host