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