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>]

Cmdleten ForEach-Object utför en åtgärd på varje objekt i en samling indataobjekt. Indataobjekten kan skickas till cmdleten eller anges med hjälp av parametern InputObject .

Från och med Windows PowerShell 3.0 finns det två olika sätt att konstruera ett ForEach-Object kommando.

• Syntax för skriptblock. Du kan använda ett skriptblock för att ange åtgärden. Använd variabeln i skriptblocket $_ för att representera det aktuella objektet. Skriptblocket är värdet för parametern Process . Skriptblocket kan innehålla valfritt PowerShell-skript.

  Följande kommando hämtar till exempel värdet för egenskapen ProcessName för varje process på datorn.

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

  ForEach-Object stöder blocken begin, processoch end enligt beskrivningen i about_Functions.

  Anmärkning

  Skriptblocken körs i anroparens omfång. Därför har blocken åtkomst till variabler i det omfånget och kan skapa nya variabler som finns kvar i omfånget när cmdleten har slutförts.

• Förenklad syntax. Med den förenklade syntaxen anger du ett egenskaps- eller metodnamn för objektet i pipelinen. ForEach-Object returnerar värdet för egenskapen eller metoden för varje objekt i pipelinen.

  Följande kommando hämtar till exempel även värdet för egenskapen ProcessName för varje process på datorn.

  Get-Process | ForEach-Object ProcessName

  Den förenklade syntaxen introducerades i Windows PowerShell 3.0. Mer information finns i about_Simplified_Syntax.

Det här exemplet tar en matris med tre heltal och delar var och en av dem med 1024.

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

29.296875
55.466796875
12.140625

Det här exemplet bearbetar filerna och katalogerna i PowerShell-installationskatalogen $PSHOME.

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

Om objektet inte är en katalog hämtar skriptblocket namnet på filen, delar upp värdet för egenskapen Length med 1024 och lägger till ett blanksteg (" ") för att skilja det från nästa post. Cmdleten använder egenskapen PSIsContainer för att avgöra om ett objekt är en katalog.

I det här exemplet skrivs de 1 000 senaste händelserna från systemhändelseloggen till en textfil. Den aktuella tiden visas före och efter bearbetning av händelserna.

Get-EventLog -LogName System -Newest 1000 |
    ForEach-Object -Begin {Get-Date} -Process {
        Out-File -FilePath Events.txt -Append -InputObject $_.Message
    } -End {Get-Date}

Get-EventLog hämtar de 1 000 senaste händelserna från systemhändelseloggen och skickar dem till cmdleten ForEach-Object . Parametern Begin visar aktuellt datum och tid. Därefter använder parametern Process cmdleten Out-File för att skapa en textfil med namnet events.txt och lagrar meddelandeegenskapen för var och en av händelserna i filen. Sist används parametern End för att visa datum och tid när all bearbetning har slutförts.

I det här exemplet ändras värdet för RemotePath-registerposten i alla undernycklar under HKCU:\Network nyckeln till versaler.

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

Du kan använda det här formatet för att ändra formuläret eller innehållet i ett registerpostvärde.

Varje undernyckel i nätverksnyckeln representerar en mappad nätverksenhet som återansluter vid inloggning. RemotePath-posten innehåller UNC-sökvägen för den anslutna enheten. Om du till exempel mappar E: enheten till \\Server\Shareskapas en E-undernyckel i HKCU:\Network med registervärdet RemotePath inställt på \\Server\Share.

Kommandot använder cmdleten Get-ItemProperty för att hämta alla undernycklar för nätverksnyckeln och cmdleten Set-ItemProperty för att ändra värdet för RemotePath-registerposten i varje nyckel. Set-ItemProperty I kommandot är sökvägen värdet för PSPath-egenskapen för registernyckeln. Det här är en egenskap för Microsoft .NET Framework-objektet som representerar registernyckeln, inte en registerpost. Kommandot använder metoden ToUpper() för RemotePath-värdet , som är en sträng REG_SZ.

Eftersom Set-ItemProperty ändrar egenskapen för varje nyckel krävs cmdleten ForEach-Object för att få åtkomst till egenskapen.

Det här exemplet visar effekten av att skicka den $null automatiska variabeln till cmdleten ForEach-Object .

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

Hello
Hello
Hello
Hello

Eftersom PowerShell behandlar $null som en explicit platshållare genererar cmdleten ForEach-Object ett värde för $null som det gör för andra objekt som skickas till den.

Det här exemplet hämtar värdet för egenskapen Path för alla installerade PowerShell-moduler med parametern MemberName i cmdleten ForEach-Object .

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

Det andra kommandot motsvarar det första. Den använder aliaset Foreach för cmdleten ForEach-Object och utelämnar namnet på parametern MemberName , som är valfri.

Cmdleten ForEach-Object är användbar för att hämta egenskapsvärden, eftersom den hämtar värdet utan att ändra typen, till skillnad från cmdletarna Format eller cmdleten Select-Object , som ändrar egenskapsvärdetypen.

Det här exemplet visar tre sätt att dela upp två punktavgränsade modulnamn i sina komponentnamn. Kommandona anropar metoden Dela upp i strängar. De tre kommandona använder olika syntax, men de är likvärdiga och utbytbara. Utdata är desamma för alla tre fallen.

"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

Det första kommandot använder den traditionella syntaxen, som innehåller ett skriptblock och den aktuella objektoperatorn $_. Den använder punktsyntaxen för att ange metoden och parenteserna för att omsluta avgränsningsargumentet.

Det andra kommandot använder parametern MemberName för att ange metoden Split och parametern ArgumentList för att identifiera punkten (.) som avgränsare för delad.

Det tredje kommandot använder aliaset foreach för cmdleten ForEach-Object och utelämnar namnen på parametrarna MemberName och ArgumentList , som är valfria.

I det här exemplet skickar vi två skriptblock positionligt. Alla skriptblock binder till parametern Process . De behandlas dock som om de hade skickats till parametrarna Begin och Process .

1..2 | ForEach-Object { 'begin' } { 'process' }

begin
process
process

I det här exemplet skickar vi fyra skriptblock positionligt. Alla skriptblock binder till parametern Process . De behandlas dock som om de hade skickats till parametrarna Begin, Process och End .

1..2 | ForEach-Object { 'begin' } { 'process A' }  { 'process B' }  { 'end' }

begin
process A
process B
process A
process B
end

Som du ser i föregående exempel mappas flera skriptblock som skickas med hjälp av processparametern till parametrarna Begin och End . För att undvika den här mappningen måste du ange explicita värden för parametrarna Begin och End .

1..2 | ForEach-Object -Begin $null -Process { 'one' }, { 'two' }, { 'three' } -End $null

one
two
three
one
two
three

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka valfritt objekt till den här cmdleten.

Den här cmdleten returnerar objekt som bestäms av indata.

Windows PowerShell innehåller följande alias för ForEach-Object:

• %
• foreach

Cmdleten ForEach-Object fungerar ungefär som foreach-instruktionen, förutom att du inte kan skicka indata till en foreach-instruktion. Mer information om -instruktionen finns i foreachabout_Foreach.

Från och med PowerShell 4.0 Where har ForEach metoder lagts till för användning med samlingar. Du kan läsa mer om dessa nya metoder här about_Arrays