about_Output_Streams
Kurze Beschreibung
Erläutert die Verfügbarkeit und den Zweck von Ausgabestreams in PowerShell.
Lange Beschreibung
PowerShell stellt mehrere Ausgabestreams bereit. Die Streams stellen Kanäle für verschiedene Arten von Nachrichten bereit. Sie können mit dem zugeordneten Cmdlet oder der Umleitung in diese Streams schreiben. Weitere Informationen finden Sie unter about_Redirection.
PowerShell unterstützt die folgenden Ausgabestreams.
Stream # | BESCHREIBUNG | Eingeführt in | Cmdlet "Schreiben" |
---|---|---|---|
1 | Success Stream | PowerShell 2.0 | Write-Output |
2 | Error Stream | PowerShell 2.0 | Write-Error |
3 | Warning Stream | PowerShell 2.0 | Write-Warning |
4 | Verbose Stream | PowerShell 2.0 | Write-Verbose |
5 | Debug Stream | PowerShell 2.0 | Write-Debug |
6 | Information Stream | PowerShell 5.0 | Write-Information |
– | Progress Stream | PowerShell 2.0 | Write-Progress |
Hinweis
Der Progress Stream unterstützt keine Umleitung.
Success Stream
Der Success Stream ist der Standarddatenstrom für normale, erfolgreiche Ergebnisse.
Verwenden Sie das Write-Output
Cmdlet, um Objekte explizit in diesen Stream zu schreiben. Dieser Stream wird zum Übergeben von Objekten durch die PowerShell-Pipeline verwendet. Der Success Stream ist für native Anwendungen mit dem stdout-Stream verbunden.
Error Stream
Der Error Stream ist der Standarddatenstrom für Fehlerergebnisse. Verwenden Sie das Write-Error
Cmdlet, um explizit in diesen Stream zu schreiben. Der Error Stream ist für native Anwendungen mit dem stderr-Stream verbunden. Unter den meisten Bedingungen können diese Fehler die Ausführungspipeline beenden. ErrorIn diesen Stream geschriebene s werden auch der $Error
automatischen Variablen hinzugefügt. Weitere Informationen finden Sie unter about_Automatic_Variables.
Warning Stream
Der Warning Stream ist für Fehlerbedingungen vorgesehen, die weniger schwerwiegend sind als Fehler, die in den Error Stream geschrieben werden. Unter normalen Bedingungen beenden diese Warnungen die Ausführung nicht. Warnings werden nicht in die $Error
automatische Variable geschrieben. Verwenden Sie das Write-Warning
Cmdlet, um explizit in diesen Stream zu schreiben.
Verbose Stream
Der Verbose Stream ist für Nachrichten gedacht, die Benutzern bei der Problembehandlung von Befehlen helfen, während sie interaktiv oder über ein Skript ausgeführt werden. Verwenden Sie das Write-Verbose
Cmdlet, um Nachrichten explizit in diesen Stream zu schreiben. Viele Cmdlets bieten eine ausführliche Ausgabe, die hilfreich ist, um die interne Funktionsweise des Cmdlets zu verstehen. Die ausführlichen Meldungen werden nur ausgegeben, wenn Sie den -Verbose
allgemeinen Parameter verwenden. Weitere Informationen findest du unter about_CommonParameters.
Debug Stream
Der Debug Stream wird für Nachrichten verwendet, die Skriptern helfen, zu verstehen, warum ihr Code fehlschlägt. Verwenden Sie das Write-Debug
Cmdlet, um explizit in diesen Stream zu schreiben. Die Debugmeldungen werden nur ausgegeben, wenn Sie den -Debug
allgemeinen Parameter verwenden. Weitere Informationen findest du unter about_CommonParameters.
Debug -Nachrichten sind eher für Skript- und Cmdlet-Entwickler als für Endbenutzer gedacht. Diese Debugmeldungen können interne Details enthalten, die für eine umfassende Problembehandlung erforderlich sind.
Information Stream
Der Information Stream soll Nachrichten bereitstellen, die einem Benutzer helfen zu verstehen, was ein Skript tut. Es kann auch von Entwicklern als zusätzlicher Stream verwendet werden, um Informationen über PowerShell zu übergeben. Der Entwickler kann Streamdaten markieren und über eine bestimmte Behandlung für diesen Stream verfügen. Verwenden Sie das Write-Information
Cmdlet, um explizit in diesen Stream zu schreiben.
Write-Host
schreibt auch in den Information Stream. Der Unterschied zwischen den Cmdlets besteht darin, dass Write-Host
auch In die Hostkonsole geschrieben wird, es sei denn, Sie leiten den Information Stream um. Write-Information
schreibt nur in den Information Stream.
Progress Stream
Der Progress Stream wird für Nachrichten verwendet, die den Fortschritt in länger ausgeführten Befehlen und Skripts kommunizieren. Verwenden Sie das Write-Progress
Cmdlet, um Nachrichten explizit in diesen Stream zu schreiben. Der Progress Stream unterstützt keine Umleitung.