Update-PSModuleManifest
Aktualisiert eine Modulmanifestdatei
Syntax
Update-PSModuleManifest
[-Path] <String>
[-NestedModules <Object[]>]
[-Guid <Guid>]
[-Author <String>]
[-CompanyName <String>]
[-Copyright <String>]
[-RootModule <String>]
[-ModuleVersion <Version>]
[-Description <String>]
[-ProcessorArchitecture <ProcessorArchitecture>]
[-CompatiblePSEditions <String[]>]
[-PowerShellVersion <Version>]
[-ClrVersion <Version>]
[-DotNetFrameworkVersion <Version>]
[-PowerShellHostName <String>]
[-PowerShellHostVersion <Version>]
[-RequiredModules <Object[]>]
[-TypesToProcess <String[]>]
[-FormatsToProcess <String[]>]
[-ScriptsToProcess <String[]>]
[-RequiredAssemblies <String[]>]
[-FileList <String[]>]
[-ModuleList <Object[]>]
[-FunctionsToExport <String[]>]
[-AliasesToExport <String[]>]
[-VariablesToExport <String[]>]
[-CmdletsToExport <String[]>]
[-DscResourcesToExport <String[]>]
[-Tags <String[]>]
[-ProjectUri <Uri>]
[-LicenseUri <Uri>]
[-IconUri <Uri>]
[-ReleaseNotes <String>]
[-Prerelease <String>]
[-HelpInfoUri <Uri>]
[-DefaultCommandPrefix <String>]
[-ExternalModuleDependencies <String[]>]
[-RequireLicenseAcceptance]
[-PrivateData <Hashtable>]
[<CommonParameters>]
Beschreibung
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 Author-Eigenschaft im Modulmanifest in geändert New Author
.
Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Author 'New Author'
Beispiel 2
In diesem Beispiel wird die Prerelease-Eigenschaft in geändert beta2
.
Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Prerelease 'beta2'
Beispiel 3
In diesem Beispiel werden mehrere Eigenschaften aktualisiert.
$parameters = @{
Path = 'C:\MyModules\TestModule'
Tags = 'Windows', 'Linux'
Description = 'A module for managing packages.'
}
Update-PSModuleManifest
Parameter
-AliasesToExport
Gibt die Aliase an, die das Modul exportiert. Platzhalter sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Author
Gibt den Autor des Moduls an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClrVersion
Gibt die Mindestversion der Common Language Runtime (CLR) der Microsoft-.NET Framework an, die für das Modul erforderlich ist.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CmdletsToExport
Gibt die Cmdlets an, die das Modul exportiert. Platzhalter sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-CompanyName
Gibt das Unternehmen oder den Anbieter an, der das Modul erstellt hat.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CompatiblePSEditions
Gibt die kompatiblen PSEditionen des Moduls an. Informationen zu PSEdition finden Sie unter Module mit kompatiblen PowerShell-Editionen.
Type: | String[] |
Accepted values: | Desktop, Core |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Copyright
Gibt eine Urheberrechtserklärung für das Modul an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultCommandPrefix
Gibt das Standardbefehlspräfix an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Gibt eine Beschreibung des Moduls an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DotNetFrameworkVersion
Gibt die Mindestversion der Microsoft-.NET Framework an, die für das Modul erforderlich ist.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DscResourcesToExport
Gibt die Desired State Configuration (DSC)-Ressourcen an, die das Modul exportiert. Platzhalter sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ExternalModuleDependencies
Gibt ein Array externer Modulabhängigkeiten an.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FileList
Gibt alle Elemente an, die im Modul enthalten sind.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FormatsToProcess
Gibt die Formatierungsdateien (.ps1xml
) an, die beim Importieren des Moduls verarbeitet werden.
Wenn Sie ein Modul importieren, führt PowerShell das Update-FormatData
Cmdlet mit den angegebenen Dateien aus.
Da Formatierungsdateien keinen Bereich haben, wirken sie sich auf alle Sitzungszustände in der Sitzung aus.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FunctionsToExport
Gibt die Funktionen an, die das Modul exportiert. Platzhalter sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Guid
Gibt einen eindeutigen Bezeichner für das Modul an. Die GUID wird verwendet, um zwischen Modulen mit demselben Namen zu unterscheiden.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HelpInfoUri
Gibt die Internetadresse der Xml-Datei HelpInfo des Moduls an. Geben Sie einen URI (Uniform Resource Identifier) ein, der mit http:
oder https:
beginnt.
Weitere Informationen finden Sie unter Aktualisierbare Hilfe.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IconUri
Gibt den URI eines Symbols für das Modul an. Das angegebene Symbol wird auf der Katalogwebseite für das Modul angezeigt.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseUri
Gibt die URL der Lizenzbedingungen für das Modul an.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModuleList
Gibt ein Array von Modulen an, die im Modul enthalten sind.
Geben Sie jeden Modulnamen als Zeichenfolge oder als Hashtabelle mit den Schlüsseln ModuleName und ModuleVersion ein. Die Hashtabelle kann auch über einen optionalen GUID-Schlüssel verfügen. Sie können Zeichenfolgen und Hashtabellen im Parameterwert kombinieren.
Dieser Schlüssel ist als Modulinventar konzipiert.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModuleVersion
Gibt die Version des Moduls an.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NestedModules
Gibt Skriptmodule (.psm1
) und binäre Module (.dll
) an, die in den Sitzungszustand des Moduls importiert werden. Die Dateien im Schlüssel NestedModules werden in der Reihenfolge ausgeführt, in der sie aufgelistet sind.
Geben Sie jeden Modulnamen als Zeichenfolge oder als Hashtabelle mit den Schlüsseln ModuleName und ModuleVersion ein. Die Hashtabelle kann auch über einen optionalen GUID-Schlüssel verfügen. Sie können Zeichenfolgen und Hashtabellen im Parameterwert kombinieren.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Gibt den Pfad und Dateinamen des Modulmanifests an. Geben Sie den Dateinamen mit einer Dateierweiterung ein .psd1
.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PowerShellHostName
Gibt den Namen des PowerShell-Hostprogramms an, das für das Modul erforderlich ist. 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.Name
gespeichert.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PowerShellHostVersion
Gibt die Mindestversion des PowerShell-Hostprogramms an, das mit dem Modul funktioniert. Geben Sie eine Versionsnummer an, z. B. 1.1.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PowerShellVersion
Gibt die Mindestversion von PowerShell an, die mit diesem Modul funktioniert. Sie können beispielsweise Versionen wie 5.1
oder 7.2
angeben.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Prerelease
Gibt den Vorabversionswert an, der an die Modulversion angefügt wird. Wenn z. B. die Vorabversion ist preview
und die ModuleVersion den Wert hat 1.0.0
, lautet 1.0.0-preview
die Version des Moduls .
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateData
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.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProcessorArchitecture
Gibt die Prozessorarchitektur an, die das Modul erfordert.
Zulässige Werte für diesen Parameter:
Amd64
Arm
IA64
MSIL
None
(unbekannt oder nicht angegeben)X86
Type: | ProcessorArchitecture |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProjectUri
Gibt den URI einer Webseite zu diesem Projekt an.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReleaseNotes
Gibt eine Zeichenfolge an, die Versionshinweise oder Kommentare für das Modul enthält.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredAssemblies
Gibt die Assemblydateien (.dll
) an, die für das Modul erforderlich sind. PowerShell lädt die angegebenen Assemblys, bevor Typen oder Formate aktualisiert, geschachtelte Module importiert oder die im RootModule-Schlüssel angegebene Moduldatei importiert wird.
Verwenden Sie RequiredAssemblies für Assemblys, die geladen werden müssen, um alle Formatierungs- oder Typdateien zu aktualisieren, die in den Schlüsseln FormatsToProcess oder TypesToProcess aufgeführt sind, auch wenn diese Assemblys auch im Schlüssel NestedModules aufgeführt sind.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredModules
Gibt die Module an, die im globalen Sitzungsstatus enthalten sein 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 Import-Module
Befehl fehl.
Der Wert kann ein Array sein, das Modulnamen oder Modulspezifikationen enthält. Eine Modulspezifikation ist eine Hashtabelle mit den folgenden Schlüsseln.
ModuleName
- Erforderlich Gibt den Modulnamen an.GUID
- Optional Gibt die GUID des Moduls an.- Es ist auch erforderlich , mindestens einen der drei folgenden Schlüssel anzugeben.
ModuleVersion
– Gibt eine zulässige 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.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequireLicenseAcceptance
Gibt an, dass für das Modul eine Lizenzakzeptanz erforderlich ist.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RootModule
Gibt die primäre oder Stammdatei des Moduls an. Geben Sie den Dateinamen eines Skripts (.ps1
), eines Skriptmoduls (.psm1
), eines Modulmanifests (.psd1
), einer Assembly (.dll
) oder einer Cmdletdefinitions-XML-Datei (.cdxml
) ein. Wenn das Modul importiert wird, werden die aus dem Stammmodul exportierten Member in den Sitzungszustand des Aufrufers importiert.
Wenn ein Modul über eine Manifestdatei verfügt und keine Datei im RootModule-Schlüssel angegeben ist, wird das Manifest zur primären Datei für das Modul. Das Modul wird als Manifestmodul (ModuleType =
Manifest
) bezeichnet.
Zum Exportieren von Membern aus .psm1
oder .dll
Dateien müssen die Namen dieser Dateien in den Werten des Schlüssels RootModule oder NestedModules im Manifest angegeben werden.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptsToProcess
Gibt Skriptdateien (.ps1
) an, die im Sitzungszustand des Aufrufers ausgeführt werden, wenn das Modul importiert wird.
Sie können diese Skripte zur Vorbereitung einer Umgebung verwenden, wie Sie ein Anmeldeskript verwenden würden.
Um Skripte anzugeben, die im Sitzungsstatus des Moduls ausgeführt werden, verwenden Sie den NestedModules-Schlüssel.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tags
Gibt ein Array von Tags an.
Type: | String[] |
Aliases: | Tag |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TypesToProcess
Gibt die Typdateien (.ps1xml
) an, die beim Importieren des Moduls ausgeführt werden.
Wenn Sie das Modul importieren, führt PowerShell das Update-TypeData
Cmdlet mit den angegebenen Dateien aus.
Da Typdateien keinen Bereich haben, wirken sie sich auf alle Sitzungszustände in der Sitzung aus.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VariablesToExport
Gibt die Variablen an, die das Modul exportiert. Platzhalter sind zulässig.
Verwenden Sie diesen Parameter, um einzuschränken, welche Variablen vom Modul exportiert werden.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Eingaben
None
Ausgaben
Hinweise
Eine vollständige Beschreibung der Modulmanifestdatei finden Sie unter about_Module_Manifests.
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für