Megosztás a következőn keresztül:

Write-Progress

Modul:
Microsoft.PowerShell.Utility Module

Egy folyamatjelző sávot jelenít meg egy PowerShell-parancsablakban.

Syntax

Default (Alapértelmezett) 

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

Description

A Write-Progress parancsmag egy folyamatjelző sávot jelenít meg egy PowerShell-parancsablakban, amely egy futó parancs vagy szkript állapotát jeleníti meg. Kiválaszthatja azokat a jelzőket, amelyeket a sáv tükröz, valamint az előrehaladási sáv fölött és alatt megjelenő szöveget.

A PowerShell 7.2 hozzáadta az $PSStyle automatikus változót, amellyel szabályozható, hogy a PowerShell hogyan jelenít meg bizonyos információkat ANSI-feloldósorozatokkal. A $PSStyle.Progress tag lehetővé teszi a folyamatjelző sáv renderelését.

  • $PSStyle.Progress.Style – A renderelési stílust megállító ANSI-sztring.
  • $PSStyle.Progress.MaxWidth – Beállítja a nézet maximális szélességét. Alapértelmezett érték: 120. A minimális érték 18.
  • $PSStyle.Progress.View – Értékeket, Minimal és Classictartalmazó szám. Classic a meglévő, módosítások nélküli renderelés. Minimal egyetlen sor minimális renderelése. A Minimal az alapértelmezett.

A $PSStyletovábbi információ: about_ANSI_Terminals.md.

Megjegyzés:

Ha a gazdagép nem támogatja a Virtuális terminált, $PSStyle.Progress.View automatikusan Classic-re állítódik.

Példák

1. példa: Egy "for" ciklus előrehaladásának megjelenítése

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

Ez a parancs egy 1 és 100 közötti for ciklus előrehaladását jeleníti meg.

A Write-Progress parancsmag tartalmaz egy állapotsorfejlécet Activity, egy állapotsort, valamint a $i változót (a for ciklus számlálóját), amely a tevékenység relatív teljességét jelzi.

2. példa: Beágyazott "for" hurkok előrehaladásának megjelenítése

$PSStyle.Progress.View = 'Classic'

for($I = 0; $I -lt 10; $I++ ) {
    $OuterLoopProgressParameters = @{
        Activity         = 'Updating'
        Status           = 'Progress->'
        PercentComplete  = $I * 10
        CurrentOperation = 'OuterLoop'
    }
    Write-Progress @OuterLoopProgressParameters
    for($j = 1; $j -lt 101; $j++ ) {
        $InnerLoopProgressParameters = @{
            ID               = 1
            Activity         = 'Updating'
            Status           = 'Inner Progress'
            PercentComplete  = $j
            CurrentOperation = 'InnerLoop'
        }
        Write-Progress @InnerLoopProgressParameters
        Start-Sleep -Milliseconds 25
    }
}

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

Ez a példa a folyamatnézetet Classic értékre állítja, majd megjeleníti két beágyazott for ciklus előrehaladását, amelyeket egy folyamatjelző sáv jelöl.

A második folyamatjelző sáv Write-Progress parancsa tartalmazza az Azonosító paramétert, amely megkülönbözteti az első folyamatjelző sávtól.

A azonosító paraméter nélkül a folyamatjelző sávok egymásra lesznek kapcsolva ahelyett, hogy az egyik a másik alatt jelenne meg.

Megjegyzés:

Ez a példa a folyamatnézetet Classicértékre állítja, amely az egyes folyamatsávok CurrentOperation értékeit jeleníti meg. Ha a folyamatnézet Minimalértékre van állítva, a CurrentOperation értékek nem jelennek meg.

3. példa: A folyamat megjelenítése sztring keresése közben

# Use Get-WinEvent to get the events in the System log and store them in the $Events variable.
$Events = Get-WinEvent -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 an 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
    # Determine the completion percentage
    $Completed = ($i/$Events.Count) * 100
    # 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 $Completed
} -End {
    # Display the matching messages using the out variable.
    $out
}

Ez a parancs megjeleníti a parancs előrehaladását, hogy megtalálja a "bios" sztringet a Rendszer eseménynaplójában.

A PercentComplete paraméter értékét úgy számítja ki, hogy elosztja a $i feldolgozott események számát a $Events.Count lekért események teljes számával, majd megszorozza az eredményt 100-zal.

4. példa: A beágyazott folyamat egyes szintjeinek előrehaladásának megjelenítése

$PSStyle.Progress.View = 'Classic'

foreach ( $i in 1..10 ) {
  Write-Progress -Id 0 "Step $i"
  foreach ( $j in 1..10 ) {
    Write-Progress -Id 1 -ParentId 0 "Step $i - Substep $j"
    foreach ( $k in 1..10 ) {
      Write-Progress -Id 2  -ParentId 1 "Step $i - Substep $j - iteration $k"
      Start-Sleep -Milliseconds 150
    }
  }
}

Step 1
     Processing
    Step 1 - Substep 2
         Processing
        Step 1 - Substep 2 - Iteration 3
             Processing

Ebben a példában a ParentId paraméterrel behúzott kimenettel jelenítheti meg a szülő-gyermek kapcsolatokat az egyes lépések előrehaladásában.

Paraméterek

-Activity

Az állapotsor feletti címsor első szövegsorát adja meg. Ez a szöveg azt a tevékenységet írja le, amelynek előrehaladását jelenteni kell.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:0
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Completed

Azt jelzi, hogy a folyamatjelző sáv látható-e. Ha ez a paraméter nincs megadva, Write-Progress megjeleníti a folyamat előrehaladási adatait.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-CurrentOperation

A folyamatjelző sáv alatti szövegsort adja meg a Classic folyamatnézetében. Ez a szöveg a jelenleg futó műveletet ismerteti. Ennek a paraméternek nincs hatása, ha a folyamatnézet Minimalvan beállítva.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Id

Egy azonosítót ad meg, amely megkülönbözteti az egyes folyamatjelző sávokat a többitől. Ezt a paramétert akkor használja, ha egyetlen parancsban több folyamatjelző sávot hoz létre. Ha a folyamatjelző sávok nem rendelkeznek különböző azonosítókkal, ahelyett, hogy sorozatban jelennének meg. A negatív értékek nem engedélyezettek.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:2
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-ParentId

Az aktuális tevékenység szülőtevékenységét adja meg. Használja a -1 értéket, ha az aktuális tevékenység nem rendelkezik szülőtevékenységsel.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-PercentComplete

A befejezett tevékenység százalékos arányát adja meg. Használja a -1 értéket, ha a százalékos készültség ismeretlen vagy nem alkalmazható.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-SecondsRemaining

A tevékenység befejezéséig hátralévő másodpercek tervezett számát adja meg. Használja a -1 értéket, ha a hátralévő másodpercek száma ismeretlen vagy nem alkalmazható.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-SourceId

Megadja a rekord forrását. Ezt használhatja azonosító helyett, de más paraméterekkel, például ParentIdnem használható.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Status

Az állapotsor feletti címsor második szövegsorát adja meg. Ez a szöveg a tevékenység aktuális állapotát ismerteti.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:1
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

Ha az állapotsor nem jelenik meg, ellenőrizze a $ProgressPreference változó értékét. Ha az érték SilentlyContinueértékre van állítva, a folyamatjelző sáv nem jelenik meg. A PowerShell-beállításokról további információt a about_Preference_Variablescímű témakörben talál.

A parancsmag paraméterei megfelelnek a System.Management.Automation.ProgressRecord osztály tulajdonságainak. További információ: ProgressRecord class.