ForEach-Object

Sintaxe

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

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

Description

O cmdlet forEach-Object executa uma operação em cada item em uma coleção de objetos de entrada. Os objetos de entrada podem ser canalizados para o cmdlet ou especificados usando o parâmetro InputObject.

A partir do Windows PowerShell 3.0, há duas maneiras diferentes de construir um comando ForEach-Object.

• do bloco script . Você pode usar um bloco de script para especificar a operação. Dentro do bloco de script, use a variável $_ para representar o objeto atual. O bloco de script é o valor do parâmetro Process. O bloco de script pode conter qualquer script do PowerShell.

  Por exemplo, o comando a seguir obtém o valor da propriedade ProcessName de cada processo no computador.

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

• instrução Operation. Você também pode escrever uma instrução de operação, que é muito mais parecida com a linguagem natural. Você pode usar a instrução de operação para especificar um valor de propriedade ou chamar um método. As instruções de operação foram introduzidas no Windows PowerShell 3.0.

  Por exemplo, o comando a seguir também obtém o valor da propriedade ProcessName de cada processo no computador.

  Get-Process | ForEach-Object ProcessName

  Ao usar o formato de bloco de script, além de usar o bloco de script que descreve as operações executadas em cada objeto de entrada, você pode fornecer dois blocos de script adicionais. O bloco de script Begin, que é o valor do parâmetro Begin, é executado antes que esse cmdlet processe o primeiro objeto de entrada. O bloco de script final, que é o valor do parâmetro End, é executado depois que esse cmdlet processa o último objeto de entrada.

Exemplos

Exemplo 1: dividir inteiros em uma matriz

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

29.296875
55.466796875
12.140625

Esse comando usa uma matriz de três inteiros e divide cada um deles por 1024.

Exemplo 2: Obter o comprimento de todos os arquivos em um diretório

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

Esse comando obtém os arquivos e diretórios no diretório de instalação do PowerShell $pshome e os passa para o cmdlet ForEach-Object. Se o objeto não for um diretório, o bloco de script obterá o nome do arquivo, dividirá o valor de sua propriedade Length em 1024 e adicionará um espaço (" ") para separá-lo da próxima entrada. O cmdlet usa a propriedade PSISContainer para determinar se um objeto é um diretório.

Exemplo 3: Operar nos eventos mais recentes do Sistema

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

Esse comando obtém os 1.000 eventos mais recentes do log de eventos do sistema e os armazena na variável $Events. Em seguida, ele redireciona os eventos para o cmdlet ForEach-Object.

O parâmetro Begin exibe a data e a hora atuais. Em seguida, o parâmetro Process usa o cmdlet Out-File para criar um arquivo de texto chamado events.txt e armazena a propriedade de mensagem de cada um dos eventos nesse arquivo. Por fim, o parâmetro End é usado para exibir a data e a hora após a conclusão de todo o processamento.

Exemplo 4: alterar o valor de uma chave do Registro

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

Esse comando altera o valor da entrada do registro RemotePath em todas as subchaves na chave HKCU:\Network para texto em letras maiúsculas. Você pode usar esse formato para alterar o formulário ou o conteúdo de um valor de entrada do Registro.

Cada subchave na chave Network representa uma unidade de rede mapeada que se reconectará no logon. A entrada RemotePath contém o caminho UNC da unidade conectada. Por exemplo, se você mapear a unidade E: para \\Server\Share, haverá uma subchave E de HKCU:\Network e o valor do RemotePath entrada do registro na subchave E será \\Server\Share.

O comando usa o cmdlet para obter todas as subchaves da chave de de Rede e o cmdlet para alterar o valor da entrada do registro RemotePath em cada chave. No comando Set-ItemProperty, o caminho é o valor da propriedade PSPath da chave do Registro. Essa é uma propriedade do objeto Microsoft .NET Framework que representa a chave do Registro, não uma entrada do Registro. O comando usa o método ToUpper() do valor RemotePath, que é uma cadeia de caracteres (REG_SZ).

Como Set-ItemProperty está alterando a propriedade de cada chave, o cmdlet ForEach-Object é necessário para acessar a propriedade.

Exemplo 5: Usar a variável automática $Null

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

Hello
Hello
Hello
Hello

Este exemplo mostra o efeito de canalizar a variável $Null automática para o cmdlet ForEach-Object.

Como o PowerShell trata nulo como um espaço reservado explícito, o cmdlet ForEach-Object gera um valor para $Null, assim como acontece com outros objetos que você redireciona para ele.

Para obter mais informações sobre a variável automática $Null, consulte about_Automatic_Variables.

Exemplo 6: Obter valores de propriedade

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

Esses comandos obtém o valor da propriedade Path de todos os módulos instalados do PowerShell. Eles usam o parâmetro MemberName para especificar a propriedade Path de módulos.

O segundo comando é equivalente ao primeiro. Ele usa o alias Foreach do cmdlet e omite o nome do parâmetro MemberName, que é opcional.

O cmdlet é muito útil para obter valores de propriedade, pois obtém o valor sem alterar o tipo, diferentemente dos cmdlets formatar ou o cmdlet , que altera o tipo de valor da propriedade.

Exemplo 7: Dividir nomes de módulo em nomes de componente

"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

Esses comandos dividem dois nomes de módulo separados por pontos em seus nomes de componente. Os comandos chamam o método Split de cadeias de caracteres. Os três comandos usam sintaxe diferente, mas são equivalentes e intercambiáveis.

O primeiro comando usa a sintaxe tradicional, que inclui um bloco de script e o operador de objeto atual $_. Ele usa a sintaxe de ponto para especificar o método e parênteses para colocar o argumento delimitador.

O segundo comando usa o parâmetro MemberName para especificar o método Split e o parâmetro ArgumentName para identificar o ponto (".") como o delimitador dividido.

O terceiro comando usa o alias Foreach do cmdlet Foreach-Object e omite os nomes dos parâmetros MemberName e ArgumentList, que são opcionais.

A saída desses três comandos, mostrada abaixo, é idêntica.

Divisão é apenas um dos muitos métodos úteis de cadeias de caracteres. Para ver todas as propriedades e métodos de cadeias de caracteres, redirecione uma cadeia de caracteres para o cmdlet Get-Member.

Parâmetros

-ArgumentList

-Begin

-Confirm

-End

-InputObject

-MemberName

-Process

-RemainingScripts

-WhatIf

Entradas

PSObject

Você pode redirecionar qualquer objeto para este cmdlet.

Saídas

PSObject

Esse cmdlet retorna objetos que são determinados pela entrada.

Observações

• O cmdlet funciona muito parecido com a instrução foreach , exceto que você não pode canalizar a entrada para uma instrução foreach . Para obter mais informações sobre a instrução Foreach, consulte about_Foreach.
• A partir do PowerShell 4.0, métodos Where e ForEach foram adicionados para uso com coleções.
• Você pode ler mais sobre esses novos métodos aqui about_arrays

Links Relacionados

• Compare-Object
• Where-Object
• Group-Object
• Measure-Object
• New-Object
• Select-Object
• Sort-Object
• Tee-Object