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


about_Output_Streams

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 hibaeredmények alapértelmezett streamje a Error stream. 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. Az ehhez a streamhez írt hibák az automatikus változóhoz $Error is hozzáadódnak. További információért tekintse meg az *about_Automatic_Variables* témakört a éscímkék alatt.

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. A figyelmeztetések nem az $Error automatikus változóra lesznek í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 az -Verbose alapértelmezett paramétert 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 -Debug gyakori paramétert 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álatos, amelyek hosszabb ideig futó parancsokban és szkriptekben közlik a haladá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