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


about_Kimeneti_Stream-ek

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 Bevezetve: Cmdlet írása
1 Success adatfolyam PowerShell 2.0 Write-Output
2 Error adatfolyam PowerShell 2.0 Write-Error
3 Warning adatfolyam PowerShell 2.0 Write-Warning
4 Verbose adatfolyam PowerShell 2.0 Write-Verbose
5 Debug adatfolyam PowerShell 2.0 Write-Debug
6 Information adatfolyam PowerShell 5.0 Write-Information
N/a Progress adatfolyam PowerShell 2.0 Write-Progress

Jegyzet

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

Success adatfolyam

A Success stream a normál, sikeres eredmények alapértelmezett streamje. A Write-Output 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 adatfolyam

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

Warning adatfolyam

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 a $Error automatikus változóra lesznek írva. A Write-Warning parancsmaggal explicit módon írhat ebbe a streambe.

Verbose adatfolyam

A Verbose stream olyan üzenetekhez készült, amelyek segítenek a felhasználóknak a parancsok hibakeresésében, amikor azokat interaktívan vagy szkriptből futtatják. A Write-Verbose 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 -Verbose gyakori paramétert használja. További információkért lásd: about_CommonParameters.

Debug adatfolyam

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

Debug üzenetek szkript- és parancsmagfejlesztőknek szólnak, nem pedig végfelhasználóknak. Ezek a hibakeresési üzenetek a részletes hibaelhárításhoz szükséges belső részleteket tartalmazhatnak.

Information adatfolyam

A Information stream olyan üzeneteket biztosít, amelyek segítenek a felhasználónak 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. A Write-Information parancsmaggal explicit módon írhat ebbe a streambe.

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

Progress adatfolyam

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

Lásd még