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 Windowspwsh.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:
$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:
#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:
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:
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:
(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:
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:
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:
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:
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:
(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:
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:
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:
- Sie sind für Leser schwer zu lesen (
gci,%,?), und ein Skript wird öfter gelesen als geschrieben. - Ein Alias kann auf einem anderen Rechner fehlen oder etwas anderes bedeuten, denn jeder kann eigene anlegen (zum Beispiel im Profil).
- 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
- Starten Sie
pwshund lesen Sie$PSVersionTable.PSVersionund$PSVersionTable.PSEdition. Ist Windows PowerShell 5.1 installiert, starten Siepowershell.exeund vergleichen Sie. - Finden Sie alle Cmdlets, deren Nomen mit
Itemendet (Get-Command -Noun *Item). - Wie viele Parameter hat
Get-Date? Tipp:(Get-Command Get-Date).Parameters.Count.
Lösung 1
- Bei PowerShell 7 steht dort
7.x.yundCore, bei Windows PowerShell5.1.…undDesktop. Get-Command -Noun *Itemlistet unter anderemGet-Item,New-Item,Remove-Item,Copy-ItemundMove-Item(auf dem Rechner dieses Kurses auch einige Cmdlets anderer Module, etwaGet-ControlPanelItem): Gleiche Nomen, verschiedene Verben, so lernen Sie ganze Familien auf einmal.- Die Zahl hängt von der Version ab und enthält die allgemeinen Parameter (hier 25). Wichtig ist der Weg:
.Parametersist eine Sammlung,.Countzählt sie.
Übung 2: Hilfe lesen
- Rufen Sie
Get-Help Get-ChildItem -Examplesauf. Welches Beispiel zeigt, wie Sie nur Dateien einer bestimmten Endung finden? - Welche Position hat der Parameter
-PathvonGet-ChildItem, und aus welcher Quelle nimmt er Pipeline-Eingaben? (Get-Help Get-ChildItem -Parameter Path) - Warum ist
gci -r -fofür eine Skriptdatei eine schlechte Schreibweise, und wie lautet die gute?
Lösung 2
- Das Beispiel, das
-Filteroder-Includemit*.txtzeigt (die Beispiele sind nummeriert und beschrieben; die Nummern ändern sich zwischen Versionen). -Pathhat 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.gciist ein Alias,-rund-fosind 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
- Führen Sie
Get-Command Get-ChildItem | Select-Object CommandType, Sourceeinmal inpwshund einmal (wenn vorhanden) inpowershell.exeaus. - Schreiben Sie ein Skript
version.ps1mit der Zeile#Requires -Version 7.0und einer Zeile$PSVersionTable.PSVersion.ToString(). Starten Sie es mitpwsh -NoProfile -File .\version.ps1und mitpowershell.exe -NoProfile -File .\version.ps1. Was passiert, und was sagt der Exit-Code ($LASTEXITCODE)?
Lösung 3
- Beide liefern
Cmdletund ein Modul; die Quelle kann abweichen (Microsoft.PowerShell.Management). Wichtig ist: Gleicher Name, aber zwei verschiedene Programme dahinter. - In
pwshgibt 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$LASTEXITCODEist 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 durchSelect-Object -Firstzu schicken: Warum, steht in Lektion PS.2.3.)
Was Sie jetzt können
- Sie unterscheiden
pwsh(PowerShell 7) undpowershell.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-Commandund Hilfe mitGet-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.