ForEach-Object

ForEach-Object
    [-Process] <ScriptBlock[]>
    [-InputObject <PSObject>]
    [-Begin <ScriptBlock>]
    [-End <ScriptBlock>]
    [-RemainingScripts <ScriptBlock[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ForEach-Object
    [-MemberName] <String>
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

El cmdlet ForEach-Object realiza una operación en cada elemento de una colección de objetos de entrada. Los objetos de entrada se pueden canalizar al cmdlet o especificarse mediante el parámetro InputObject .

A partir de Windows PowerShell 3.0, hay dos maneras diferentes de construir un comando ForEach-Object.

• bloque script. Puede usar un bloque de script para especificar la operación. Dentro del bloque de script, use la $_ variable para representar el objeto actual. El bloque de script es el valor del parámetro Process . El bloque de script puede contener cualquier script de PowerShell.

  Por ejemplo, el siguiente comando obtiene el valor de la propiedad ProcessName de cada proceso del equipo.

  Get-Process | ForEach-Object {$_.ProcessName}

• instrucción Operation. También puede escribir una instrucción operation, que es mucho más similar al lenguaje natural. Puede usar la instrucción operation para especificar un valor de propiedad o llamar a un método. Las instrucciones de operación se introdujeron en Windows PowerShell 3.0.

  Por ejemplo, el siguiente comando también obtiene el valor de la propiedad ProcessName de cada proceso del equipo.

  Get-Process | ForEach-Object ProcessName

  Al usar el formato de bloque de script, además de usar el bloque de script que describe las operaciones que se realizan en cada objeto de entrada, puede proporcionar dos bloques de script adicionales. El bloque Begin script, que es el valor del parámetro Begin, se ejecuta antes de que este cmdlet procese el primer objeto de entrada. El bloque End script, que es el valor del parámetro End, se ejecuta después de que este cmdlet procese el último objeto de entrada.

30000, 56798, 12432 | ForEach-Object -Process {$_/1024}

29.296875
55.466796875
12.140625

Este comando toma una matriz de tres enteros y divide cada uno de ellos en 1024.

Get-ChildItem $pshome | ForEach-Object -Process {if (!$_.PSIsContainer) {$_.Name; $_.Length / 1024; " " }}

Este comando obtiene los archivos y directorios del directorio de instalación de PowerShell $pshome y los pasa al cmdlet ForEach-Object. Si el objeto no es un directorio, el bloque de script obtiene el nombre del archivo, divide el valor de su propiedad Length en 1024 y agrega un espacio (" ") para separarlo de la entrada siguiente. El cmdlet usa la propiedad PSISContainer para determinar si un objeto es un directorio.

$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}

Este comando obtiene los 1000 eventos más recientes del registro de eventos del sistema y los almacena en la variable $Events. A continuación, canaliza los eventos al cmdlet ForEach-Object.

El parámetro Begin muestra la fecha y hora actuales. A continuación, el parámetro Process usa el cmdlet para crear un archivo de texto denominado events.txt y almacena la propiedad message de cada uno de los eventos de ese archivo. Por último, el parámetro End se usa para mostrar la fecha y hora después de que se haya completado todo el procesamiento.

Get-ItemProperty -Path HKCU:\Network\* | ForEach-Object {Set-ItemProperty -Path $_.PSPath -Name RemotePath -Value $_.RemotePath.ToUpper();}

Este comando cambia el valor del RemotePath entrada del Registro en todas las subclaves de la clave HKCU:\Network a texto en mayúsculas. Puede usar este formato para cambiar el formulario o el contenido de un valor de entrada del Registro.

Cada subclave de la red clave representa una unidad de red asignada que se volverá a conectar al iniciar sesión. La entrada RemotePath contiene la ruta de acceso UNC de la unidad conectada. Por ejemplo, si asigna la unidad E: a \\Server\Share, habrá una subclave E de HKCU:\Network y el valor de la entrada del Registro remotePath en la subclave E será \\Server\Share.

El comando usa el cmdlet para obtener todas las subclaves de la clave de Network y el cmdlet para cambiar el valor de la entrada del Registro remotePath de en cada clave. En el Set-ItemProperty comando , la ruta de acceso es el valor de la propiedad PSPath de la clave del Registro. Se trata de una propiedad del objeto de Microsoft .NET Framework que representa la clave del Registro, no una entrada del Registro. El comando usa el método ToUpper() del valor de RemotePath, que es una cadena (REG_SZ).

Dado que Set-ItemProperty cambia la propiedad de cada clave, el ForEach-Object cmdlet es necesario para acceder a la propiedad .

1, 2, $null, 4 | ForEach-Object {"Hello"}

Hello
Hello
Hello
Hello

En este ejemplo se muestra el efecto de canalización de la $Null variable automática al ForEach-Object cmdlet .

Dado que PowerShell trata null como marcador de posición explícito, el cmdlet ForEach-Object genera un valor para $Null, igual que para otros objetos que se canalizan a él.

Para obtener más información sobre la variable automática $Null, consulte about_Automatic_Variables.

Get-Module -ListAvailable | ForEach-Object -MemberName Path
Get-Module -ListAvailable | Foreach Path

Estos comandos obtienen el valor de la propiedad path de de todos los módulos de PowerShell instalados. Usan el parámetro MemberName para especificar la propiedad path path de los módulos.

El segundo comando es equivalente al primero. Usa el alias Foreach del cmdlet y omite el nombre del parámetro MemberName, que es opcional.

El cmdlet ForEach-Object es muy útil para obtener valores de propiedad, ya que obtiene el valor sin cambiar el tipo, a diferencia de los cmdlets de Format o el cmdlet Select-Object, que cambian el tipo de valor de propiedad.

"Microsoft.PowerShell.Core", "Microsoft.PowerShell.Host" | ForEach-Object {$_.Split(".")}
"Microsoft.PowerShell.Core", "Microsoft.PowerShell.Host" | ForEach-Object -MemberName Split -ArgumentList "."
"Microsoft.PowerShell.Core", "Microsoft.PowerShell.Host" | Foreach Split "."

Microsoft
PowerShell
Core
Microsoft
PowerShell
Host

Estos comandos dividen dos nombres de módulo separados por puntos en sus nombres de componente. Los comandos llaman al método Split de cadenas. Los tres comandos usan una sintaxis diferente, pero son equivalentes e intercambiables.

El primer comando usa la sintaxis tradicional, que incluye un bloque de script y el operador $_de objeto actual. Usa la sintaxis de punto para especificar el método y paréntesis para incluir el argumento delimitador.

El segundo comando usa el parámetro MemberName para especificar el método Split y el parámetro argumentName para identificar el punto (".") como delimitador dividido.

El tercer comando usa el alias Foreach del cmdlet foreach-Object y omite los nombres de los parámetros MemberName y ArgumentList, que son opcionales.

La salida de estos tres comandos, que se muestra a continuación, es idéntica.

split es solo uno de los muchos métodos útiles de cadenas. Para ver todas las propiedades y métodos de las cadenas, canalice una cadena al cmdlet Get-Member.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Puede canalizar cualquier objeto a este cmdlet.

Este cmdlet devuelve objetos determinados por la entrada.

• El cmdlet funciona de forma similar a la instrucción Foreach, salvo que no se puede canalizar la entrada a una instrucción foreach de . Para obtener más información sobre la instrucción foreach de , vea about_Foreach.
• A partir de PowerShell 4.0, Where y ForEach se agregaron métodos para su uso con colecciones.
• Puede obtener más información sobre estos nuevos métodos aquí about_arrays