about_Output_Streams
Vysvětluje dostupnost a účel výstupních datových proudů v PowerShellu.
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 naleznete viz about_Redirection.
PowerShell podporuje následující výstupní streamy.
| Proud # | Popis | Představeno v | Rutina pro zápis |
|---|---|---|---|
| 0 | Success proud | PowerShell 2.0 | Write-Output |
| 2 | Error proud | PowerShell 2.0 | Write-Error |
| 3 | Warning proud | PowerShell 2.0 | Write-Warning |
| 4 | Verbose proud | PowerShell 2.0 | Write-Verbose |
| 5 | Debug proud | PowerShell 2.0 | Write-Debug |
| 6 | Information proud | PowerShell 5.0 | Write-Information |
| Není k dispozici | Progress proud | PowerShell 2.0 | Write-Progress |
Poznámka
Stream Progress nepodporuje přesměrování.
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.
Proud Error je výchozí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í. Chyby zapsané do tohoto datového $Error proudu se také přidají do automatické proměnné. Další informace naleznete v tématu about_Automatic_Variables.
Datový proud Warning je určený pro chybové stavy, které jsou méně závažné než chyby zapsané do datového proudu Error. Zanormálních Upozornění se do automatické proměnné nezapisují $Error . Pomocí rutiny můžete explicitně zapisovat do tohoto datového Write-Warning 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 se zobrazí pouze v případě, že použijete společný parametr -Verbose. Další informace najdete v tématu about_CommonParameters.
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 se zobrazují pouze v případech, kdy používáte obecný parametr -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íží.
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.
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í.
Zpětná vazba k produktu PowerShell
PowerShell je open source projekt. Vyberte odkaz pro poskytnutí zpětné vazby: