about_Output_Streams
Krótki opis
Objaśnia dostępność i przeznaczenie strumieni wyjściowych w programie PowerShell.
Długi opis
Program PowerShell udostępnia wiele strumieni wyjściowych. Strumienie udostępniają kanały dla różnych typów komunikatów. Możesz zapisywać w tych strumieniach przy użyciu skojarzonego polecenia cmdlet lub przekierowania. Aby uzyskać więcej informacji, zobacz about_Redirection.
Program PowerShell obsługuje następujące strumienie wyjściowe.
Strumienia # | opis | Wprowadzone w | Write Cmdlet |
---|---|---|---|
1 | Success Strumienia | PowerShell 2.0 | Write-Output |
2 | Error Strumienia | PowerShell 2.0 | Write-Error |
3 | Warning Strumienia | PowerShell 2.0 | Write-Warning |
100 | Verbose Strumienia | PowerShell 2.0 | Write-Verbose |
5 | Debug Strumienia | PowerShell 2.0 | Write-Debug |
6 | Information Strumienia | PowerShell 5.0 | Write-Information |
nie dotyczy | Progress Strumienia | PowerShell 2.0 | Write-Progress |
Uwaga
Strumień Progress nie obsługuje przekierowywania.
Success Strumienia
Strumień Success jest domyślnym strumieniem dla normalnych, pomyślnych wyników.
Write-Output
Użyj polecenia cmdlet , aby jawnie zapisywać obiekty w tym strumieniu. Ten strumień jest używany do przekazywania obiektów za pośrednictwem potoku programu PowerShell. Strumień Success jest połączony ze strumieniem stdout dla aplikacji natywnych.
Error Strumienia
Strumień Error jest domyślnym strumieniem wyników błędów. Write-Error
Użyj polecenia cmdlet , aby jawnie zapisać w tym strumieniu. Strumień Error jest połączony ze strumieniem stderr dla aplikacji natywnych. W większości warunków te błędy mogą zakończyć potok wykonywania. Errorzapis do tego strumienia jest również dodawany do zmiennej automatycznej $Error
. Aby uzyskać więcej informacji, zobacz about_Automatic_Variables.
Warning Strumienia
Strumień Warning jest przeznaczony dla warunków błędów, które są mniej poważne niż błędy zapisywane w strumieniu Error . W normalnych warunkach te ostrzeżenia nie kończą wykonywania. Warnings nie są zapisywane w zmiennej automatycznej $Error
. Write-Warning
Użyj polecenia cmdlet , aby jawnie zapisać w tym strumieniu.
Verbose Strumienia
Strumień Verbose jest przeznaczony dla komunikatów, które ułatwiają użytkownikom rozwiązywanie problemów z poleceniami, gdy są uruchamiane interaktywnie lub za pomocą skryptu. Write-Verbose
Użyj polecenia cmdlet , aby jawnie zapisywać komunikaty w tym strumieniu. Wiele poleceń cmdlet zapewnia pełne dane wyjściowe, które są przydatne do zrozumienia wewnętrznych operacji polecenia cmdlet. Pełne komunikaty są danymi wyjściowymi tylko wtedy, gdy używasz wspólnego parametru -Verbose
. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Debug Strumienia
Strumień Debug jest używany w przypadku komunikatów, które pomagają skryptom zrozumieć, dlaczego ich kod kończy się niepowodzeniem. Write-Debug
Użyj polecenia cmdlet , aby jawnie zapisać w tym strumieniu. Komunikaty debugowania są danymi wyjściowymi tylko wtedy, gdy używasz wspólnego parametru -Debug
. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Debug komunikaty są przeznaczone dla deweloperów skryptów i poleceń cmdlet więcej niż użytkownicy końcowi. Te komunikaty debugowania mogą zawierać wewnętrzne szczegóły niezbędne do głębokiego rozwiązywania problemów.
Information Strumienia
Strumień Information jest przeznaczony do dostarczania komunikatów, które pomagają użytkownikowi zrozumieć, co robi skrypt. Może być również używany przez deweloperów jako dodatkowy strumień używany do przekazywania informacji za pośrednictwem programu PowerShell. Deweloper może oznaczać dane strumienia i mieć konkretną obsługę tego strumienia. Write-Information
Użyj polecenia cmdlet , aby jawnie zapisać w tym strumieniu.
Write-Host
zapisuje również w strumieniu Information . Różnica między poleceniami cmdlet polega Write-Host
również na zapisie do konsoli hosta, chyba że nastąpi przekierowanie strumienia Information . Write-Information
zapisuje tylko w strumieniu Information .
Progress Strumienia
Strumień Progress jest używany w przypadku komunikatów, które komunikują postęp w dłuższych uruchomionych poleceniach i skryptach. Write-Progress
Użyj polecenia cmdlet , aby jawnie zapisywać komunikaty w tym strumieniu. Strumień Progress nie obsługuje przekierowywania.