HOWTO · PowerShell

Das Echo-Equivalent in PowerShell

Dieses Tutorial wird äquivalente echo-Befehle in PowerShell für Skripte und Funktionen vorstellen.

Auf dieser Seite

In PowerShell ist echo ein Alias für Write-Output. Verwenden Sie den Alias oder rufen Sie Write-Output direkt auf, um einen Wert an den Erfolgsausgabestream zu senden. Wird dieser Wert nicht an einen weiteren Befehl weitergeleitet, zeigt die interaktive Shell ihn an. Für Meldungen, die nur für eine Person an der Konsole bestimmt sind, verwenden Sie Write-Host; für optionale Diagnosemeldungen verwenden Sie Write-Debug oder Write-Verbose.

Führen Sie dieses Beispiel aus. Es gibt den Text „Hello World!“ aus; diese Zeichenfolge bleibt im unveränderten Code auf Englisch.

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

Write-Output "Hello World!"

Welcher PowerShell-Befehl ersetzt echo?

echo ist ein praktischer Alias für Write-Output. Bestehende Skripte, die echo "Hello World!" verwenden, senden die Zeichenfolge daher an denselben Ausgabestream. In wiederverwendbaren Skripten ist die ausgeschriebene Form Write-Output leichter zu erkennen. Sie ist das passendste PowerShell-Äquivalent, wenn ein Wert angezeigt oder an einen anderen Befehl weitergegeben werden soll.

Ausgabe mit Write-Output durch die Pipeline leiten

Write-Output schreibt ein Objekt in den Erfolgsausgabestream von PowerShell. Wenn kein Befehl das Objekt verarbeitet, zeigt die Shell es an; andernfalls kann die Pipeline es weiterverarbeiten. Zum Beispiel übergibt Write-Output "Hello World!" | Set-Content -Path message.txt die Zeichenfolge an den nächsten Befehl, statt sie als abschließendes Ergebnis auszugeben. In der Regel übergeben Sie den Wert als Argument und müssen den Parameter -InputObject nicht ausdrücklich angeben.

Verwenden Sie dieses Cmdlet, wenn eine Funktion Daten für den Aufrufer zurückgeben soll oder ein nachfolgender Pipelineschritt den Wert filtern, umwandeln oder speichern soll. Eine reine Host-Ausgabe eignet sich nicht für Daten, die der Aufrufer erfassen muss.

Mit Write-Host direkt in der Konsole ausgeben

Mit Write-Host "Hello World!" zeigen Sie eine Meldung direkt über den aktuellen PowerShell-Host an. Das Cmdlet ist für die Anzeige für Benutzer gedacht, etwa für einen kurzen Fortschrittshinweis oder eine farbige Statusmeldung. Die Zeichenfolge wird nicht in den Erfolgsausgabestream geschrieben und steht einem Aufrufer daher nicht als gewöhnliche Pipeline-Daten zur Verfügung.

Für Write-Host muss der Parameter -Object nicht ausdrücklich angegeben werden. Verwenden Sie Write-Output für Werte, die Skripte oder Funktionen zurückgeben sollen, und Write-Host, wenn die Meldung selbst angezeigt werden soll.

Mit Write-Debug und Write-Verbose Diagnosemeldungen ausgeben

Diagnosemeldungen sind von der gewöhnlichen Erfolgsausgabe getrennt. Write-Debug "Checking configuration" kennzeichnet eine Meldung als Debug-Information; Write-Verbose "Loading configuration" kennzeichnet sie als zusätzliche Betriebsinformation. Ob sie angezeigt werden, steuern $DebugPreference und $VerbosePreference unabhängig voneinander.

Der Standardwert von $DebugPreference ist SilentlyContinue, daher bleiben Debug-Meldungen normalerweise verborgen. Mit $DebugPreference = "Continue" werden sie angezeigt, während das Skript weiterläuft. Entsprechend zeigt $VerbosePreference = "Continue" Meldungen von Write-Verbose an. In erweiterten Funktionen und Skripten können Aufrufer ausführliche Meldungen üblicherweise mit dem allgemeinen Parameter -Verbose aktivieren. Verwenden Sie den passenden Diagnosetyp, statt gewöhnliche Ausgaben als Debug- oder ausführliche Meldungen zu kennzeichnen.

Ein Zeichenfolgenliteral direkt ausgeben

Auch eine Zeichenfolge in Anführungszeichen erzeugt als PowerShell-Ausdruck einen Wert im Erfolgsausgabestream. Für eine schnelle interaktive Prüfung geben Sie an der Eingabeaufforderung "Hello World!" ein. Diese Kurzform eignet sich zum Ausprobieren eines Werts; in einem längeren Skript macht ein ausdrücklicher Aufruf von Write-Output die Absicht jedoch klarer. Wie andere Werte im Erfolgsausgabestream kann die Zeichenfolge erfasst oder weitergeleitet werden, statt sofort auf dem Bildschirm zu erscheinen.

Die passende Ausgabemethode wählen

Wählen Sie die Methode danach aus, wer oder was die Meldung erhalten soll:

  • Verwenden Sie Write-Output (oder den Alias echo), wenn Sie Daten für den Aufrufer, die Pipeline oder die Anzeige in der Shell erzeugen.
  • Verwenden Sie Write-Host für Meldungen, die im Host erscheinen, aber nicht als Pipeline-Daten zurückgegeben werden sollen.
  • Verwenden Sie Write-Debug für Debug-Diagnosen und Write-Verbose für optionale Betriebsinformationen. Aktivieren Sie sie jeweils über die zugehörige Präferenzsteuerung oder einen unterstützten allgemeinen Parameter.
  • Verwenden Sie eine Zeichenfolge in Anführungszeichen als schnellen Ausdruck an der interaktiven Eingabeaufforderung.

Diese Möglichkeiten sind nicht austauschbar. Wenn der Aufrufer einer Funktion einen Wert erfassen, umwandeln oder umleiten muss, geben Sie ihn über den Erfolgsausgabestream aus. Direkte Host-Ausgaben und Diagnosestreams sind Meldungen vorbehalten, die eine Person informieren sollen, statt das Funktionsergebnis bereitzustellen.