about_Output_Streams

  • Článek

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í.

Viz také