Sdílet prostřednictvím

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 části 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í.

Success proud

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 proud

Datový proud Error je výchozím datovým proudem pro výsledky chyb. 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é. Viz about_Automatic_Variablespro více informací.

Warning proud

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.

Verbose proud

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 generovány pouze tehdy, když použijete společný parametr -Verbose. Další informace najdete v about_CommonParameters.

Debug proud

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 tehdy, když používáte společný parametr -Debug. Další informace najdete v 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 proud

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 proud

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é

  • Last updated on