ForEach-Object 帮助信息

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

译者: Edengundam(马涛)

 

ForEach-Object

 

摘要

对输入集合中每个对象执行操作.

 

语法

ForEach-Object [-process] <ScriptBlock[]> [-inputObject <psobject>] [-begin <scriptblock>] [-end <scriptblock>] [<CommonParameters>]

 

详细描述

对输入集合中每个对象执行操作. 输入对象可以从管道传递给cmdlet或通过InputObject参数指定.

执行的操作通过提供共给cmdlet的Process参数的代码块描述. 代码块可以包含任意Windows PowerShell脚本.

 

在脚本块中, 当前输入对象使用$_变量表示.

 

除了能够为输入的每个对象指定一个进行操作的脚本块外, 你还可以提供两个额外的脚本块. 一个作为Begin参数的参数值, 在处理任何输入对象之前运行. 另一个作为End参数的参数值, 在处理完所有输入对象后执行.

 

脚本块求值的结果(包括由Begin和End产生的)沿着管道继续传递.

 

参数

 

-process <ScriptBlock[]>

指定为每个输入对象进行处理的脚本块.

 

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

 

-inputObject <psobject>

接受一个对象, 并将其作为Process参数指定的脚本块进行操作的对象. 输入一个包含对象的变量, 或者一个能够产生对象的命令或表达式.

 

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

 

-begin <scriptblock>

指定用于在处理任何输入对象之前运行的脚本块.

 

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

 

-end <scriptblock>

指定用于在处理完所有输入对象之后执行的脚本块.

 

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

 

<公共参数>

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

 

输入类型

Object

 

注意

 

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

 

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

 

例1

 

C:/PS>30000,56798,12432 | foreach-object -process {$_/1024}

 

此命令接受一个由整数构成的数组, 并将其中每个元素除以1024, 并将结果输出.

 

例2

 

C:/PS>get-childitem C:/ | foreach-object -process { $_.length / 1024 }

 

此命令取得C驱动下的文件和目录, 并显示它们的占用空间大小. 数值0表示目录没有文件大小这一参数(译者注: 实际上长度为0的文件, 也会导致一样的结果, 因此不能将文件大小为0作为判断文件和目录的依据).

 

例3

 

C:/PS>$events = get-eventlog -logname system -newest 1000

$events |

foreach-object -begin {get-date}

-process {out-file -filepath events.txt -append -inputobject $_.message}

-end {get-date}

 

此命令取得最近1000项系统日志信息, 并将它们存储到变量$events中. 接下来将这些日志通过管道传递给ForEach-Object cmdlet. 参数Begin显示当前时间和日期. 下一个参数是Process, 利用Out-File cmdlet创建一个名叫events.txt的文本文件, 并将每个时间的message属性信息存储到该文件中. 最后是End参数, 它被用来显示当所有处理结束时的日期和时间.

 

例4

 

C:/PS>get-itemproperty -path hkcu:/Network/* |

 foreach-object {set-itemproperty -path $_.pspath -name RemotePath

-value $_.RemotePath.ToUpper();}

 

此命令通过使用Set-ItemProperty更新一组注册表项. 注册表项指定的是计算机上映射网络驱动器的UNC路径. 此命令改变UNC路径中的字母为大写字母. 实际情境中, 你可能需要改变服务器名称或路径中某个部分.

 

由于Set-ItemProperty cmdlet一次更新一个属性, ForEach-Object cmdlet将会针对每个需要更改的属性(这个例子中就是: 注册表项)调用一次Set-ItemProperty. 注册表项的名称是RemotePath, 位于HKCU/Network/<mapped drive letter>位置. 通过使用Get-ItemProperty cmdlet取得表示这些注册表项的对象, 并将它们通过管道作为输入传递给ForEach-Object. 在ForEach-Object中调用Set-ItemProperty时, 变量$_持有一个正在处理的注册表项对象的引用. 属性PSPath的值是保存当前项的注册表项. RemotePath属性的类型为System.String, 因此它包含了ToUpper方法, 用来将项的内容转换为大写形式.

 

相关链接

Where-Object

Compare-Object

Group-Object

Select-Object

Sort-Object