Out-String 帮助信息

[align=left]如下说明是翻译: help Out-String 产生的帮助信息. [/align]
[align=left]译者: Edengundam(马涛)[/align]

[align=left]Out-String[/align]
[align=left] [/align]
[align=left]大纲[/align]
[align=left]将对象作为连续的字符串发送到宿主上(Host).[/align]
[align=left] [/align]
[align=left]语法[/align]
[align=left]Out-String [-inputObject <psobject>] [-width <int>] [-stream] [<CommonParameters>][/align]
[align=left] [/align]
[align=left]详细描述[/align]
[align=left]Out-String cmdlet将Windows PowerShell管理的对象转换为字符串数组. 默认情况下, Out-String将积累这些字符串, 最后将其作为一个整体返回, 但是你能够使用stream参数使Out-String一次返回一个字符串. 当对象的操作不太方便时, 此cmdlet使得你像使用传统shell一样搜索和操作字符串输出.[/align]
[align=left] [/align]
[align=left]参数[/align]
[align=left] [/align]
[align=left]-inputObject <psobject>[/align]
[align=left]指定要被转换成字符串的对象. 输入一个包含对象的变量, 或者一个能够产生对象的命令或表达式.[/align]
[align=left] [/align]

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

[align=left] [/align]
[align=left]-width <int>[/align]
[align=left]指定每行输出字符的数量. 多余的字符将被截断, 而非换行继续显示. 如果你忽略此参数, 宽度将通过宿主的特征决定. PowerShell.exe宿主的默认宽度为80 (字符).[/align]
[align=left] [/align]

[align=left]强制参数?[/align]	[align=left]false[/align]
[align=left]参数位置?[/align]	[align=left]named[/align]
[align=left]默认值[/align]	[align=left]80[/align]
[align=left]允许从管道绑定输入?[/align]	[align=left]false[/align]
[align=left]允许通配符扩展?[/align]	[align=left]false[/align]

[align=left] [/align]
[align=left]-stream <SwitchParameter>[/align]
[align=left]为每个对象独立地发送字符串. 默认情况下, 每个对象的字符串被累积, 最后作为一个字符串输送.[/align]
[align=left] [/align]

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

[align=left] [/align]
[align=left]<公共参数>[/align]
[align=left]此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".[/align]
[align=left] [/align]
[align=left]输入类型[/align]
[align=left]Any[/align]
[align=left] [/align]
[align=left]返回类型[/align]
[align=left]String[/align]
[align=left] [/align]
[align=left]注意[/align]
[align=left] [/align]
[align=left]更多信息, 输入"Get-Help Out-String -detailed".需要技术信息, 输入"Get-Help Out-String -full".[/align]
[align=left] [/align]
[align=left]如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".[/align]
[align=left] [/align]
[align=left]Out cmdlets不会对对象进行格式化; 他们只显示这些对象, 然后将他们发送到指定的目标. 如果你给Out cmdlet发送一个没有格式化的对象, cmdlet在显示它前, 先将该对象发送给格式化cmdlet.[/align]
[align=left] [/align]
[align=left]Out cmdlets没有任何名称或文件路径的参数. 要给Out cmdlets发送数据, 使用管道运算符(|)将Windows PowerShell命令的输出发送给cmdlet. 你也可以将数据存储在变量中, 使用InputObject参数来讲数据传递给cmdlet. 帮助信息, 请看例子.[/align]
[align=left] [/align]
[align=left]例1 [/align]
[align=left] [/align]
[align=left]C:/PS>get-content C:/test1/testfile2.txt | out-string[/align]
[align=left] [/align]
[align=left]此命令将Testfile2.txt文件中的内容作为一个字符串发送到控制台. 它使用Get-Content cmdlet取得文件中的内容. 管道运算符(|)江内容发送给Out-String, 后者将该内容作为一个字符串发送到控制台.[/align]
[align=left] [/align]
[align=left]例2 [/align]
[align=left] [/align]
[align=left]C:/PS>$c = get-culture | select-object *[/align]
[align=left] [/align]
[align=left]out-string -inputobject $c -width 100[/align]
[align=left] [/align]
[align=left]这些命令获得当前用户设置的区域设置, 并将数据转化为字符串. 第一个命令使用Get-Culture cmdlet取得区域设置. 管道运算符(|)将结果发送给Select-Object cmdlet, 后者从Get-Culture命令返回的区域设置对象上, 选择所有的属性(*). 接下来命令将输出存储到$c变量中.[/align]
[align=left] [/align]
[align=left]第二命令使用Out-String将CultureInfo对象转换为一系列的字符串; 每个字符串表示一个属性. 它使用InputObject参数将$c变量传递给Out-String. 参数width设置为每行100个字符, 用来防止截断.[/align]
[align=left] [/align]
[align=left]例3 [/align]
[align=left] [/align]
[align=left]C:/PS>get-alias | out-string -stream | select-string "Get-Command"[/align]
[align=left] [/align]
[align=left]此命令显示包含短语"Get-Command"的别名. 它使用Get-Alias cmdlet取得一组AliasInfo对象; 每个对象表示shell中一个别名. 这个例子揭示了使用对象和字符串的区别.[/align]
[align=left] [/align]
[align=left]管道运算符(|)将Get-Alias的结果发送给Out-String, 后者将对象转换为一系列的字符串. 使用-stream参数独立地发送每个字符串, 而不是将他们做一个单独的字符串. 后一个管道运算符将字符串发送给Select-String, 后者选择那些在任意位置, 包含"Get-Command"的字符串. [/align]
[align=left] [/align]
[align=left]如果你忽略-stream参数, 命令将会显示所有别名, 这是因为Select-String在Out-String返回的唯一一个字符串中查找"Get-Command", 格式器将以表的形式显示选择的字符串.[/align]
[align=left] [/align]
[align=left]相关链接[/align]
[align=left]Out-File[/align]
[align=left]Out-Null[/align]
[align=left]Out-Host[/align]
[align=left]Out-Printer[/align]
[align=left]Out-Default[/align]