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 zapewniają kanały dla różnych typów komunikatów. Te strumienie można zapisywać 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 Wprowadzona w Polecenie cmdlet zapisu
1 Success Strumienia PowerShell 2.0 Write-Output
2 Error Strumienia PowerShell 2.0 Write-Error
3 Warning Strumienia PowerShell 2.0 Write-Warning
4 Verbose Strumienia PowerShell 2.0 Write-Verbose
5 Debug Strumienia PowerShell 2.0 Write-Debug
6 Information Strumienia PowerShell 5.0 Write-Information
n/d Progress Strumienia PowerShell 2.0 Write-Progress

Uwaga

Strumień Progress nie obsługuje przekierowania.

Success Strumienia

Strumień Success jest domyślnym strumieniem dla normalnych, zakończonych powodzeniem 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 napisać do tego strumienia. 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. Errors zapisane w tym strumieniu są również dodawane zmienna automatyczna $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 napisać do tego strumienia.

Verbose Strumienia

Strumień Verbose jest przeznaczony dla komunikatów, które ułatwiają użytkownikom rozwiązywanie problemów z poleceniami, ponieważ są uruchamiane interaktywnie lub ze skryptu. Write-Verbose Użyj polecenia cmdlet, aby jawnie napisać komunikaty do tego strumienia. Wiele poleceń cmdlet zapewnia pełne dane wyjściowe, które są przydatne do zrozumienia wewnętrznych operacji polecenia cmdlet. Pełne komunikaty są wyjściowe 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 napisać do tego strumienia. Komunikaty debugowania są wyjściowe 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 ma na celu dostarczenie komunikatu, który pomoże 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 tagować dane strumienia i mieć określoną obsługę tego strumienia. Write-Information Użyj polecenia cmdlet, aby jawnie napisać do tego strumienia.

Progress Strumienia

Strumień Progress jest używany w przypadku komunikatów, które komunikują się z postępem w dłuższych poleceniach i skryptach. Write-Progress Użyj polecenia cmdlet, aby jawnie napisać komunikaty do tego strumienia. Strumień Progress nie obsługuje przekierowania.

Zobacz też