o_Strumieniach_Wyjściowych

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 poprzez przekierowanie. Aby uzyskać więcej informacji, zobacz about_Redirection.

Program PowerShell obsługuje następujące strumienie wyjściowe.

Strumień #	Opis	Wprowadzone w	Polecenie Write Cmdlet
1	strumień Success	PowerShell 2.0	Write-Output
2	strumień Error	PowerShell 2.0	Write-Error
3	strumień Warning	PowerShell 2.0	Write-Warning
4	strumień Verbose	PowerShell 2.0	Write-Verbose
5	strumień Debug	PowerShell 2.0	Write-Debug
6	strumień Information	PowerShell 5.0	Write-Information
N/a	strumień Progress	PowerShell 2.0	Write-Progress

Notatka

Strumień Progress nie obsługuje przekierowywania.

strumień Success

Strumień Success jest domyślnym strumieniem dla normalnych, pomyślnych wyników. Użyj polecenia cmdlet Write-Output, aby jawnie zapisywać obiekty w tym strumieniu. Ten strumień jest używany do przekazywania obiektów przez potok programu PowerShell. Strumień Success jest połączony ze strumieniem stdout dla aplikacji natywnych.

strumień Error

Strumień Error jest domyślnym strumieniem wyników błędów. Użyj polecenia cmdlet Write-Error, aby jawnie zapisać w tym strumieniu. Strumień Error jest połączony ze strumieniem stderr dla aplikacji natywnych. W większości przypadków te błędy mogą zakończyć potok wykonywania. Błędy zapisywane w tym strumieniu są również dodawane do zmiennej automatycznej $Error. Aby uzyskać więcej informacji, zobacz about_Automatic_Variables.

strumień Warning

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. Ostrzeżenia nie są zapisywane w automatycznej zmiennej $Error. Użyj polecenia cmdlet Write-Warning, aby jawnie zapisać w tym strumieniu.

strumień Verbose

Strumień Verbose jest przeznaczony dla komunikatów, które ułatwiają użytkownikom rozwiązywanie problemów z poleceniami uruchamianymi interaktywnie lub za pomocą skryptu. Użyj polecenia cmdlet Write-Verbose, 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 -Verbose wspólnego parametru. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

strumień Debug

Strumień Debug jest używany w przypadku komunikatów, które pomagają skryptom zrozumieć, dlaczego ich kod kończy się niepowodzeniem. Użyj polecenia cmdlet Write-Debug, aby jawnie zapisać w tym strumieniu. Komunikaty debugowania są danymi wyjściowymi tylko wtedy, gdy używasz -Debug wspólnego parametru. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Debug komunikaty są przeznaczone bardziej dla twórców skryptów i komend cmdlet niż dla użytkowników końcowych. Te komunikaty debugowania mogą zawierać wewnętrzne szczegóły niezbędne do głębokiego rozwiązywania problemów.

strumień Information

Strumień Information ma na celu dostarczenie 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 zapewnić specyficzną obsługę tego strumienia. Użyj polecenia cmdlet Write-Information, aby jawnie zapisać w tym strumieniu.

Write-Host również zapisuje w strumieniu Information. Różnica między poleceniami cmdlet polega na tym, że Write-Host również zapisuje w konsoli hosta, chyba że nastąpi przekierowanie strumienia Information. Write-Information zapisuje tylko do strumienia Information.

strumień Progress

Strumień Progress jest używany dla komunikatów, które komunikują się z postępem w dłuższych uruchomionych poleceniach i skryptach. Użyj polecenia cmdlet Write-Progress, aby jawnie zapisywać komunikaty w tym strumieniu. Strumień Progress nie obsługuje przekierowywania.

Zobacz także

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