PowerShell Debugging: Visual Studio Code versus Bordmittel

Wann mit der PowerShell-Konsole debuggen?

Ein Beispiel: Sie schreiben einen Code-Snippet, um das aktuelle Verzeichnis nach JSON-Protokolldateien zu durchsuchen, die das Jahr 2020 im Namen tragen, und kopieren diese Dateien dann in ein anderes Verzeichnis.

Bevor Sie ein Skript in der Konsole ausführen, geben Sie einige Variablen als Befehle in die Konsole ein:

$sourceDir = 'C:\tmp\logs'

$targetDir = 'C:\logs'

Geben Sie dann den folgenden Einzeiler ein (Hinweis: Da Sie diesen Befehl interaktiv ausführen, ist es o. k., Aliase zu verwenden, bei denen es sich um Befehlskürzel oder alternative Namen handelt):

gci $sourceDir -filter *20*.json | %{copy $_.FullName -Destination $targetDir}

Beim Ausführen des Codes wird klar, dass er Dateien kopiert, die nicht geplant waren, nämlich Dateien aus dem letzten Jahr, obwohl im Cmdlet der Filter Get-ChildItem gesetzt ist, damit nur nach Dateien mit der Jahreszahl 20 gesucht wird. Um dies zu beheben, fügen Sie den Befehl Wait-Debugger hinzu, um in den Debugger zu wechseln:

gci $sourceDir -filter *20*.json | %{Wait-Debugger; copy $_ -Destination $targetDir}

Das sollte zu einem ähnlichen Ergebnis wie unten führen:

Jetzt haben Sie vollständigen Zugriff auf den PowerShell-Debugger. Verwenden Sie $_, um das aktuelle Element im Schleifen-Cmdlet ForEach-Object zu untersuchen.

Wie unten gezeigt, ist eine Datei aus dem Jahr 2019, aber sie geht durch den Filter, da sie im Namen die 20 enthält:

Um dies zu überprüfen, verwenden Sie C, um zum nächsten Schritt überzugehen:

Beim nächsten Objekt handelt es sich wieder um eine Datei aus dem Jahr 2019. Beenden Sie also den Debugger mit q und korrigieren Sie den Code, um sicherzustellen, dass das neue Verzeichnis nur Dateien aus dem Jahr 2020 enthält:

gci $sourceDir -filter 2020*.json | %{copy $_.FullName -Destination $targetDir}

Es ist möglich, dieses Snippet noch etwas ausgefeilter zu gestalten – zum Beispiel, damit es den Inhalt der Datei überprüft, um sicherzustellen, dass der Zeitstempel in der Protokolldatei auch aus 2020 stammt. PowerShell ermöglicht es Admins, lange Einzeiler zu schreiben, aber sie werden schnell unhandlich, besonders wenn es sie zu debuggen gilt.

Es ist möglich, ein mehrzeiliges Skript interaktiv in PowerShell zu schreiben. Nach jedem Befehl kann durch das gleichzeitige Drücken der Umschalt- und Eingabetaste in eine neue Zeile gewechselt werden. Das war es dann aber auch schon in Sachen Übersichtlichkeit: die Konsole bietet nur grundlegende Textbearbeitungsfunktionen.

Für fortgeschrittenere Funktionen ist es deshalb am besten, zum Debuggen auf Visual Studio Code umzusteigen.

Wann in Visual Studio Code debuggen?

Im gewählten Beispiel enthalten die JSON-Protokolldateien ein Array, in dem das erste Element das Datum der Erstellung der Datei ist. Zum Beispiel:

[

    "2020-01-17 18:05:01.325248",

    {...

Erweitern Sie das Skript aus dem vorigen Abschnitt, damit auch dort das Datum überprüft wird:

$sourceDir = 'C:\tmp\logs'

$targetDir = 'C:\logs'

$files = Get-ChildItem $sourceDir -filter 2020*.json

foreach ($file in $files) {

    $json = Get-Content $file.FullName | ConvertTo-Json

    if ($json[0] -like '2020*') {

        Copy-Item $file.FullName -Destination $targetDir

    }

}

In Zeile sechs sehen wir das erste Element in der konvertierten JSON-Matrix. Leider werden nach der Ausführung des Codes keine Dateien im Zielverzeichnis angezeigt; es ist Zeit für mehr PowerShell-Debugging.

Setzen Sie den Cursor auf Zeile sechs und drücken Sie F9 auf der Tastatur, um einen Haltepunkt hinzuzufügen: Wenn der Code auf diese Zeile trifft, wird er im Debugger im Terminal abgelegt. Beachten Sie den roten Punkt links neben der Zeile:

Nachdem der Haltepunkt gesetzt ist, drücken Sie F5, um den Code auszuführen. Wenn Sie durch den Debugger-Bereich blättern, sehen Sie die Werte aller Variablen im Skript auf der linken Seite anzeigt:

Sie können die aktuelle $file, die Anzahl der Objekte im Array $files und sogar die $json-Variable sehen. Um die $json-Variable genauer zu betrachten, wählen Sie die gleichen PowerShell-Debugging-Funktionen von der Konsole im Terminal aus. Eingabe:

$json[0]

Die unten gezeigten Ergebnisse entsprechen nicht den Erwartungen, da das erste Element in der $json-Variablen ein [ anstelle des Datums ist:

Um zu sehen, was für ein Objekttyp $json ist, fahren Sie mit der Maus über die Variable im Debugger-Fenster oder untersuchen Sie die Variable direkt. In beiden Fällen wird ein String angezeigt:

Das Cmdlet ConvertFrom-Json sollte jedoch ein Objekt – wie in diesem Beispiel beabsichtigt – und keinen String erzeugen. Dies liegt daran, dass wir – wenn wir uns das Skript vom Anfang dieses Abschnitts erneut ansehen – versehentlich ConvertTo-Json anstelle von ConvertFrom-Json verwenden.

Der korrigierte Code sollte wie folgt aussehen:

$sourceDir = 'D:\UtoData'

$targetDir = 'C:\logs'

$files = Get-ChildItem $sourceDir -filter 2020*.json

foreach ($file in $files) {

    $json = Get-Content $file.FullName | ConvertFrom-Json

    if ($json[0] -like '2020*') {

        Copy-Item $file.FullName -Destination $targetDir

    }

}

Lassen Sie den Haltepunkt auf Zeile sechs und führen Sie den Code mit F5 erneut aus und sehen Sie sich die Variable $json noch einmal an:

Die Ergebnisse sehen jetzt wie erwartet aus, da wir jetzt ein Objekt statt eines Strings haben. Dies bedeutet, dass ConvertFrom-Json funktioniert hat. Um den Haltepunkt zu entfernen, setzen Sie den Cursor wieder auf Zeile sechs und drücken Sie F9. Drücken Sie jetzt wieder F5, und der Code wird wie beabsichtigt ausgeführt.