ForEach-Object

  • Referentie
Module:
Microsoft.PowerShell.Core

Voert een bewerking uit op elk item in een verzameling invoerobjecten.

Syntax

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

De ForEach-Object cmdlet voert een bewerking uit op elk item in een verzameling invoerobjecten. De invoerobjecten kunnen worden doorgesluisd naar de cmdlet of worden opgegeven met behulp van de parameter InputObject .

Vanaf Windows PowerShell 3.0 zijn er twee verschillende manieren om een ForEach-Object opdracht te maken.

  • Scriptblok. U kunt een scriptblok gebruiken om de bewerking op te geven. Gebruik in het scriptblok de $_ variabele om het huidige object weer te geven. Het scriptblok is de waarde van de procesparameter . Het scriptblok kan elk PowerShell-script bevatten.

    Met de volgende opdracht wordt bijvoorbeeld de waarde opgehaald van de eigenschap ProcessName van elk proces op de computer.

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

    ForEach-Object ondersteunt de begin, processen end blokken zoals beschreven in about_functions.

    Notitie

    De scriptblokken worden uitgevoerd in het bereik van de aanroeper. De blokken hebben daarom toegang tot variabelen in dat bereik en kunnen nieuwe variabelen maken die in dat bereik blijven bestaan nadat de cmdlet is voltooid.

  • Bewerkingsinstructie. U kunt ook een bewerkingsinstructie schrijven, wat veel meer lijkt op natuurlijke taal. U kunt de bewerkingsinstructie gebruiken om een eigenschapswaarde op te geven of een methode aan te roepen. Bewerkingsinstructies zijn geïntroduceerd in Windows PowerShell 3.0.

    Met de volgende opdracht wordt bijvoorbeeld ook de waarde opgehaald van de eigenschap ProcessName van elk proces op de computer.

    Get-Process | ForEach-Object ProcessName

Voorbeelden

Voorbeeld 1: Gehele getallen in een matrix delen

In dit voorbeeld wordt een matrix van drie gehele getallen gebruikt en worden ze allemaal gedeeld door 1024.

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

29.296875
55.466796875
12.140625

Voorbeeld 2: de lengte van alle bestanden in een map ophalen

In dit voorbeeld worden de bestanden en mappen in de Installatiemap $PSHOMEvan PowerShell verwerkt.

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

Als het object geen map is, krijgt het scriptblok de naam van het bestand, deelt u de waarde van de eigenschap Length door 1024 en voegt u een spatie (" ") toe om deze te scheiden van de volgende vermelding. De cmdlet gebruikt de eigenschap PSISContainer om te bepalen of een object een map is.

Voorbeeld 3: Werken op de meest recente systeem gebeurtenissen

In dit voorbeeld worden de 1000 meest recente gebeurtenissen uit het gebeurtenislogboek van het systeem naar een tekstbestand geschreven. De huidige tijd wordt weergegeven voor en na het verwerken van de gebeurtenissen.

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 haalt de 1000 meest recente gebeurtenissen op uit het gebeurtenislogboek van het systeem en pijpt deze naar de ForEach-Object cmdlet. De parameter Begin geeft de huidige datum en tijd weer. Vervolgens gebruikt de parameter Proces de Out-File cmdlet om een tekstbestand te maken met de naam events.txt en slaat de berichteigenschap van elk van de gebeurtenissen in dat bestand op. Ten slotte wordt de parameter Einde gebruikt om de datum en tijd weer te geven nadat alle verwerking is voltooid.

Voorbeeld 4: De waarde van een registersleutel wijzigen

In dit voorbeeld wordt de waarde van de registervermelding RemotePath gewijzigd in alle subsleutels onder de HKCU:\Network sleutel in hoofdletters.

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

U kunt deze indeling gebruiken om het formulier of de inhoud van een registervermeldingswaarde te wijzigen.

Elke subsleutel in de netwerksleutel vertegenwoordigt een toegewezen netwerkstation dat opnieuw verbinding maakt bij aanmelding. De RemotePath-vermelding bevat het UNC-pad van het verbonden station. Als u het E: station bijvoorbeeld toe wijst, wordt er een E-subsleutel gemaakt HKCU:\Network waarin de registerwaarde RemotePath is ingesteld op \\Server\Share\\Server\Share.

De opdracht gebruikt de Get-ItemProperty cmdlet om alle subsleutels van de netwerksleutel en de Set-ItemProperty cmdlet op te halen om de waarde van de RemotePath-registervermelding in elke sleutel te wijzigen. In de Set-ItemProperty opdracht is het pad de waarde van de PSPath-eigenschap van de registersleutel. Dit is een eigenschap van het Microsoft .NET Framework-object dat de registersleutel vertegenwoordigt, niet een registervermelding. De opdracht maakt gebruik van de methode ToUpper() van de RemotePath-waarde . Dit is een tekenreeks REG_SZ.

Omdat Set-ItemProperty de eigenschap van elke sleutel wordt gewijzigd, is de ForEach-Object cmdlet vereist voor toegang tot de eigenschap.

Voorbeeld 5: de automatische variabele $null gebruiken

In dit voorbeeld ziet u het effect van het doorsluisen van de $null automatische variabele naar de ForEach-Object cmdlet.

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

Hello
Hello
Hello
Hello

Omdat PowerShell als een expliciete tijdelijke aanduiding wordt behandeld $null , genereert de ForEach-Object cmdlet een waarde voor $null net als voor andere objecten die eraan worden doorgesluisd.

Voorbeeld 6: Eigenschapswaarden ophalen

In dit voorbeeld wordt de waarde opgehaald van de eigenschap Path van alle geïnstalleerde PowerShell-modules met behulp van de parameter MemberName van de ForEach-Object cmdlet.

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

De tweede opdracht is gelijk aan de eerste. Hierbij wordt de Foreach alias van de ForEach-Object cmdlet gebruikt en wordt de naam van de parameter MemberName weggelaten. Dit is optioneel.

De ForEach-Object cmdlet is handig voor het ophalen van eigenschapswaarden, omdat deze de waarde krijgt zonder het type te wijzigen, in tegenstelling tot de indelings-cmdlets of de Select-Object cmdlet, die het eigenschapswaardetype wijzigen.

Voorbeeld 7: Modulenamen splitsen in onderdeelnamen

In dit voorbeeld ziet u drie manieren om twee door puntjes gescheiden modulenamen te splitsen in hun onderdeelnamen. Met de opdrachten wordt de splitsmethode van tekenreeksen aangeroepen. De drie opdrachten gebruiken verschillende syntaxis, maar ze zijn gelijkwaardig en uitwisselbaar. De uitvoer is hetzelfde voor alle drie de gevallen.

"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

De eerste opdracht maakt gebruik van de traditionele syntaxis, die een scriptblok en de huidige objectoperator $_bevat. Hierbij wordt de syntaxis van de punt gebruikt om de methode en haakjes op te geven om het scheidingstekenargument in te sluiten.

De tweede opdracht gebruikt de parameter MemberName om de splitsmethode en de parameter ArgumentList op te geven om de punt (.) te identificeren als scheidingsteken voor splitsen.

De derde opdracht maakt gebruik van de Foreach-alias van de ForEach-Object cmdlet en laat de namen van de parameters MemberName en ArgumentList weg, die optioneel zijn.

Voorbeeld 8: ForEach-Object gebruiken met twee scriptblokken

In dit voorbeeld geven we twee scriptblokken positioneel door. Alle scriptblokken binden aan de procesparameter . Ze worden echter behandeld alsof ze zijn doorgegeven aan de parameters Begin en Proces .

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

begin
process
process

Voorbeeld 9: ForEach-Object gebruiken met meer dan twee scriptblokken

In dit voorbeeld geven we vier scriptblokken positioneel door. Alle scriptblokken binden aan de procesparameter . Ze worden echter behandeld alsof ze zijn doorgegeven aan de parameters Begin, Proces en Eind .

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

begin
process A
process B
process A
process B
end

Notitie

Het eerste scriptblok wordt altijd toegewezen aan het begin blok, het laatste blok wordt toegewezen aan het end blok en de twee middelste blokken worden toegewezen aan het process blok.

Voorbeeld 10: Meerdere scriptblokken uitvoeren voor elk pijplijnitem

Zoals in het vorige voorbeeld wordt weergegeven, worden meerdere scriptblokken doorgegeven met behulp van de procesparameter toegewezen aan de begin- en eindparameters. Om deze toewijzing te voorkomen, moet u expliciete waarden opgeven voor de begin- en eindparameters.

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

one
two
three
one
two
three

Parameters

-ArgumentList

Hiermee geeft u een matrix van argumenten voor een methodeaanroep. Zie about_Splatting voor meer informatie over het gedrag van ArgumentList.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:Object[]
Aliases:Args
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Begin

Hiermee geeft u een scriptblok op dat wordt uitgevoerd voordat deze cmdlet invoerobjecten verwerkt. Dit scriptblok wordt slechts eenmaal uitgevoerd voor de hele pijplijn. Zie about_Functions voor meer informatie over het begin blok.

Type:ScriptBlock
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-End

Hiermee geeft u een scriptblok op dat wordt uitgevoerd nadat deze cmdlet alle invoerobjecten verwerkt. Dit scriptblok wordt slechts eenmaal uitgevoerd voor de hele pijplijn. Zie about_Functions voor meer informatie over het end blok.

Type:ScriptBlock
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Hiermee geeft u de invoerobjecten. ForEach-Object voert het scriptblok of de bewerkingsinstructie uit op elk invoerobject. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald.

Wanneer u de parameter InputObject gebruikt met ForEach-Object, in plaats van de resultaten van de opdracht ForEach-Objectpiping, wordt de Waarde InputObject behandeld als één object. Dit geldt zelfs als de waarde een verzameling is die het resultaat is van een opdracht, zoals -InputObject (Get-Process). Omdat InputObject geen afzonderlijke eigenschappen kan retourneren uit een matrix of verzameling objecten, raden we u ForEach-Object aan om bewerkingen uit te voeren op een verzameling objecten voor die objecten met specifieke waarden in gedefinieerde eigenschappen, die u in de pijplijn gebruikt ForEach-Object , zoals wordt weergegeven in de voorbeelden in dit onderwerp.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MemberName

Hiermee geeft u de naam van de lideigenschap op om op te halen of de lidmethode die moet worden aangeroepen. De leden moeten exemplaarleden zijn, niet statische leden.

Jokertekens zijn toegestaan, maar werken alleen als de resulterende tekenreeks wordt omgezet in een unieke waarde. Als u bijvoorbeeld uitvoert Get-Process | ForEach -MemberName *Name, komt het jokertekenpatroon overeen met meer dan één lid waardoor de opdracht mislukt.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Process

Hiermee geeft u de bewerking die wordt uitgevoerd op elk invoerobject. Dit scriptblok wordt uitgevoerd voor elk object in de pijplijn. Zie about_Functions voor meer informatie over het process blok.

Wanneer u meerdere scriptblokken opgeeft aan de procesparameter , wordt het eerste scriptblok altijd toegewezen aan het begin blok. Als er slechts twee scriptblokken zijn, wordt het tweede blok toegewezen aan het process blok. Als er drie of meer scriptblokken zijn, wordt het eerste scriptblok altijd toegewezen aan het begin blok, wordt het laatste blok toegewezen aan het end blok en worden de middelste blokken toegewezen aan het process blok.

Type:ScriptBlock[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RemainingScripts

Hiermee geeft u alle scriptblokken op die niet worden gebruikt door de parameter Proces .

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:ScriptBlock[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSObject

U kunt elk object doorsluisen naar deze cmdlet.

Uitvoerwaarden

PSObject

Met deze cmdlet worden objecten geretourneerd die worden bepaald door de invoer.

Notities

Windows PowerShell bevat de volgende aliassen voor ForEach-Object:

  • %
  • foreach

De ForEach-Object cmdlet werkt net als de Foreach-instructie , behalve dat u geen invoer kunt doorsluisen naar een Foreach-instructie . Zie about_Foreach voor meer informatie over de Foreach-instructie.

Vanaf PowerShell 4.0 WhereForEach zijn methoden toegevoegd voor gebruik met verzamelingen. Meer informatie over deze nieuwe methoden vindt u hier about_arrays