Dela via


Om ForEach

Kort beskrivning

Beskriver ett språkkommando som du kan använda för att bläddra igenom alla objekt i en samling objekt.

Lång beskrivning

-instruktionen Foreach (kallas även en Foreach loop) är en språkkonstruktion för att stega igenom (iterera) en serie värden i en samling objekt.

Den enklaste och mest typiska typen av samling att bläddra i är en matris. I en Foreach loop är det vanligt att köra ett eller flera kommandon mot varje objekt i en matris.

Syntax

Följande visar syntaxen ForEach :

foreach ($<item> in $<collection>){<statement list>}

Den del av -instruktionen ForEach som omges av parenteser representerar en variabel och en samling som ska iterera. PowerShell skapar variabeln $<item> automatiskt när loopen Foreach körs. Före varje iteration via loopen anges variabeln till ett värde i samlingen. Blocket som följer en Foreach instruktion {<statement list>} innehåller en uppsättning kommandon som ska köras mot varje objekt i en samling.

Exempel

Loopen Foreach i följande exempel visar till exempel värdena i matrisen $letterArray .

$letterArray = "a","b","c","d"
foreach ($letter in $letterArray)
{
  Write-Host $letter
}

I det här exemplet skapas och initieras matrisen $letterArray med strängvärdena "a", "b", "c"och "d". Första gången -instruktionen Foreach körs anger den variabeln $letter som det första objektet i $letterArray ("a"). Sedan använder den cmdleten Write-Host för att visa bokstaven a. Nästa gång genom loopen $letter är inställd "b"på , och så vidare. När loopen Foreach visar bokstaven d avslutar PowerShell loopen.

Hela Foreach instruktionen måste visas på en enda rad för att köra den som ett kommando i PowerShell-kommandotolken. Hela Foreach instruktionen behöver inte visas på en enda rad om du placerar kommandot i en .ps1 skriptfil i stället.

Foreach -instruktioner kan också användas tillsammans med cmdletar som returnerar en samling objekt. I följande exempel stegar Foreach-instruktionen igenom listan över objekt som returneras av cmdleten Get-ChildItem .

foreach ($file in Get-ChildItem)
{
  Write-Host $file
}

Du kan förfina exemplet med hjälp av en If -instruktion för att begränsa de resultat som returneras. I följande exempel utför -instruktionen Foreach samma loopningsåtgärd som i föregående exempel, men lägger till en If instruktion för att begränsa resultatet till filer som är större än 100 kilobyte (KB):

foreach ($file in Get-ChildItem)
{
  if ($file.length -gt 100KB)
  {
    Write-Host $file
  }
}

I det här exemplet använder loopen Foreach en egenskap för variabeln $file för att utföra en jämförelseåtgärd ($file.length -gt 100KB). Variabeln $file innehåller alla egenskaper i objektet som returneras av cmdleten Get-ChildItem . Därför kan du returnera mer än bara ett filnamn. I nästa exempel returnerar PowerShell längden och den senaste åtkomsttiden i instruktionslistan:

foreach ($file in Get-ChildItem)
{
  if ($file.length -gt 100KB)
  {
    Write-Host $file
    Write-Host $file.length
    Write-Host $file.lastaccesstime
  }
}

I det här exemplet är du inte begränsad till att köra ett enda kommando i en instruktionslista.

Du kan också använda en variabel utanför en Foreach loop och öka variabeln i loopen. I följande exempel räknas filer över 100 kB i storlek:

$i = 0
foreach ($file in Get-ChildItem) {
  if ($file.length -gt 100KB) {
    Write-Host $file "file size:" ($file.length / 1024).ToString("F0") KB
    $i = $i + 1
  }
}

if ($i -ne 0) {
  Write-Host
  Write-Host $i " file(s) over 100 KB in the current directory."
}
else {
  Write-Host "No files greater than 100 KB in the current directory."
}

I föregående exempel anges variabeln $i till 0 utanför loopen och variabeln ökas inuti loopen för varje fil som hittas som är större än 100 kB. När loopen avslutas utvärderar en If -instruktion värdet $i för för att visa ett antal av alla filer över 100 kB. Eller så visas ett meddelande om att inga filer över 100 kB hittades.

I föregående exempel visas också hur du formaterar fillängdsresultatet:

($file.length / 1024).ToString("F0")

Värdet divideras med 1 024 för att visa resultatet i kilobyte i stället för byte, och det resulterande värdet formateras sedan med hjälp av fastpunktsformatsspecificeraren för att ta bort decimalvärden från resultatet. 0 gör att formatspecificeraren inte visar några decimaler.

I följande exempel parsar den definierade funktionen PowerShell-skript och skriptmoduler och returnerar platsen för funktioner som finns i. Exemplet visar hur du använder MoveNext metoden (som fungerar på samma sätt skip X som i en For loop) och Current egenskapen för variabeln $foreach i ett foreach-skriptblock. Exempelfunktionen kan hitta funktioner i ett skript även om det finns ovanligt eller inkonsekvent fördelade funktionsdefinitioner som sträcker sig över flera rader.

Mer information finns i Använda uppräknare.

function Get-FunctionPosition {
  [CmdletBinding()]
  [OutputType('FunctionPosition')]
  param(
    [Parameter(Position = 0, Mandatory,
      ValueFromPipeline, ValueFromPipelineByPropertyName)]
    [ValidateNotNullOrEmpty()]
    [Alias('PSPath')]
    [System.String[]]
    $Path
  )

  process {
    try {
      $filesToProcess = if ($_ -is [System.IO.FileSystemInfo]) {
        $_
      } else {
        $filesToProcess = Get-Item -Path $Path
      }
      $parser = [System.Management.Automation.Language.Parser]
      foreach ($item in $filesToProcess) {
        if ($item.PSIsContainer -or
            $item.Extension -notin @('.ps1', '.psm1')) {
          continue
        }
        $tokens = $errors = $null
        $ast = $parser::ParseFile($item.FullName, ([REF]$tokens),
          ([REF]$errors))
        if ($errors) {
          $msg = "File '{0}' has {1} parser errors." -f $item.FullName,
            $errors.Count
          Write-Warning $msg
        }
        :tokenLoop foreach ($token in $tokens) {
          if ($token.Kind -ne 'Function') {
            continue
          }
          $position = $token.Extent.StartLineNumber
          do {
            if (-not $foreach.MoveNext()) {
              break tokenLoop
            }
            $token = $foreach.Current
          } until ($token.Kind -in @('Generic', 'Identifier'))
          $functionPosition = [pscustomobject]@{
            Name       = $token.Text
            LineNumber = $position
            Path       = $item.FullName
          }
          Add-Member -InputObject $functionPosition `
            -TypeName FunctionPosition -PassThru
        }
      }
    }
    catch {
      throw
    }
  }
}

SE ÄVEN

about_Automatic_Variables

about_If

ForEach-Object