Met deze cmdlet worden de gegevens bijgewerkt die zijn opgeslagen in een modulemanifestbestand. Met de parameters kunt u opgeven welke eigenschappen worden bijgewerkt.
Update-PSModuleManifest bestaande waarden in het modulemanifest overschrijft.
De cmdlet retourneert geen object.
Voorbeelden
Voorbeeld 1
In dit voorbeeld wordt de eigenschap Author in het modulemanifest gewijzigd in New Author.
Hiermee geeft u de opmaakbestanden (.ps1xml) op die worden verwerkt wanneer de module wordt geïmporteerd.
Wanneer u een module importeert, voert PowerShell de Update-FormatData cmdlet uit met de opgegeven bestanden.
Omdat opmaakbestanden niet beperkt zijn, hebben ze invloed op alle sessiestanden in de sessie.
Hiermee geeft u het internetadres van het XML-bestand helpinfo van de module. Voer een URI (Uniform Resource Identifier) in die begint met http: of https:.
Hiermee geeft u een matrix van modules op die zijn opgenomen in de module.
Voer elke modulenaam in als een tekenreeks of als een hashtabel met ModuleName en ModuleVersion sleutels.
De hashtabel kan ook een optionele GUID--sleutel hebben. U kunt tekenreeksen en hashtables combineren in de parameterwaarde.
Deze sleutel is ontworpen om te fungeren als een module-inventaris.
Hiermee geeft u scriptmodules (.psm1) en binaire modules (.dll) op die in de sessiestatus van de module worden geïmporteerd. De bestanden in de NestedModules sleutel worden uitgevoerd in de volgorde waarin ze worden vermeld.
Voer elke modulenaam in als een tekenreeks of als een hashtabel met ModuleName en ModuleVersion sleutels.
De hashtabel kan ook een optionele GUID--sleutel hebben. U kunt tekenreeksen en hashtables combineren in de parameterwaarde.
Hiermee geeft u de naam op van het PowerShell-hostprogramma dat voor de module is vereist. Voer de naam in van het hostprogramma, zoals PowerShell ISE Host of ConsoleHost. Jokertekens zijn niet toegestaan.
De naam van een hostprogramma wordt opgeslagen in $Host.Name.
Hiermee geeft u de prereleasewaarde op die wordt toegevoegd aan de moduleversie. Als prerelease bijvoorbeeld preview is en de ModuleVersion-1.0.0is, wordt de versie van de module 1.0.0-preview.
Hiermee geeft u gegevens op die worden doorgegeven aan de module wanneer deze worden geïmporteerd. Dit kunnen willekeurige waarden zijn die zijn opgeslagen in een hashtabel.
Hiermee geeft u de assemblybestanden (.dll) op die vereist zijn voor de module. PowerShell laadt de opgegeven assembly's voordat u typen of indelingen bijwerkt, geneste modules importeert of het modulebestand importeert dat is opgegeven in de RootModule sleutel.
Gebruik RequiredAssemblies voor assembly's die moeten worden geladen om opmaak- of typebestanden bij te werken die worden vermeld in de FormatsToProcess of TypesToProcess sleutels, zelfs als deze assembly's ook worden vermeld in de NestedModules sleutel.
Hiermee geeft u modules op die de globale sessiestatus moeten hebben. Als de vereiste modules niet de status van de globale sessie hebben, worden deze geïmporteerd in PowerShell. Als de vereiste modules niet beschikbaar zijn, mislukt de opdracht Import-Module.
De waarde kan een matrix zijn die modulenamen of modulespecificaties bevat. Een modulespecificatie is een hashtabel met de volgende sleutels.
ModuleName
-
Vereist Geeft de modulenaam op.
GUID
-
Optionele Geeft de GUID van de module aan.
Het is ook vereist om ten minste een van de drie onderstaande sleutels op te geven.
ModuleVersion - Hiermee geeft u een minimaal acceptabele versie van de module op.
MaximumVersion - Hiermee geeft u de maximaal acceptabele versie van de module.
RequiredVersion - Hiermee geeft u een exacte, vereiste versie van de module op. Dit kan niet worden gebruikt met de andere versiesleutels.
Geeft het primaire of hoofdbestand van de module op. Voer de bestandsnaam van een script (.ps1), een scriptmodule (.psm1), een modulemanifest (.psd1), een assembly (.dll) of een XML-bestand met de cmdletdefinitie (.cdxml) in. Wanneer de module wordt geïmporteerd, worden de leden die uit de hoofdmodule zijn geëxporteerd, geïmporteerd in de sessiestatus van de aanroeper.
Als een module een manifestbestand heeft en er geen bestand is opgegeven in de RootModule sleutel, wordt het manifest het primaire bestand voor de module. De module wordt een manifestmodule genoemd (ModuleType =
Manifest).
Als u leden wilt exporteren uit .psm1- of .dll-bestanden, moeten de namen van deze bestanden worden opgegeven in de waarden van de RootModule of NestedModules sleutels in het manifest.
Hiermee geeft u scriptbestanden (.ps1) op die worden uitgevoerd in de sessiestatus van de aanroeper wanneer de module wordt geïmporteerd.
U kunt deze scripts gebruiken om een omgeving voor te bereiden, net zoals u een aanmeldingsscript kunt gebruiken.
Als u scripts wilt opgeven die worden uitgevoerd in de sessiestatus van de module, gebruikt u de NestedModules-sleutel.
Hiermee geeft u het type bestanden (.ps1xml) die worden uitgevoerd wanneer de module wordt geïmporteerd.
Wanneer u de module importeert, voert PowerShell de Update-TypeData cmdlet uit met de opgegeven bestanden.
Omdat typebestanden niet specifiek afgebakend zijn, hebben ze invloed op alle sessiestatussen.
De bron voor deze inhoud vindt u op GitHub, waar u ook problemen en pull-aanvragen kunt maken en controleren. Bekijk onze gids voor inzenders voor meer informatie.
