about_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 genom 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 lika med 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.
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 loopå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 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 inuti 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 eventuella decimalvärden från resultatet. Med 0 visas inga decimaler i formatspecificeraren.
I följande exempel parsar funktionen PowerShell-skript och skriptmoduler och returnerar platsen för de 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 inuti 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]) {
Write-Verbose "From pipeline"
$_
} else {
Write-Verbose "From parameter, $Path"
Get-Item -Path $Path
}
$parser = [System.Management.Automation.Language.Parser]
Write-Verbose "lets start the foreach loop on `$filesToProcess with $($filesToProcess.count) as count"
foreach ($item in $filesToProcess) {
Write-Verbose "$item"
if ($item.PSIsContainer -or
$item.Extension -notin @('.ps1', '.psm1')) {
continue
}
$tokens = $errors = $null
$parser::ParseFile($item.FullName, ([REF]$tokens),
([REF]$errors)) | Out-Null
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
}
}
}