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.

Proud #	Popis	Představeno v	Rutina pro zápis
1	stream Success	PowerShell 2.0	Write-Output
2	stream Error	PowerShell 2.0	Write-Error
3	stream Warning	PowerShell 2.0	Write-Warning
4	stream Verbose	PowerShell 2.0	Write-Verbose
5	stream Debug	PowerShell 2.0	Write-Debug
6	stream Information	PowerShell 5.0	Write-Information
není k dispozici	stream Progress	PowerShell 2.0	Write-Progress

Poznámka

Stream Progress nepodporuje přesměrování.

stream Success

Datový proud Success je výchozím datovým proudem pro normální úspěšné výsledky. Pomocí rutiny Write-Output 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.

stream Error

Datový proud Error je výchozím datovým proudem pro výsledky chyb. Pomocí rutiny Write-Error explicitně zapisujte do tohoto datového 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 proudu se také přidají do $Error automatické proměnné. Další informace naleznete v tématu about_Automatic_Variables.

stream Warning

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í nejsou zapsána do $Error automatické proměnné. Pomocí rutiny Write-Warning explicitně zapisujte do tohoto datového proudu.

stream Verbose

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 Write-Verbose můžete explicitně psát zprávy do tohoto datového 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žijete -Verbose společný parametr. Další informace najdete v tématu about_CommonParameters.

stream Debug

Stream Debug se používá pro zprávy, které skripterům pomáhají pochopit, proč jejich kód selhává. Pomocí rutiny Write-Debug explicitně zapisujte do tohoto datového proudu. Ladicí zprávy jsou výstupem pouze v případech, kdy používáte -Debug společný parametr. Další informace najdete v tématu about_CommonParameters.

Debug zprávy jsou určené 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

Datový proud 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 Write-Information explicitně zapisujte do tohoto datového proudu.

Write-Host také zapisuje do datového proudu Information. Rozdíl mezi rutinami spočívá v tom, že Write-Host také zapisuje do konzoly hostitele, pokud Information stream přesměrujete. Write-Information pouze zápisy do datového proudu Information.

stream Progress

Stream Progress se používá pro zprávy, které komunikují o průběhu delších příkazů a skriptů. Pomocí rutiny Write-Progress můžete explicitně psát zprávy do tohoto datového proudu. Stream Progress nepodporuje přesměrování.

Viz také

• about_CommonParameters
• about_Redirection
• Write-Debug
• Write-Error
• Write-Host
• Write-Information
• Write-Output
• Write-Progress
• Write-Verbose
• Write-Warning