Write-Progress

Write-Progress
    [-Activity] <String>
    [[-Status] <String>]
    [[-Id] <Int32>]
    [-PercentComplete <Int32>]
    [-SecondsRemaining <Int32>]
    [-CurrentOperation <String>]
    [-ParentId <Int32>]
    [-Completed]
    [-SourceId <Int32>]
    [<CommonParameters>]

Das Cmdlet Write-Progress zeigt eine Statusleiste in einem Windows PowerShell-Befehlsfenster an, das den Status eines ausgeführten Befehls oder Skripts darstellt. Sie können die Indikatoren auswählen, die die Leiste widerspiegelt, und den Text, der oberhalb und unterhalb der Statusleiste angezeigt wird.

for ($i = 1; $i -le 100; $i++ )
{
    Write-Progress -Activity "Search in Progress" -Status "$i% Complete:" -PercentComplete $i;
}

Dieser Befehl zeigt den Fortschritt einer For-Schleife an, die zwischen 1 und 100 zählt.

Das Cmdlet Write-Progress enthält eine Statusleistenüberschrift Activity, eine Statuszeile und die Variable $i (der Zähler in der For-Schleife), die die relative Vollständigkeit des Vorgangs angibt.

for($I = 1; $I -lt 101; $I++ )
{
    Write-Progress -Activity Updating -Status 'Progress->' -PercentComplete $I -CurrentOperation OuterLoop
    for($j = 1; $j -lt 101; $j++ )
    {
        Write-Progress -Id 1 -Activity Updating -Status 'Progress' -PercentComplete $j -CurrentOperation InnerLoop
    }
}

Updating
Progress ->
 [ooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo]
OuterLoop
Updating
Progress
 [oooooooooooooooooo                                                   ]
InnerLoop

In diesem Beispiel wird der Fortschritt von zwei geschachtelten For-Schleifen angezeigt, die jeweils durch eine Statusanzeige dargestellt werden.

Der Befehl Write-Progress für die zweite Statusleiste enthält den parameter ID, der ihn von der ersten Statusleiste unterscheidet.

Ohne den parameter ID werden die Statusanzeigen nebeneinander angeordnet, anstatt untereinander angezeigt zu werden.

# Use Get-EventLog to get the events in the System log and store them in the $Events variable.
$Events = Get-EventLog -LogName system
# Pipe the events to the ForEach-Object cmdlet.
$Events | ForEach-Object -Begin {
    # In the Begin block, use Clear-Host to clear the screen.
    Clear-Host
    # Set the $i counter variable to zero.
    $i = 0
    # Set the $out variable to a empty string.
    $out = ""
} -Process {
    # In the Process script block search the message property of each incoming object for "bios".
    if($_.message -like "*bios*")
    {
        # Append the matching message to the out variable.
        $out=$out + $_.Message
    }
    # Increment the $i counter variable which is used to create the progress bar.
    $i = $i+1
    # Use Write-Progress to output a progress bar.
    # The Activity and Status parameters create the first and second lines of the progress bar heading, respectively.
    Write-Progress -Activity "Searching Events" -Status "Progress:" -PercentComplete ($i/$Events.count*100)
} -End {
    # Display the matching messages using the out variable.
    $out
}

Mit diesem Befehl wird der Fortschritt eines Befehls angezeigt, um die Zeichenfolge "bios" im Systemereignisprotokoll zu finden.

Der PercentComplete Parameterwert wird berechnet, indem die Anzahl der Ereignisse dividiert wird, die $I durch die Gesamtanzahl der $Events.count abgerufenen Ereignisse dividiert und dann mit 100 multipliziert werden.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben können nicht an dieses Cmdlet weitergereicht werden.

Write-Progress generiert keine Ausgabe.

Wenn die Statusanzeige nicht angezeigt wird, überprüfen Sie den Wert der variablen $ProgressPreference. Wenn der Wert auf SilentlyContinue festgelegt ist, wird die Statusanzeige nicht angezeigt. Weitere Informationen zu Windows PowerShell-Einstellungen finden Sie unter about_Preference_Variables.

Die Parameter des Cmdlets entsprechen den Eigenschaften der System.Management.Automation.ProgressRecord Klasse. Weitere Informationen finden Sie unter ProgressRecord Class in der MSDN Library.