Cmdlets: Verben, Substantive, Get-Help

In L1 hast du den ersten Cmdlet-Aufruf gesehen: Get-Process. Das hieß so weil PowerShell-Befehle einer strengen Konvention folgen – dem Verb-Substantiv-Schema. Diese eine Regel ist der Grund warum PowerShell-Code so lesbar ist: jedes Cmdlet sagt dir auf Anhieb was es tut.

In dieser Lektion lernst du das System dahinter – und vor allem das wichtigste Werkzeug überhaupt: Get-Help. Mit Hilfe kommst du auch ohne Auswendiglernen weiter, denn es gibt mehrere tausend Cmdlets. Niemand kennt sie alle – aber wer das Schema kennt, kann sie alle finden.

1) Cmdlet-Aufbau: Verb-Substantiv

Ein Cmdlet (gesprochen „Command-Let") besteht immer aus zwei Teilen, durch Bindestrich getrennt: Verb-Substantiv. Das Verb sagt was getan wird, das Substantiv womit. So entstehen Befehle wie ganze deutsche Sätze – probier es:

2) Die zugelassenen Verben

Microsoft hat eine Liste „erlaubter" Verben definiert, die in Cmdlets vorkommen dürfen. Damit bleibt die Sprache konsistent: niemand soll mal Fetch-Process und mal Retrieve-Process schreiben. Es gibt rund 100 zugelassene Verben in 5 Kategorien. Die wichtigsten:

3) Parameter: das Wie

Jedes Cmdlet hat Parameter die seine Funktion verfeinern. Sie haben einen Namen und werden mit Bindestrich davor angegeben:

PowerShell-Parameter sind case-insensitive: -Name, -name, -NAME sind alle gleich. Aber Konvention ist PascalCase (jedes Wort groß). Außerdem reicht ein eindeutiges Präfix: Get-Process -N chrome funktioniert auch (kurz für -Name). Praktisch beim interaktiven Tippen, aber in Skripten sollte man immer ausgeschrieben – sonst bricht's wenn ein neuer Parameter mit gleichem Anfangsbuchstaben dazukommt.

4) Wichtige Standardparameter: Common Parameters

Es gibt Parameter die jedes Cmdlet versteht – die sogenannten Common Parameters:

5) Get-Help – dein wichtigstes Cmdlet

Niemand kennt alle Cmdlets auswendig – und das musst du auch nicht. PowerShell hat ein eingebautes, ausgezeichnetes Hilfesystem. Get-Help liefert Doku zu jedem Cmdlet, mit verschiedenen Detailstufen:

6) Cmdlets finden mit Get-Command

Du weißt nicht wie ein bestimmtes Cmdlet heißt? Get-Command ist der Cmdlet-Finder. Verstehe es als „Suchmaschine für Befehle":

Das Discovery-Pattern: Get-Command -Noun Service findet ALLE Service-bezogenen Cmdlets – Get-Service, Set-Service, Start-Service, Stop-Service, Restart-Service, New-Service. Schon weißt du was du mit Services machen kannst, ohne irgendwas auswendig zu lernen.

7) Aliase: Kurzformen für die Konsole

Viele Cmdlets haben einen Alias – einen kurzen Namen. Praktisch für die interaktive Konsole, weniger gut für Skripte (weniger lesbar). Manche Aliase kommen aus der cmd-Welt (dir, cd), andere aus Bash (ls, cp):

8) Tab-Completion und IntelliSense

Die PowerShell-Konsole hat eine sehr gute Tab-Vervollständigung. Das macht das interaktive Arbeiten viel angenehmer:

• Get-Pro + Tab → vervollständigt zu Get-Process
• Get-Process - + Tab → zeigt alle Parameter (-Name, -Id, ...)
• Get-Service -Name + Tab → bei manchen Cmdlets auch Werte! Zeigt verfügbare Service-Namen.
• Strg+Leertaste → zeigt alle möglichen Vervollständigungen als Menü (statt nur zu cyclen)
• In VS Code mit PowerShell-Extension: IntelliSense – Code-Completion mit Doku-Vorschau direkt beim Tippen

Das ist ein riesiger Produktivitätsgewinn. Du musst nie ganze Cmdlet-Namen tippen, nie die exakte Parameter-Schreibweise nachschlagen. Selbst wenn du den Namen nur ungefähr weißt: Tab führt dich hin.

9) Häufige Fallstricke

Drei Anfänger-Fehler die du vermeiden solltest:

• Parameter-Werte nicht quoten wenn Leerzeichen drin sind: Get-Item C:\Mein Ordner bricht zusammen. Mit Anführungszeichen: Get-Item "C:\Mein Ordner". PowerShell ist da strikter als Bash mit doppelten Anführungszeichen.
• Verwechslung von Pipeline-Output und Variablen-Zuweisung: Get-Process > datei.txt schreibt FORMATIERTEN Text in die Datei (wie er im Terminal aussehen würde). Wenn du Objekte speichern willst: Get-Process | Export-Csv datei.csv oder als Variable $ps = Get-Process. Mehr in L3.
• Verwechslung von = und -eq: In PowerShell ist = für Zuweisung, -eq für Vergleich (wie in Bash = vs. -eq in [...]). Mehr dazu in L4.

10) Vom Anfänger zum Selbst-Helfer

Wenn dich jemand fragt „wie liste ich auf einem Windows-Server die letzten 10 fehlgeschlagenen Logins?" und du es nicht weißt – kein Problem. So gehst du vor:

1. Verb-Substantiv erraten: vielleicht Get-EventLog? Oder Get-WinEvent?
2. Get-Command: Get-Command *Event* → zeigt alle Event-bezogenen Cmdlets
3. Get-Help -Examples: Get-Help Get-WinEvent -Examples → typische Aufrufe
4. Microsoft Learn online: Get-Help Get-WinEvent -Online → ausführliche Doku
5. Experimentieren: erst mit kleiner Anzahl, mit -MaxEvents 5, dann skalieren

Das ist das eigentliche „PowerShell-Können": nicht alle Cmdlets im Kopf, sondern die Methodik zum Selbst-Helfen. Mehr ist gar nicht nötig. Selbst erfahrene Admins schlagen täglich Sachen nach – das ist normal.

Zusammenfassung

Cmdlets folgen dem Verb-Substantiv-Schema: Get-Process, Stop-Service, New-ADUser. Erlaubte Verben siehe Get-Verb. Parameter mit Bindestrich: -Name, -Path, -Force. Switch-Parameter (ohne Wert): -Recurse, -Force, -Confirm. Common Parameters auf jedem Cmdlet: -WhatIf (Trockenlauf, GOLDEN!), -Verbose, -ErrorAction. Get-Help ist das wichtigste Cmdlet: -Examples für Beispiele, -Full für Details, -Online für Microsoft Learn. Get-Command findet Cmdlets: -Verb, -Noun, mit Wildcards. Aliase wie ls, dir, ?, % sind ok in der Konsole – in Skripten lange Namen nutzen. Tab-Completion und VS-Code-IntelliSense beschleunigen alles massiv. Methodik wichtiger als Auswendiglernen: erraten → Get-Command → Get-Help -Examples → ausprobieren.