PowerShell ist eine Shell und eine Skriptsprache in einem. Sie tippen einen Befehl, bekommen ein Ergebnis, und denselben Befehl können Sie später in eine Datei schreiben und automatisch laufen lassen. Dieser Kurs führt Sie vom ersten Befehl bis zu Runbooks, die vor jeder Änderung zeigen, was sie tun würden. In dieser ersten Lektion lernen Sie, in welcher PowerShell Sie überhaupt sitzen, wie ein Befehl aufgebaut ist und wie Sie sich selbst helfen, wenn Sie einen nicht kennen. Der Kurs ist allgemein gehalten: Alles läuft auf Windows, Linux und macOS, soweit nicht ausdrücklich etwas anderes steht.

Alle Beispiele dieses Kurses wurden in PowerShell 7.6.9 auf Windows 11 ausgeführt, die gezeigte Ausgabe stammt aus diesem Lauf. Wo die Ausgabe von Ihrer abweicht (Datum, Sprache der Meldungen, Pfade), sagt der Text es.

Zwei Programme nebeneinander

Auf einem Windows-Rechner gibt es zwei verschiedene PowerShells, und beide können zugleich installiert sein:

  • Windows PowerShell 5.1 heißt als Programm powershell.exe. Sie ist Teil von Windows und baut auf dem .NET Framework auf.
  • PowerShell 7 heißt als Programm pwsh (unter Windows pwsh.exe), baut auf dem modernen .NET auf und läuft auch unter Linux und macOS.

Microsoft Learn beschreibt, dass PowerShell 7 neben Windows PowerShell 5.1 läuft: eigener Installationsordner, eigener Programmname, eigener Modulpfad, eigene Profile. Der neue Name pwsh macht es möglich, beide Versionen nebeneinander zu betreiben. Dieser Kurs lehrt PowerShell 7; Windows PowerShell 5.1 kommt nur dort vor, wo sich das Verhalten unterscheidet.

Welche Sitzung Sie vor sich haben, sagt die automatische Variable $PSVersionTable. Zuerst in PowerShell 7:

PowerShell
$PSVersionTable.PSVersion.ToString()
$PSVersionTable.PSEdition
7.6.9
Core

Dieselben beiden Zeilen aus powershell.exe heraus:

5.1.26100.9711
Desktop

Core und Desktop sind die beiden Editionen: Core ist PowerShell 7 auf dem modernen .NET, Desktop ist Windows PowerShell auf dem .NET Framework. Ein Skript, das sich auf eine Eigenschaft einer Edition verlässt, kann die Edition prüfen. Meistens genügt es, im Skript zu verlangen, dass es mit pwsh läuft, und das in der ersten Zeile zu sagen:

PowerShell
#Requires -Version 7.0

Läuft das Skript in einer älteren Version, bricht PowerShell mit einer Meldung ab, bevor die erste Zeile Schaden anrichtet.

Neue Sprachmittel gibt es in PowerShell 7 (die Ternary-Schreibweise bedingung ? a : b und ForEach-Object -Parallel nennt Learn als Beispiele). Wenn ein Modul nur in Windows PowerShell 5.1 läuft, kann PowerShell 7 es über eine Kompatibilitätsschicht laden; Learn beschreibt das unter „PowerShell 7 module compatibility“. Wir kommen in Modul PS.4 darauf zurück, wenn es um Azure geht.

Der erste Befehl

Starten Sie pwsh (in Windows Terminal, in VS Code oder in einer Konsole). Eine Zeile, die Sie eintippen und mit Enter bestätigen, heißt Befehl. Der einfachste:

PowerShell
Get-Date

Get-Date gibt das aktuelle Datum und die Uhrzeit zurück. Der Befehl hat zwei Teile, Verb und Nomen, durch einen Bindestrich getrennt: Get (holen) und Date (Datum). Solche Befehle heißen Cmdlets (gesprochen „Command-lets“). Das Muster ist überall gleich, und das ist die größte Hilfe beim Lernen: Wer Get-Process kennt, errät Get-Service, Get-Item, Get-Content; wer Remove-Item kennt, errät Remove-Service. Verben mit gleicher Bedeutung gibt es nur einmal (Get, nie Fetch oder Read). Die Liste der anerkannten Verben liefert ein Cmdlet:

PowerShell
Get-Verb | Select-Object -First 3 -Property Verb, Group

Die Spalten Verb und Group zeigen die ersten Verben (Add, Clear, Close) und ihre Gruppe (Common). Sehen Sie die Beschreibung in Ihrer Sprache, kann sie bei Ihnen anders lauten als im Kurs.

Dass es nicht nur Cmdlets gibt, zeigt Get-Command:

PowerShell
(Get-Command Get-ChildItem).CommandType
(Get-Command Get-ChildItem).Source
Cmdlet
Microsoft.PowerShell.Management

Cmdlet ist eine von mehreren Befehlsarten. Daneben gibt es Function (in PowerShell selbst geschrieben, Lektion PS.2.2), Alias (ein Kurzname, siehe unten), Application (ein Programm wie git.exe) und ExternalScript (eine .ps1-Datei). Für Sie als Anwender verhalten sich die Arten gleich. Source sagt, aus welchem Modul ein Cmdlet kommt: ein Modul bündelt zusammengehörige Befehle (Microsoft.PowerShell.Management für Dateien, Prozesse, Dienste).

Befehle finden

Sie müssen nicht alle Cmdlets kennen. Sie brauchen drei Wege, sie zu finden:

PowerShell
Get-Command -Verb Get -Noun Process*
Get-Process
Get-ProcessMitigation

(die Ausgabe auf Windows; unter Linux und macOS gibt es Get-ProcessMitigation nicht). -Verb und -Noun filtern, * steht für beliebig viele Zeichen. Wenn Sie nur wissen, dass das Nomen irgendetwas mit „Service“ zu tun hat, genügt Get-Command *Service*. Der zweite Weg ist Get-Help (nächster Abschnitt), der dritte die Dokumentation auf Learn.

Parameter: Name, Position, Schalter

Ein Befehl bekommt seine Eingaben über Parameter. Ein Parameter beginnt mit einem Bindestrich, dann folgt sein Name und, wenn er einen Wert braucht, der Wert:

PowerShell
Get-Process -Name pwsh

Parameter haben unterschiedliche Eigenschaften, und Sie können sie nachlesen. So zeigt Get-Help die Angaben zu -Name von Get-Process:

PowerShell
Get-Help Get-Process -Parameter Name

Die Ausgabe nennt den Typ (<string[]>, also eine oder mehrere Zeichenketten), ob der Parameter erforderlich ist (hier nicht), seine Position (0), ob er Eingaben aus der Pipeline nimmt (ByPropertyName, mehr dazu in Lektion PS.1.2) und welche Aliase er hat (ProcessName). Auf diesem Rechner stehen die Bezeichner auf Deutsch („Erforderlich?“ falsch), auf einem englischen System als „Required? false“.

Aus der Position folgt: Ein Parameter mit Position 0 darf ohne Namen stehen. Die beiden Zeilen sind gleichbedeutend:

PowerShell
Get-Process -Name pwsh
Get-Process pwsh

Im Skript schreiben Sie den Namen immer aus, weil der Leser sonst raten muss. Auf der Kommandozeile tippen Sie das Kurze.

Eine dritte Art sind Schalter (switch parameters): Sie haben keinen Wert. Sie sind da oder nicht da. -Recurse bei Get-ChildItem sagt „auch in Unterordnern“. Wichtige Schalter begegnen Ihnen in Lektion PS.3.1 wieder: -WhatIf und -Confirm sind Schalter.

Welche Parameter ein Cmdlet überhaupt hat, zeigt:

PowerShell
(Get-Command Get-Process).Parameters.Keys | Select-Object -First 6
Name
Id
InputObject
IncludeUserName
Module
FileVersionInfo

Die ersten sechs von vielen. Zusätzlich bekommt jedes Cmdlet die allgemeinen Parameter (-Verbose, -ErrorAction, -WhatIf bei Cmdlets, die etwas ändern, und weitere), die wir in den nächsten Lektionen einzeln einführen.

Tab-Ergänzung: Tippen Sie Get-Pro und drücken Sie Tab: PowerShell ergänzt Get-Process. Tippen Sie Get-Process -N und Tab: -Name. Tab zeigt auch bei Parameterwerten die zulässigen Werte, wenn es nur wenige gibt. Wer Tab nutzt, tippt weniger und macht weniger Tippfehler.

Die Hilfe

Get-Help zeigt die Hilfe zu einem Befehl: Syntax, Beschreibung, Parameter, Beispiele. Die gebräuchlichen Formen:

PowerShell
Get-Help Get-ChildItem
Get-Help Get-ChildItem -Examples
Get-Help Get-ChildItem -Full
Get-Help Get-ChildItem -Online

-Examples zeigt nur die Beispiele (der schnellste Weg, ein Cmdlet zu verstehen), -Full alles, -Online öffnet die Seite auf Learn im Browser. Mit einem Muster statt eines Befehlsnamens durchsucht Get-Help auch die Themenartikel, die about_-Hilfen (Get-Help about_Pipelines).

Die Hilfedateien liegen nicht fest in PowerShell, sie werden mit Update-Help nachgeladen (das braucht Netzzugang; für welche Konten es gilt und welche Rechte es braucht, steht in der Hilfe zu Update-Help). Fehlt die Hilfe, zeigt Get-Help nur die Syntax. Die Seiten auf Learn sind in beiden Fällen die vollständige Fassung.

Aliase

Ein Alias ist ein Kurzname für einen Befehl:

PowerShell
Get-Alias ls
Get-Command -Name gci | Select-Object Name, CommandType, Definition | Format-List
Name Definition
---- ----------
ls   Get-ChildItem

Name        : gci
CommandType : Alias
Definition  : Get-ChildItem

Hier sehen Sie, dass ls und gci beide für Get-ChildItem stehen. Auf der Kommandozeile sind Aliase bequem. In Skripten stehen sie nie, aus drei Gründen:

  1. Sie sind für Leser schwer zu lesen (gci, %, ?), und ein Skript wird öfter gelesen als geschrieben.
  2. Ein Alias kann auf einem anderen Rechner fehlen oder etwas anderes bedeuten, denn jeder kann eigene anlegen (zum Beispiel im Profil).
  3. Der Analyzer, der Skripte prüft (Lektion PS.4.2), warnt vor Aliasen.

Das Werkzeug der Wahl ist: auf der Kommandozeile Tab-Ergänzung und kurze Namen, im Skript der volle Name.

Das Profil und der Editor

Beim Start liest pwsh ein Profil: ein Skript, das Sie selbst anlegen und das Ihre Gewohnheiten setzt (Aliase, Farben, Funktionen). Den Pfad nennt die Variable $PROFILE. Learn beschreibt, dass jede PowerShell-Version ihr eigenes Profil hat, das Profil von Windows PowerShell 5.1 gilt also nicht für pwsh. Ein Profil ist nur für die interaktive Arbeit: Skripte, die Sie anderen geben oder automatisch laufen lassen, dürfen nie davon abhängen. Starten Sie pwsh mit -NoProfile, um das Profil zu überspringen, und tun Sie das in jedem automatischen Aufruf (pwsh -NoProfile -File …). Den Rest des Kurses nutzen die Beispiele so.

Als Editor eignet sich Visual Studio Code mit der PowerShell-Erweiterung: Sie bekommt Tab-Ergänzung, Hilfe beim Tippen und einen Debugger. Ein Terminal, das PowerShell gut darstellt (Windows Terminal unter Windows), erspart Ihnen Ärger mit Umlauten und Farben.

Übung 1: Die Sitzung erkunden

  1. Starten Sie pwsh und lesen Sie $PSVersionTable.PSVersion und $PSVersionTable.PSEdition. Ist Windows PowerShell 5.1 installiert, starten Sie powershell.exe und vergleichen Sie.
  2. Finden Sie alle Cmdlets, deren Nomen mit Item endet (Get-Command -Noun *Item).
  3. Wie viele Parameter hat Get-Date? Tipp: (Get-Command Get-Date).Parameters.Count.

Lösung 1

  1. Bei PowerShell 7 steht dort 7.x.y und Core, bei Windows PowerShell 5.1.… und Desktop.
  2. Get-Command -Noun *Item listet unter anderem Get-Item, New-Item, Remove-Item, Copy-Item und Move-Item (auf dem Rechner dieses Kurses auch einige Cmdlets anderer Module, etwa Get-ControlPanelItem): Gleiche Nomen, verschiedene Verben, so lernen Sie ganze Familien auf einmal.
  3. Die Zahl hängt von der Version ab und enthält die allgemeinen Parameter (hier 25). Wichtig ist der Weg: .Parameters ist eine Sammlung, .Count zählt sie.

Übung 2: Hilfe lesen

  1. Rufen Sie Get-Help Get-ChildItem -Examples auf. Welches Beispiel zeigt, wie Sie nur Dateien einer bestimmten Endung finden?
  2. Welche Position hat der Parameter -Path von Get-ChildItem, und aus welcher Quelle nimmt er Pipeline-Eingaben? (Get-Help Get-ChildItem -Parameter Path)
  3. Warum ist gci -r -fo für eine Skriptdatei eine schlechte Schreibweise, und wie lautet die gute?

Lösung 2

  1. Das Beispiel, das -Filter oder -Include mit *.txt zeigt (die Beispiele sind nummeriert und beschrieben; die Nummern ändern sich zwischen Versionen).
  2. -Path hat Position 0 und nimmt Pipeline-Eingaben nach Wert und nach Eigenschaftsname (ByValue, ByPropertyName); so läuft die Hilfe auf diesem Rechner, die Bezeichner sind dort deutsch.
  3. gci ist ein Alias, -r und -fo sind abgekürzte Parameter (-Recurse, -Force); beides liest sich schlecht und kann bei neuen Parametern mehrdeutig werden. Gut: Get-ChildItem -Recurse -Force.

Übung 3: Zwei Programme vergleichen

  1. Führen Sie Get-Command Get-ChildItem | Select-Object CommandType, Source einmal in pwsh und einmal (wenn vorhanden) in powershell.exe aus.
  2. Schreiben Sie ein Skript version.ps1 mit der Zeile #Requires -Version 7.0 und einer Zeile $PSVersionTable.PSVersion.ToString(). Starten Sie es mit pwsh -NoProfile -File .\version.ps1 und mit powershell.exe -NoProfile -File .\version.ps1. Was passiert, und was sagt der Exit-Code ($LASTEXITCODE)?

Lösung 3

  1. Beide liefern Cmdlet und ein Modul; die Quelle kann abweichen (Microsoft.PowerShell.Management). Wichtig ist: Gleicher Name, aber zwei verschiedene Programme dahinter.
  2. In pwsh gibt das Skript die Version aus. In Windows PowerShell 5.1 bricht es mit einer Meldung ab, dass die #requires-Anweisung für Version 7.0 nicht zur laufenden Version 5.1 passt, und $LASTEXITCODE ist 1. Die Prüfung spart Ihnen ein halbes Skript, das in der falschen Version halb läuft. (Der genaue Text der Meldung hängt von der Sprache des Systems ab. Lesen Sie den Exit-Code, ohne den Befehl durch Select-Object -First zu schicken: Warum, steht in Lektion PS.2.3.)

Was Sie jetzt können

  • Sie unterscheiden pwsh (PowerShell 7) und powershell.exe (Windows PowerShell 5.1) und lesen die Version aus $PSVersionTable.
  • Sie lesen einen Befehl als Verb-Nomen mit Parametern, kennen Name, Position und Schalter.
  • Sie finden Befehle mit Get-Command und Hilfe mit Get-Help -Examples.
  • Sie erkennen Aliase und schreiben in Skripten die vollen Namen.
  • Sie starten Automatisierungen mit -NoProfile, damit sie nicht von Ihrem Profil abhängen.

Die nächste Lektion zeigt, was ein Befehl eigentlich zurückgibt: keine Zeilen Text, sondern Objekte. Das ändert alles.

Weiterlesen