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 informationinformacji, zobacz about_Redirection.
Program PowerShell obsługuje następujące strumienie wyjściowe.
| Strumień # | opis | Wprowadzone w | Write Cmdlet |
|---|---|---|---|
| 1 | Success strumień | PowerShell 2.0 | Write-Output |
| 2 | Error strumień | PowerShell 2.0 | Write-Error |
| 3 | Warning strumień | PowerShell 2.0 | Write-Warning |
| 100 | Verbose strumień | PowerShell 2.0 | Write-Verbose |
| 5 | Debug strumień | PowerShell 2.0 | Write-Debug |
| 6 | Information strumień | PowerShell 5.0 | Write-Information |
| nie dotyczy | Progress strumień | PowerShell 2.0 | Write-Progress |
Uwaga
Strumień Progress nie obsługuje przekierowywania.
Success strumień
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 strumień
Strumień Error jest domyślnym strumieniem wyników error . 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. Błędy zapisywane w tym strumieniu są również dodawane do zmiennej automatycznej $Error . Aby uzyskać więcej informationinformacji, zobacz about_Automatic_Variables.
Warning strumień
Strumień Warning jest przeznaczony dla error warunkó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 zmiennej automatycznej $Error . Write-Warning Użyj polecenia cmdlet , aby jawnie zapisać w tym strumieniu.
Verbose strumień
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 udostępnia verbose dane wyjściowe, które są przydatne do zrozumienia wewnętrznych operacji polecenia cmdlet. Komunikaty verbose są wyjściowe tylko wtedy, gdy używasz wspólnego parametru -Verbose . Aby uzyskać więcej informationinformacji, zobacz about_CommonParameters.
Debug strumień
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 debug są wyjściowe tylko wtedy, gdy używasz wspólnego parametru -Debug . Aby uzyskać więcej informationinformacji, zobacz about_CommonParameters.
Debug komunikaty są przeznaczone dla deweloperów skryptów i poleceń cmdlet więcej niż użytkownicy końcowi. Te debug komunikaty mogą zawierać wewnętrzne szczegóły niezbędne do głębokiego rozwiązywania problemów.
Information strumień
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 information 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 strumień
Strumień Progress jest używany dla komunikatów komunikujących się progress w dłuższych poleceniach i skryptach. Write-Progress Użyj polecenia cmdlet , aby jawnie zapisywać komunikaty w tym strumieniu. Strumień Progress nie obsługuje przekierowywania.
