Erstellen von Modulen in Windows PowerShell-Skripts
Sie können Module erstellen, um Funktionen zu speichern und diese Funktionen in verschiedenen Skripts zu verwenden. Nachdem Sie Ihre Funktionen in Module eingefügt haben, sind sie genauso auffindbar wie Cmdlets. Wie die integrierten Windows Module werden Ihre Module auch automatisch geladen, wenn eine Funktion erforderlich ist.
Hinweis
Benennen Sie Ihre Funktionen in Modulen mit derselben Verb-Nomen-Benennungskonvention wie Cmdlets. Verwenden Sie z. B. das Verb-Substantiv-Format.
Hinweis
Funktionen in Modulen können kommentarbasierte Hilfe enthalten, die Get-Help ermitteln kann. Fügen Sie die Hilfeinformationen in jede Funktion ein, um dies zu aktivieren.
Wenn Sie Ihre Funktionen bereits in einer Windows PowerShell-Skriptdatei haben, konvertieren Sie sie in ein Modul, indem Sie sie mit der Dateierweiterung .psm1 umbenennen. Die Dateistruktur muss nicht geändert werden.
Windows PowerShell verwendet die Umgebungsvariable $PSModulePath, um die Pfade zu definieren, aus denen Module geladen werden. In Windows PowerShell 5.1 werden die folgenden Pfade aufgelistet:
- C:\Users\UserID\Documents\WindowsPowerShell\Modules
- C:\Programme\WindowsPowerShell\Modules
- C:\Windows\System32\WindowsPowerShell\1.0\Modules
Windows PowerShell 7 enthält die folgenden anderen Pfade:
- C:\Users\UserID\Documents\PowerShell\Modules
- C:\Programme\PowerShell\Modules
- C:\Programme\PowerShell\7\Modules
Hinweis
Der PowerShell 7-Benutzerbereichspfad (Documents\PowerShell\Modules) unterscheidet sich vom Windows PowerShell 5.1-Benutzerbereichspfad (Documents\WindowsPowerShell\Modules). Module, die im 5.1-Pfad gespeichert sind, werden nicht automatisch in benutzerspezifischen PS7-Sitzungen geladen.
Hinweis
Wenn Sie Module in C:\Users\UserID\Documents\WindowsPowerShell\Modules speichern, sind diese nur für einen einzelnen Benutzer verfügbar.
Module werden nicht direkt im Modulverzeichnis platziert. Vielmehr müssen Sie einen Unterordner mit demselben Namen wie die Datei erstellen und die Datei in diesem Ordner speichern. Wenn Sie beispielsweise über ein Modul namens "AdatumFunctions.psm1" verfügen, platzieren Sie es in "C:\Programme\WindowsPowerShell\Modules\AdatumFunctions".