Manifest

Ein PowerShell-Manifest (.psd1) ist im Grunde nur eine Hashtable mit vordefinierten Keys. Es enthält die Metadaten und Konfiguration zu deinem Modul – also alles, was PowerShell über dein Modul wissen muss, ohne den eigentlichen Code auszuführen. Deshalb liegt es bewusst in einer eigenen Datei, getrennt vom Modul selbst.

Grundlegende Metadaten

Das ist die Identität deines Moduls. Ohne das bist du einfach nur irgendein Skript mit Existenzkrise.

RootModule

RootModule – Hauptdatei (.psm1 oder .dll)
ModuleVersion – Version (z. B. 1.0.0)
GUID – Eindeutige ID
Author – Ersteller/Entwickler des Moduls
CompanyName – Unternehmen
Copyright – Wem gehören die Urheberrechte
Description – Beschreibung des Moduls

🔗 Abhängigkeiten

Hier sagst du: „Ich funktioniere nicht alleine, ich brauche andere.“

RequiredModules
→ Externe Abhängigkeiten
→ Angabe über Modulnamen (PowerShell sucht es selbst)
→ Müssen im System vorhanden sein (installiert / auffindbar, z.B. über $PSModulePath)
→ Gehören nicht zu deinem Modul
RequiredAssemblies – DLLs
ScriptsToProcess – Skripte, die beim Laden ausgeführt werden
ModuleList – Nur die Meta-Information welche andere Module zugehörig sind
NestedModules
→ Angabe über Dateien/Pfade (du sagst konkret, was geladen wird)
→ Interne Bausteine deines Moduls
→ Werden zusammen mit deinem Modul geladen
→ Gehören zu deinem Modul dazu

🚀 Export (was nach außen sichtbar ist)

Das ist der Teil, wo du entscheidest, was du der Welt zeigst. Oder versteckst.

FunctionsToExport
CmdletsToExport
VariablesToExport
AliasesToExport

👉 Klassiker:
'*' = alles exportieren
oder explizit = bessere Kontrolle

🧠 Kompatibilität & Anforderungen

Hier wird’s picky.

PowerShellVersion
PowerShellHostName
PowerShellHostVersion
DotNetFrameworkVersion
CLRVersion
ProcessorArchitecture

📦 Private Daten (der geheime Keller)

Alles, was du selbst definierst.

PrivateData – Hashtable für eigene Infos

Beispiel:

PrivateData = @{
    PSData = @{
        Tags = @('UI','Forms')
        ProjectUri = 'https://...'
    }
}

🌐 PSData (wichtig für Gallery etc.)

Teil von PrivateData, aber so wichtig, dass es eigentlich sein eigenes Ding ist.

Tags
LicenseUri
ProjectUri
IconUri
ReleaseNotes

🧩 Sonstiges (der „Warum gibt’s das?“ Bereich)

Selten gebraucht, aber existiert halt:

FileList
TypesToProcess
FormatsToProcess
CompatiblePSEditions (Desktop, Core)
HelpInfoURI

🔧 Mini-Beispiel

Damit du nicht nur trockene Theorie hast:

@{
    RootModule        = 'MeinModul.psm1'
    ModuleVersion     = '1.0.0'
    GUID              = '12345678-abcd-1234-abcd-1234567890ab'
    Author            = 'Jonny'
    Description       = 'Mein erstes Modul'

    FunctionsToExport = @('Get-Thing', 'Set-Thing')

    PowerShellVersion = '5.1'

    PrivateData = @{
        PSData = @{
            Tags = @('Example','Test')
        }
    }
}

Der eigentliche Punkt (den viele übersehen)

Du brauchst vielleicht 30% davon wirklich.

Der Rest ist:

entweder für Publishing
oder für Leute, die Kontrolle lieben (oder Angst haben)

Wenn du lokal entwickelst:
→ RootModule, ModuleVersion, FunctionsToExport
→ fertig, läuft.