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ší informationinformace najdete v tématu 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
Stream Error je výchozí datový proud pro error 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ší informationinformace najdete v tématu about_Automatic_Variables.
Warning proud
Stream Warning je určený pro error podmínky, které jsou méně závažné než chyby zapsané do datového Error proudu. 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 verbose výstup, který je užitečný pro pochopení interních fungování rutiny. Zprávy verbose jsou výstupem pouze při použití běžného parametru -Verbose . Další informationinformace najdete v tématu 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. Zprávy debug jsou výstupem pouze při použití běžného parametru -Debug . Další informationinformace 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 debug 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ý se používá k předávání information 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í progress v delších spuštěných příkazech a skriptech. Pomocí rutiny můžete explicitně zapisovat zprávy do tohoto datového Write-Progress proudu. Stream Progress nepodporuje přesměrování.
