Tutorials

PowerShell in Visual Studio Code: Der umfassende Leitfaden zur Einrichtung und Nutzung

Melden

Visual Studio Code (VS Code) hat die veraltete PowerShell ISE offiziell als primäre Entwicklungsumgebung für PowerShell abgelöst. Es bietet eine plattformübergreifende, moderne und extrem anpassbare Umgebung.

In dieser Anleitung erfährst du Schritt für Schritt, wie du VS Code optimal für PowerShell einrichtest, Skripte schreibst, ausführst und Fehler findest (Debugging).

1. Voraussetzungen

Bevor du beginnst, stelle sicher, dass Folgendes auf deinem System installiert ist:

  1. Visual Studio Code: Lade die neueste Version von der offiziellen Website herunter und installiere sie.
  2. PowerShell:
    • Unter Windows ist Windows PowerShell (5.1) vorinstalliert.
    • Empfohlen: Installiere das moderne, plattformübergreifende PowerShell 7+ (verfügbar für Windows, macOS und Linux über winget install Microsoft.PowerShell oder via GitHub).

2. Die PowerShell-Erweiterung für VS Code installieren

Die Standardinstallation von VS Code erkennt zwar PowerShell-Dateien, bietet aber ohne Erweiterung kaum nützliche Funktionen. Das offizielle PowerShell-Plugin von Microsoft verwandelt VS Code in eine vollwertige PowerShell-IDE.

  1. Öffne VS Code.
  2. Drücke Strg + Umschalt + X (macOS: Cmd + Shift + X), um die Extensions-Ansicht zu öffnen.
  3. Suche in der Suchleiste nach PowerShell.
  4. Wähle die Erweiterung von Microsoft aus und klicke auf Installieren (Install).

Nach der Installation siehst du unten rechts in der Statusleiste die Versionsnummer der aktuell aktiven PowerShell-Instanz.

3. Erste Schritte: Dein erstes Skript schreiben

  1. Öffne einen beliebigen Ordner über Datei > Ordner öffnen... (File > Open Folder...).
  2. Erstelle eine neue Datei, indem du im Explorer-Bereich auf das Datei-Symbol klickst, und nenne sie beispielsweise MeinSkript.ps1. (Wichtig ist die Dateiendung .ps1).
  3. Sobald du eine .ps1-Datei öffnest, startet automatisch die sogenannte PowerShell Integrated Console im unteren Bereich.
  4. Schreibe folgenden Testcode in die Datei:
$Name = "Welt"
Write-Host "Hallo, $Name! PowerShell läuft erfolgreich in VS Code." -ForegroundColor Green
Get-Date

4. PowerShell-Skripte in VS Code ausführen

Es gibt drei Hauptmethoden, um Skripte oder Codezeilen auszuführen:

Methode A: Das gesamte Skript ausführen

  • Über die Benutzeroberfläche: Klicke oben rechts im Editor-Fenster auf das Play-Symbol (Dreieck: Run PowerShell Script).
  • Über Tastenkürzel: Drücke F5 (Start mit Debugging) oder Strg + F5 (Start ohne Debugging).

Methode B: Nur ausgewählte Zeilen ausführen (wie in der ISE)

  • Markiere den Code-Abschnitt, den du ausführen möchtest (oder platziere den Cursor in einer einzelnen Zeile).
  • Drücke die Taste F8.
  • Der Code wird direkt in die integrierte Konsole übertragen und ausgeführt.

Methode C: Manuelle Ausführung im Terminal

  • Klicke in die unten geöffnete PowerShell-Konsole.
  • Rufe das Skript wie in einer normalen Befehlszeile auf:
    .\MeinSkript.ps1

5. Debugging (Fehlersuche) nutzen

VS Code bietet hervorragende Debugging-Tools für PowerShell:

  1. Breakpoints setzen: Klicke links neben die Zeilennummer einer Codezeile. Ein roter Punkt erscheint. An dieser Stelle pausiert das Skript während der Ausführung.
  2. Debug-Sitzung starten: Drücke F5.
  3. Variablen prüfen: Wenn das Skript am Breakpoint anhält, kannst du links im Reiter "Ausführen und Debuggen" den Inhalt deiner Variablen einsehen oder mit der Maus über die Variablen im Code fahren (Hover).
  4. Schrittweise ausführen: Nutze die Leiste am oberen Bildschirmrand (Schritt über = F10, Einzelschritt = F11, Fortsetzen = F5).

6. Wichtige Tipps und Best Practices

Problem: Skriptausführung ist deaktiviert (Execution Policy)

Wenn du unter Windows eine Fehlermeldung wie ...kann nicht geladen werden, da die Ausführung von Skripts auf diesem System deaktiviert ist erhältst:

  1. Öffne die integrierte Konsole in VS Code.
  2. Führe folgenden Befehl aus, um die Ausführung für den aktuellen Benutzer zu erlauben:
    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Zwischen PowerShell 5.1 und PowerShell 7 wechseln

Falls du mehrere Versionen installiert hast:

  1. Klicke unten rechts in der Statusleiste auf das kleine PowerShell-Icon bzw. die Versionsnummer (z. B. 7.4.x oder 5.1.x).
  2. Es öffnet sich oben ein Menü (Switch PowerShell Session Menu).
  3. Wähle die gewünschte Version aus. VS Code startet die Konsole automatisch neu.

ISE-Kompatibilitätsmodus aktivieren

Wenn du von der PowerShell ISE kommst und die bekannten Tastenkürzel und das helle Farbschema vermisst:

  1. Drücke Strg + Umschalt + P (Befehlspalette).
  2. Tippe PowerShell: Enable ISE Mode ein und drücke Enter.
  3. Möchtest du das rückgängig machen, tippe einfach PowerShell: Disable ISE Mode ein.

Fazit

Mit der offiziellen Microsoft-Erweiterung bietet Visual Studio Code die beste Entwicklungserfahrung für PowerShell. Dank Funktionen wie IntelliSense (automatischer Code-Vervollständigung), der statischen Codeanalyse (PSScriptAnalyzer) und der nahtlosen Integration von Git bist du sowohl für einfache Automatisierungs-Aufgaben als auch für komplexe Modulentwicklungen bestens gerüstet.

0