about_Output_Streams
Kurze Beschreibung
Erläutert die Verfügbarkeit und den Zweck von Ausgabedatenströmen in PowerShell.
Lange Beschreibung
PowerShell stellt mehrere Ausgabestreams bereit. Die Datenströme stellen Kanäle für verschiedene Nachrichtentypen bereit. Sie können mit dem zugehörigen 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 | 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 |
Nicht zutreffend | Progress Stream | PowerShell 2.0 | Write-Progress |
Hinweis
Der Progress Datenstrom unterstützt keine Umleitung.
Success Stream
Der Success Datenstrom ist der Standarddatenstrom für normale, erfolgreiche Ergebnisse.
Verwenden Sie das Write-Output
Cmdlet, um Objekte explizit in diesen Stream zu schreiben. Dieser Datenstrom wird zum Übergeben von Objekten über die PowerShell-Pipeline verwendet. Der Success Datenstrom ist mit dem Stdout-Datenstrom für systemeigene Anwendungen verbunden.
Error Stream
Der Error Datenstrom ist der Standarddatenstrom für Fehlerergebnisse. Verwenden Sie das Write-Error
Cmdlet, um explizit in diesen Datenstrom zu schreiben. Der Error Datenstrom ist mit dem Stderr-Stream für systemeigene Anwendungen verbunden. Unter den meisten Bedingungen können diese Fehler die Ausführungspipeline beenden. Errorin diesen Datenstrom geschriebene Datenstrom werden auch der $Error
automatischen Variablen hinzugefügt. Weitere Informationen finden Sie unter about_Automatic_Variables.
Warning Stream
Der Warning Datenstrom ist für Fehlerbedingungen vorgesehen, die weniger schwerwiegend sind als fehler, die in den Error Datenstrom geschrieben wurden. Unter normalen Bedingungen beenden diese Warnungen die Ausführung nicht. Warningwird nicht in die $Error
automatische Variable geschrieben. Verwenden Sie das Write-Warning
Cmdlet, um explizit in diesen Datenstrom zu schreiben.
Verbose Stream
Der Verbose Datenstrom ist für Nachrichten vorgesehen, die Benutzern bei der Problembehandlung von Befehlen helfen, wenn sie interaktiv oder über ein Skript ausgeführt werden. Verwenden Sie das Write-Verbose
Cmdlet, um Nachrichten explizit in diesen Datenstrom zu schreiben. Viele Cmdlets bieten ausführliche Ausgabe, die hilfreich ist, um die internen Funktionsweisen 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.
Debug Stream
Der Debug Datenstrom 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 Datenstrom zu schreiben. Die Debugmeldungen werden nur ausgegeben, wenn Sie den -Debug
gemeinsamen Parameter verwenden. Weitere Informationen findest du unter about_CommonParameters.
Debug Nachrichten sind für Skript- und Cmdlet-Entwickler vorgesehen, die mehr als Endbenutzer sind. Diese Debugmeldungen können interne Details enthalten, die für eine umfassende Problembehandlung erforderlich sind.
Information Stream
Der Information Datenstrom soll Nachrichten bereitstellen, die einem Benutzer helfen, zu verstehen, was ein Skript tut. Sie kann auch von Entwicklern als zusätzlicher Datenstrom verwendet werden, der zum Übergeben von Informationen über PowerShell verwendet wird. Der Entwickler kann Streamdaten kategorisieren und eine spezifische Behandlung für diesen Datenstrom haben. Verwenden Sie das Write-Information
Cmdlet, um explizit in diesen Datenstrom zu schreiben.
Write-Host
schreibt auch in den Information Datenstrom. Der Unterschied zwischen den Cmdlets besteht darin, dass Write-Host
auch in die Hostkonsole geschrieben wird, es sei denn, Sie leiten den Information Datenstrom um. Write-Information
schreibt nur in den Information Datenstrom.
Progress Stream
Der Progress Datenstrom wird für Nachrichten verwendet, die den Fortschritt bei länger ausgeführten Befehlen und Skripts kommunizieren. Verwenden Sie das Write-Progress
Cmdlet, um Nachrichten explizit in diesen Datenstrom zu schreiben. Der Progress Datenstrom unterstützt keine Umleitung.