about_Output_Streams
Krátký popis
Vysvětluje dostupnost a účel výstupních datových proudů v PowerShellu.
Dlouhý popis
PowerShell poskytuje více výstupních datových proudů. Streamy poskytují kanály pro různé typy zpráv. Do těchto datových proudů můžete zapisovat pomocí přidružené rutiny nebo přesměrování. Další informace najdete v tématu about_Redirection.
PowerShell podporuje následující výstupní streamy.
Proudu # | Popis | Představeno v | Rutina pro zápis |
---|---|---|---|
0 | Success Proudu | PowerShell 2.0 | Write-Output |
2 | Error Proudu | PowerShell 2.0 | Write-Error |
3 | Warning Proudu | PowerShell 2.0 | Write-Warning |
4 | Verbose Proudu | PowerShell 2.0 | Write-Verbose |
5 | Debug Proudu | PowerShell 2.0 | Write-Debug |
6 | Information Proudu | PowerShell 5.0 | Write-Information |
Není k dispozici | Progress Proudu | PowerShell 2.0 | Write-Progress |
Poznámka:
Stream Progress nepodporuje přesměrování.
Success Proudu
Stream Success je výchozím datovým proudem pro normální úspěšné výsledky.
Write-Output
Pomocí rutiny explicitně zapisujte objekty do tohoto datového proudu. Tento datový proud se používá k předávání objektů prostřednictvím kanálu PowerShellu. Stream Success je připojený ke streamu stdout pro nativní aplikace.
Error Proudu
Stream Error je výchozím datovým proudem pro chybové výsledky. Pomocí rutiny můžete explicitně zapisovat do tohoto datového Write-Error
proudu. Stream Error je připojený ke streamu stderr pro nativní aplikace. Za většiny podmínek můžou tyto chyby ukončit kanál spuštění. Errordo této datového proudu se také přidají do $Error
automatické proměnné. Další informace najdete v tématu about_Automatic_Variables.
Warning Proudu
Stream Warning je určený pro chybové stavy, které jsou méně závažné než chyby zapsané do datového Error proudu. Zanormálních Warningnejsou zapsány do $Error
automatické proměnné. Pomocí rutiny můžete explicitně zapisovat do tohoto datového Write-Warning
proudu.
Verbose Proudu
Stream Verbose je určený pro zprávy, které uživatelům pomáhají řešit potíže s příkazy při interaktivním spuštění nebo ze skriptu. Pomocí rutiny můžete explicitně zapisovat zprávy do tohoto datového Write-Verbose
proudu. Mnoho rutin poskytuje podrobný výstup, který je užitečný pro pochopení interních fungování rutiny. Podrobné zprávy jsou výstupem pouze v případech, kdy používáte -Verbose
společný parametr. Další informace najdete v tématu about_CommonParameters.
Debug Proudu
Stream Debug se používá pro zprávy, které pomáhají skriptům pochopit, proč jejich kód selhává. Pomocí rutiny můžete explicitně zapisovat do tohoto datového Write-Debug
proudu. Ladicí zprávy jsou výstupem pouze při použití společného parametru -Debug
. Další informace najdete v tématu about_CommonParameters.
Debug zprávy jsou určeny pro vývojáře skriptů a rutin více než pro koncové uživatele. Tyto ladicí zprávy můžou obsahovat interní podrobnosti potřebné pro hloubkové řešení potíží.
Information Proudu
Stream Information je určený k poskytování zpráv, které uživateli pomůžou pochopit, co skript dělá. Vývojáři ho můžou také používat jako další datový proud, který slouží k předávání informací přes PowerShell. Vývojář může označit streamová data a mít pro tento datový proud specifické zpracování. Pomocí rutiny můžete explicitně zapisovat do tohoto datového Write-Information
proudu.
Write-Host
také zapisuje do datového Information proudu. Rozdíl mezi rutinami spočívá v tom, že Write-Host
se také zapisuje do hostitelské konzoly, pokud stream přesměrujete Information . Write-Information
pouze zapisuje do datového Information proudu.
Progress Proudu
Stream Progress se používá pro zprávy, které komunikují o průběhu delších příkazů a skriptů. Pomocí rutiny můžete explicitně zapisovat zprávy do tohoto datového Write-Progress
proudu. Stream Progress nepodporuje přesměrování.