Hinzufügen der Ausgabe zu Windows PowerShell-Skripts

  • 6 Minuten

Wenn ein Skript nicht wie erwartet ausgeführt wird, kann es nützlich sein, wenn das Skript zusätzliche Informationen anzeigt. Sie können diese Informationen verwenden, um zu verstehen, was das Skript tut und warum es nicht wie erwartet funktioniert.

Das Cmdlet Write-Host ist die gängigste Möglichkeit, während der Ausführung eines Skripts zusätzliche Informationen anzuzeigen. Mithilfe von Write-Host können Sie Textinformationen anzeigen, die bestimmte Punkte in einem Skript und Variablenwerte angeben. Variablenwerte können in den meisten Fällen nützlich sein, in denen ein Skript sich nicht wie erwartet verhält, da eine Variable keinen von Ihnen erwarteten Wert aufweist.

Wenn Sie Ihren Problembehandlungstext einfacher identifizierbar machen möchten, können Sie das Cmdlet Write-Warning anstelle von Write-Host verwenden. Write-Warning zeigt den von Ihnen angegebenen Text in einer alternativen Farbe an.

Wenn Sie die Ausführung eines Skripts verlangsamen möchten, damit Sie die Ausgabe besser überprüfen können, können Sie ein Cmdlet Start-Sleep hinzufügen und ein paar Sekunden angeben, die die Skriptausführung pausieren soll. Alternativ, wenn Sie möchten, dass das Skript angehalten wird, bis Sie zum Fortsetzen seiner Ausführung bereit sind, können Sie Read-Host verwenden.

Während Sie sich im Prozess der Problembehandlung befinden, können Sie die zusätzlichen Informationen auskommentieren. Falls erforderlich, können Sie die Kommentare anschließend aufheben, um die zusätzlichen Informationen zu überprüfen.

Erweiterte Skriptausgabe

Wenn Sie Ihr Skript mithilfe von CmdletBinding() im Param()-Block als erweitertes Skript konfiguriert haben, können Sie auch die Cmdlets in der folgenden Tabelle als Teil Ihres Skripts zur Problembehandlung verwenden.

Tabelle 1: Cmdlets zur Problembehandlung

Cmdlet BESCHREIBUNG
Write-Verbose Text, der von Write-Verbose angegeben wird, wird nur angezeigt, wenn Sie bei der Ausführung des Skripts den -Verbose-Parameter verwenden. Der Wert von $VerbosePreference gibt die Aktion an, die nach dem Befehl Write-Verbose ausgeführt werden soll. Der Standardwert ist SilentlyContinue.
Write-Debug Text, der durch Write-Debug angegeben wird, wird nur angezeigt, wenn Sie bei der Ausführung des Skripts den -Debug-Parameter verwenden. Der Wert von $DebugPreference gibt die Aktion an, die nach dem Befehl Write-Debug ausgeführt werden soll. Die Standardaktion ist SilentlyContinue, bei der keine Informationen auf dem Bildschirm angezeigt werden. Sie müssen diese Aktion in Continue (Fortsetzen) ändern, damit Debugmeldungen angezeigt werden.