Bis jetzt haben Sie Befehle benutzt und kleine Skripte geschrieben. Ab hier schreiben Sie Bausteine, die andere (und Sie selbst in drei Monaten) benutzen
wollen: Funktionen, die sich wie die Cmdlets von PowerShell verhalten. Das heißt: Sie prüfen ihre Eingaben, sie nehmen Werte aus der Pipeline, sie geben
Objekte zurück, sie reden bei Bedarf mit -Verbose, und ihre Fehler lassen sich fangen. Alles, was Lektion PS.3.1 über -WhatIf lehrt, setzt genau diese Form voraus.
Alle Beispiele dieser Lektion wurden mit PowerShell 7.6.9 auf Windows 11 ausgeführt; die gezeigte Ausgabe stammt aus diesem Lauf. Die Fehlermeldungen von PowerShell erscheinen in der Sprache des Systems; hier sind sie deutsch.
Eine einfache Funktion und ihre Grenze
Eine Funktion ohne weitere Angaben ist ein Block mit Namen. Parameter stehen in param(...):
function Get-Greeting {
param([string] $Name = 'world')
"Hello, $Name"
}
Get-Greeting -Name 'Nordlicht'
Sie funktioniert, aber sie ist noch kein Cmdlet: Sie kennt kein -Verbose, kein -ErrorAction und kein -WhatIf. Der Unterschied ist ein einziges Attribut.