about_Output_Streams

  • Cikk

Rövid leírás

A kimeneti streamek rendelkezésre állását és célját ismerteti a PowerShellben.

Hosszú leírás

A PowerShell több kimeneti streamet is biztosít. A streamek különböző típusú üzenetekhez biztosítanak csatornákat. Ezekbe a streamekbe a társított parancsmaggal vagy átirányítással írhat. További információ: about_Redirection.

A PowerShell a következő kimeneti streameket támogatja.

Patak # Leírás Bevezetés a következőbe: Írási parancsmag
0 Success Patak PowerShell 2.0 Write-Output
2 Error Patak PowerShell 2.0 Write-Error
3 Warning Patak PowerShell 2.0 Write-Warning
4 Verbose Patak PowerShell 2.0 Write-Verbose
5 Debug Patak PowerShell 2.0 Write-Debug
6 Information Patak PowerShell 5.0 Write-Information
n.a. Progress Patak PowerShell 2.0 Write-Progress

Feljegyzés

A Progress stream nem támogatja az átirányítást.

Success Patak

A Success stream a normál, sikeres eredmények alapértelmezett streamje. Write-Output A parancsmaggal explicit módon írhat objektumokat ebbe a streambe. Ez a stream objektumok PowerShell-folyamaton keresztüli továbbítására szolgál. A Success stream natív alkalmazásokhoz csatlakozik a stdout streamhez.

Error Patak

A Error stream a hibaeredmények alapértelmezett streamje. Write-Error A parancsmaggal explicit módon írhat erre a streamre. A Error stream natív alkalmazásokhoz csatlakozik az stderr streamhez. A legtöbb esetben ezek a hibák megszakíthatják a végrehajtási folyamatot. Erroraz ehhez a streamhez írt s is hozzá lesz adva az $Error automatikus változóhoz. További információ: about_Automatic_Variables.

Warning Patak

A Warning stream olyan hibaállapotokra szolgál, amelyek kevésbé súlyosak, mint a Error streambe írt hibák. Normál körülmények között ezek a figyelmeztetések nem zárják le a végrehajtást. Warningnem az automatikus változóba $Error van írva. Write-Warning A parancsmaggal explicit módon írhat erre a streamre.

Verbose Patak

A Verbose stream olyan üzenetekhez készült, amelyek segítenek a felhasználóknak a parancsok interaktív vagy szkriptből történő futtatásában. Write-Verbose A parancsmaggal explicit módon írhat üzeneteket ebbe a streambe. Számos parancsmag részletes kimenetet biztosít, amely hasznos a parancsmag belső működésének megértéséhez. A részletes üzenetek csak akkor jelennek meg, ha a gyakori paramétert -Verbose használja. További információ: about_CommonParameters.

Debug Patak

A Debug stream olyan üzenetekhez használható, amelyek segítenek a szkripteknek megérteni, hogy miért hiúsul meg a kódjuk. Write-Debug A parancsmaggal explicit módon írhat erre a streamre. A hibakeresési üzenetek csak akkor jelennek meg, ha a gyakori paramétert -Debug használja. További információ: about_CommonParameters.

Debug az üzeneteket a végfelhasználóknál több szkript- és parancsmagfejlesztőnek szánták. Ezek a hibakeresési üzenetek a részletes hibaelhárításhoz szükséges belső részleteket tartalmazhatnak.

Information Patak

A Information stream olyan üzeneteket biztosít, amelyek segítenek a felhasználóknak megérteni a szkriptek által végzett munkát. A fejlesztők azt is használhatják, hogy további streamként használják az információk PowerShell-lel való továbbításához. A fejlesztő címkézheti a streamadatokat, és speciális kezeléssel rendelkezhet a streamhez. Write-Information A parancsmaggal explicit módon írhat erre a streamre.

Write-Host a streambe Information is ír. A parancsmagok közötti különbség az, hogy Write-Host a gazdakonzolra is ír, hacsak nem irányítja át a streamet Information . Write-Information csak a Information streambe ír.

Progress Patak

A Progress stream olyan üzenetekhez használható, amelyek hosszabb ideig futó parancsokban és szkriptekben közlik az előrehaladást. Write-Progress A parancsmaggal explicit módon írhat üzeneteket ebbe a streambe. A Progress stream nem támogatja az átirányítást.

Lásd még