Dieses Cmdlet aktualisiert die in einer Modulmanifestdatei gespeicherten Daten. Mit den Parametern können Sie angeben, welche Eigenschaften aktualisiert werden.
Update-PSModuleManifest überschreibt alle vorhandenen Werte im Modulmanifest.
Das Cmdlet gibt kein Objekt zurück.
Beispiele
Beispiel 1
In diesem Beispiel wird die eigenschaft Author im Modulmanifest in New Authorgeändert.
Gibt die Formatierungsdateien (.ps1xml) an, die beim Importieren des Moduls verarbeitet werden.
Wenn Sie ein Modul importieren, führt PowerShell das cmdlet Update-FormatData mit den angegebenen Dateien aus.
Da Formatierungsdateien keinen Bereich haben, wirken sie sich auf alle Zustände in der Sitzung aus.
Gibt ein Array von Modulen an, die im Modul enthalten sind.
Geben Sie jeden Modulnamen als Zeichenfolge oder als Hashtable mit ModuleName- und ModuleVersion--Schlüssel ein.
Die Hashtabelle kann auch über einen optionalen GUID--Schlüssel verfügen. Sie können Zeichenfolgen und Hashtables im Parameterwert kombinieren.
Dieser Schlüssel ist als Modulinventar konzipiert.
Gibt Skriptmodule (.psm1) und binäre Module (.dll) an, die in den Sitzungszustand des Moduls importiert werden. Die Dateien in den NestedModules Schlüssel werden in der Reihenfolge ausgeführt, in der sie aufgelistet sind.
Geben Sie jeden Modulnamen als Zeichenfolge oder als Hashtable mit ModuleName- und ModuleVersion--Schlüssel ein.
Die Hashtabelle kann auch über einen optionalen GUID--Schlüssel verfügen. Sie können Zeichenfolgen und Hashtables im Parameterwert kombinieren.
Gibt den Namen des PowerShell-Hostprogramms an, das das Modul benötigt. Geben Sie den Namen des Hostprogramms ein, z. B. PowerShell ISE-Host oder ConsoleHost. Wildcards sind nicht zulässig.
Der Name eines Hostprogramms wird in $Host.Namegespeichert.
Gibt den Vorabversionswert an, der an die Modulversion angefügt wird. Wenn z. B. Prerelease-preview ist und die ModuleVersion-1.0.0ist, wird die Version des Moduls 1.0.0-preview.
Gibt Daten an, die beim Importieren an das Modul übergeben werden. Dabei kann es sich um beliebige Werte handeln, die in einer Hashtabelle gespeichert sind.
Gibt die Assemblydateien (.dll) an, die vom Modul benötigt werden. PowerShell lädt die angegebenen Assemblys, bevor Typen oder Formate aktualisiert, geschachtelte Module importiert oder die im RootModule Schlüssel angegebene Moduldatei importiert werden.
Verwenden Sie RequiredAssemblies- für Assemblys, die geladen werden müssen, um formatierungs- oder Typdateien zu aktualisieren, die im FormatsToProcess-- oder TypesToProcess- Schlüssel aufgelistet sind, auch wenn diese Assemblys auch im NestedModules Schlüssel aufgeführt sind.
Gibt Module an, die sich im globalen Sitzungszustand befinden müssen. Wenn sich die erforderlichen Module nicht im globalen Sitzungszustand befinden, importiert PowerShell sie. Wenn die erforderlichen Module nicht verfügbar sind, schlägt der Befehl Import-Module fehl.
Der Wert kann ein Array sein, das Modulnamen oder Modulspezifikationen enthält. Eine Modulspezifikation ist eine Hashtabelle mit den folgenden Schlüsseln.
ModuleName
-
Erforderlicher Gibt den Modulnamen an.
GUID
-
Optionaler Gibt die GUID des Moduls an.
Außerdem Erforderlicher, um mindestens einen der drei folgenden Tasten anzugeben.
ModuleVersion – Gibt eine akzeptable Mindestversion des Moduls an.
MaximumVersion – Gibt die maximal zulässige Version des Moduls an.
RequiredVersion – Gibt eine genaue, erforderliche Version des Moduls an. Dies kann nicht mit den anderen Versionsschlüsseln verwendet werden.
Gibt die primäre oder Stammdatei des Moduls an. Geben Sie den Dateinamen eines Skripts (.ps1), ein Skriptmodul (.psm1), ein Modulmanifest (.psd1), eine Assembly (.dll) oder eine XML-Cmdlet-Definitionsdatei (.cdxml) ein. Wenn das Modul importiert wird, werden die aus dem Stammmodul exportierten Elemente in den Sitzungszustand des Aufrufers importiert.
Wenn ein Modul über eine Manifestdatei verfügt und keine Datei im RootModule Schlüssel angegeben wird, wird das Manifest zur primären Datei für das Modul. Das Modul wird als Manifestmodul (ModuleType =
Manifest) bezeichnet.
Um Member aus .psm1- oder .dll-Dateien zu exportieren, müssen die Namen dieser Dateien in den Werten der RootModule- oder NestedModules Schlüssel im Manifest angegeben werden.
Gibt Skriptdateien (.ps1) an, die beim Importieren des Moduls im Sitzungszustand des Aufrufers ausgeführt werden.
Sie können diese Skripts verwenden, um eine Umgebung vorzubereiten, genauso wie Sie ein Anmeldeskript verwenden können.
Um Skripts anzugeben, die im Sitzungszustand des Moduls ausgeführt werden, verwenden Sie die NestedModules Schlüssel.
Gibt die Typdateien (.ps1xml) an, die beim Importieren des Moduls ausgeführt werden.
Wenn Sie das Modul importieren, führt PowerShell das cmdlet Update-TypeData mit den angegebenen Dateien aus.
Da Typdateien keinen Geltungsbereich haben, wirken sie sich auf alle Sitzungszustände in der Sitzung aus.
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
