about_Output_Streams
Kurze Beschreibung
Erläutert die Verfügbarkeit und den Zweck von Ausgabedatenströmen in PowerShell.
Lange Beschreibung
PowerShell stellt mehrere Ausgabedatenströme bereit. Die Streams bieten Kanäle für verschiedene Arten von Nachrichten. Sie können mit dem zugeordneten Cmdlet oder der Umleitung in diese Datenströme schreiben. Weitere Informationen finden Sie unter about_Redirection.
PowerShell unterstützt die folgenden Ausgabedatenströme.
Stream # | BESCHREIBUNG | Eingeführt in | Cmdlet schreiben |
---|---|---|---|
1 | Erfolgsstream | PowerShell 2.0 | Write-Output |
2 | Fehlerdatenstrom | PowerShell 2.0 | Write-Error |
3 | Warnungsstream | PowerShell 2.0 | Write-Warning |
4 | Ausführlicher Stream | PowerShell 2.0 | Write-Verbose |
5 | Debuggen des Datenstroms | PowerShell 2.0 | Write-Debug |
6 | Informationsstream | PowerShell 5.0 | Write-Information |
– | Statusdatenstrom | PowerShell 2.0 | Write-Progress |
Hinweis
Der Statusstream unterstützt keine Umleitung.
Erfolgsstream
Der Success-Stream ist der Standardstream 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 mit dem stdout-Stream für native Anwendungen verbunden.
Fehlerdatenstrom
Der Fehlerstream ist der Standardstream für Fehlerergebnisse. Verwenden Sie das Write-Error
Cmdlet, um explizit in diesen Stream zu schreiben. Der Fehlerstream ist für native Anwendungen mit dem stderr-Stream verbunden. Unter den meisten Bedingungen können diese Fehler die Ausführungspipeline beenden. Fehler, die in diesen Stream geschrieben wurden, werden auch der $Error
automatischen Variablen hinzugefügt. Weitere Informationen finden Sie unter about_Automatic_Variables.
Warnungsstream
Der Warnungsstream ist für Fehlerbedingungen vorgesehen, die weniger schwerwiegend sind als Fehler, die in den Fehlerstream geschrieben werden. Unter normalen Bedingungen beenden diese Warnungen die Ausführung nicht. Warnungen werden nicht in die $Error
automatische Variable geschrieben. Verwenden Sie das Write-Warning
Cmdlet, um explizit in diesen Stream zu schreiben.
Ausführlicher Datenstrom
Der ausführliche Stream ist für Nachrichten vorgesehen, 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 Explizit Nachrichten in diesen Stream zu schreiben. Viele Cmdlets bieten ausführliche Ausgabe, die hilfreich ist, um die interne Funktionsweise des Cmdlets zu verstehen. Die ausführlichen Nachrichten werden nur ausgegeben, wenn Sie den -Verbose
allgemeinen Parameter verwenden. Weitere Informationen findest du unter about_CommonParameters.
Debugdatenstrom
Der Debugstream 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.
Debugnachrichten sind mehr für Skript- und Cmdletentwickler als Für Endbenutzer vorgesehen. Diese Debugmeldungen können interne Details enthalten, die für eine umfassende Problembehandlung erforderlich sind.
Informationsstream
Der Informationsstream soll eine Nachricht bereitstellen, die einem Benutzer hilft 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 taggen und eine spezifische Behandlung für diesen Stream haben. Verwenden Sie das Write-Information
Cmdlet, um explizit in diesen Stream zu schreiben.
Statusdatenstrom
Der Statusdatenstrom wird für Nachrichten verwendet, die den Fortschritt in länger ausgeführten Befehlen und Skripts mitteilen. Verwenden Sie das Write-Progress
Cmdlet, um Explizit Nachrichten in diesen Stream zu schreiben. Der Statusstream unterstützt keine Umleitung.