about_Output_Streams

Artykuł
04/13/2023

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.