Update-ModuleManifest
Updates een modulemanifestbestand.
Syntax
Update-ModuleManifest
[-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[]>]
[-PrivateData <Hashtable>]
[-Tags <String[]>]
[-ProjectUri <Uri>]
[-LicenseUri <Uri>]
[-IconUri <Uri>]
[-ReleaseNotes <String[]>]
[-Prerelease <String>]
[-HelpInfoUri <Uri>]
[-PassThru]
[-DefaultCommandPrefix <String>]
[-ExternalModuleDependencies <String[]>]
[-PackageManagementProviders <String[]>]
[-RequireLicenseAcceptance]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De Update-ModuleManifest
cmdlet werkt een modulemanifestbestand (.psd1
) bij.
Dit is een proxy-cmdlet voor de Update-PSModuleManifest
cmdlet in Microsoft.PowerShell.PSResourceGet. Zie Update-PSModuleManifest voor meer informatie.
Voorbeelden
Voorbeeld 1: Een modulemanifest bijwerken
In dit voorbeeld wordt een bestaand modulemanifestbestand bijgewerkt. Splatting wordt gebruikt om parameterwaarden door te geven aan Update-ModuleManifest
. Zie about_Splatting voor meer informatie.
$Params = @{
Path = "C:\Test\TestManifest.psd1"
Author = "TestUser1"
CompanyName = "Contoso Corporation"
Copyright = "(c) 2019 Contoso Corporation. All rights reserved."
}
Update-ModuleManifest @Params
$Params
is een splat waarin de parameterwaarden voor Path, Author, CompanyName en Copyright worden opgeslagen. Update-ModuleManifest
haalt de parameterwaarden op van @Params
en werkt het modulemanifest , TestManifest.psd1, bij.
Parameters
-AliasesToExport
Hiermee geeft u de aliassen op die de module exporteert. Jokertekens zijn toegestaan.
Gebruik deze parameter om de aliassen te beperken die door de module worden geëxporteerd. AliasesToExport kan aliassen verwijderen uit de lijst met geëxporteerde aliassen, maar er kunnen geen aliassen aan de lijst worden toegevoegd.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Author
Hiermee geeft u de auteur van de module.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClrVersion
Hiermee geeft u de minimale versie van de Common Language Runtime (CLR) van de Microsoft .NET Framework die voor de module is vereist.
Notitie
Deze instelling is alleen geldig voor de PowerShell Desktop-editie, zoals Windows PowerShell 5.1, en is alleen van toepassing op .NET Framework versies lager dan 4.5. Deze vereiste heeft geen effect voor nieuwere versies van PowerShell of de .NET Framework.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CmdletsToExport
Hiermee geeft u de cmdlets op die de module exporteert. Jokertekens zijn toegestaan.
Gebruik deze parameter om de cmdlets te beperken die door de module worden geëxporteerd. CmdletsToExport kan cmdlets verwijderen uit de lijst met geëxporteerde cmdlets, maar er kunnen geen cmdlets aan de lijst worden toegevoegd.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-CompanyName
Hiermee geeft u het bedrijf of de leverancier op die de module heeft gemaakt.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CompatiblePSEditions
Hiermee geeft u de compatibele PSEditions van de module. Zie Modules met compatibele PowerShell-edities voor meer informatie over PSEdition.
Type: | String[] |
Accepted values: | Desktop, Core |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
U wordt om bevestiging gevraagd voordat u uitvoert Update-ModuleManifest
.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Copyright
Hiermee geeft u een copyright-instructie voor de module.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultCommandPrefix
Hiermee geeft u het standaardopdrachtvoorvoegsel.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Hiermee geeft u een beschrijving van de module.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DotNetFrameworkVersion
Hiermee geeft u de minimale versie van de Microsoft .NET Framework die de module vereist.
Notitie
Deze instelling is alleen geldig voor de PowerShell Desktop-editie, zoals Windows PowerShell 5.1, en is alleen van toepassing op .NET Framework versies lager dan 4.5. Deze vereiste heeft geen effect voor nieuwere versies van PowerShell of de .NET Framework.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DscResourcesToExport
Hiermee geeft u de Desired State Configuration (DSC) resources die de module exporteert. Jokertekens zijn toegestaan.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExternalModuleDependencies
Hiermee geeft u een matrix van externe moduleafhankelijkheden.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FileList
Hiermee geeft u alle items die zijn opgenomen in de module.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FormatsToProcess
Hiermee geeft u de opmaakbestanden (.ps1xml
) op die worden uitgevoerd 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 binnen het bereik vallen, zijn ze van invloed op alle sessiestatussen in de sessie.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FunctionsToExport
Hiermee geeft u de functies op die de module exporteert. Jokertekens zijn toegestaan.
Gebruik deze parameter om de functies te beperken die door de module worden geëxporteerd. FunctionsToExport kan functies verwijderen uit de lijst met geëxporteerde aliassen, maar er kunnen geen functies aan de lijst worden toegevoegd.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Guid
Hiermee geeft u een unieke id voor de module. De GUID kan worden gebruikt om onderscheid te maken tussen modules met dezelfde naam.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HelpInfoUri
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.
Het XML-bestand HelpInfo ondersteunt de functie Bijwerkbare Help die is geïntroduceerd in PowerShell-versie 3.0. Het bevat informatie over de locatie van de downloadbare Help-bestanden van de module en de versienummers van de nieuwste Help-bestanden voor elke ondersteunde landinstelling.
Zie about_Updatable_Help voor meer informatie over help die kan worden bijgewerkt. Zie Ondersteuning voor bijwerkbare Help voor informatie over het XML-bestand Help die kan worden bijgewerkt.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IconUri
Hiermee geeft u de URL van een pictogram voor de module. Het opgegeven pictogram wordt weergegeven op de webpagina van de galerie voor de module.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseUri
Hiermee geeft u de URL van de licentievoorwaarden voor de module.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModuleList
Hiermee geeft u een matrix van modules die zijn opgenomen in de module.
Voer elke modulenaam in als een tekenreeks of als een hash-tabel met de sleutels ModuleName en ModuleVersion . De hashtabel kan ook een optionele GUID-sleutel hebben. U kunt tekenreeksen en hash-tabellen combineren in de parameterwaarde.
Deze sleutel is ontworpen om te fungeren als een module-inventaris. De modules die worden vermeld in de waarde van deze sleutel, worden niet automatisch verwerkt.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModuleVersion
Hiermee geeft u de versie van de module op.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NestedModules
Hiermee geeft u scriptmodules (.psm1
) en binaire modules (.dll
) op die worden geïmporteerd in de sessiestatus van de module. De bestanden in de sleutel NestedModules worden uitgevoerd in de volgorde waarin ze worden vermeld in de waarde.
Voer elke modulenaam in als een tekenreeks of als een hash-tabel met de sleutels ModuleName en ModuleVersion . De hashtabel kan ook een optionele GUID-sleutel hebben. U kunt tekenreeksen en hash-tabellen combineren in de parameterwaarde.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageManagementProviders
Hiermee geeft u een matrix van pakketbeheerproviders op.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Retourneert een object dat het item vertegenwoordigt waarmee u werkt. Genereert standaard Update-ModuleManifest
geen uitvoer.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Hiermee geeft u het pad en de bestandsnaam van het modulemanifest. Voer een pad en bestandsnaam in met een .psd1
bestandsnaamextensie, zoals $PSHOME\Modules\MyModule\MyModule.psd1
.
Als u het pad naar een bestaand bestand opgeeft, Update-ModuleManifest
vervangt u het bestand zonder waarschuwing, tenzij het bestand het kenmerk Alleen-lezen heeft.
Het manifest moet zich in de map van de module bevinden en de bestandsnaam van het manifest moet hetzelfde zijn als de naam van de map van de module, maar met een .psd1
extensie.
U kunt variabelen, zoals $PSHOME
of $HOME
, niet gebruiken als reactie op een prompt voor een waarde voor een padparameter . Als u een variabele wilt gebruiken, neemt u de parameter Path op in de opdracht.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PowerShellHostName
Hiermee geeft u de naam van het PowerShell-hostprogramma dat de module vereist. Voer de naam van het hostprogramma in, zoals PowerShell ISE Host of ConsoleHost. Jokertekens zijn niet toegestaan.
Als u de naam van een hostprogramma wilt vinden, typt $Host.Name
u in het programma.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PowerShellHostVersion
Hiermee geeft u de minimale versie van het PowerShell-hostprogramma op dat met de module werkt. Voer een versienummer in, bijvoorbeeld 1.1.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PowerShellVersion
Hiermee geeft u de minimale versie van PowerShell op die met deze module werkt. U kunt bijvoorbeeld 3.0, 4.0 of 5.0 opgeven als de waarde van deze parameter.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Prerelease
Geeft aan dat de module prerelease is.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateData
Hiermee geeft u gegevens op die worden doorgegeven aan de module wanneer deze worden geïmporteerd.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProcessorArchitecture
Hiermee geeft u de processorarchitectuur op die voor de module is vereist.
De aanvaardbare waarden voor deze parameter zijn:
- Amd64
- Arm
- IA64
- MSIL
- Geen (onbekend of niet opgegeven)
- X86
Type: | ProcessorArchitecture |
Accepted values: | None, MSIL, X86, IA64, Amd64, Arm |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProjectUri
Hiermee geeft u de URL van een webpagina over dit project.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReleaseNotes
Hiermee geeft u een tekenreeksmatrix op die releaseopmerkingen of opmerkingen bevat die u beschikbaar wilt maken voor deze versie van het script.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredAssemblies
Hiermee geeft u de assemblybestanden (.dll
) die de module vereist. Voer de namen van het assemblybestand in.
PowerShell laadt de opgegeven assembly's voordat u typen of indelingen bijwerkt, geneste modules importeert of het modulebestand importeert dat is opgegeven in de waarde van de RootModule-sleutel .
Gebruik deze parameter om alle assembly's op te geven die de module nodig heeft, inclusief assembly's die moeten worden geladen om opmaak- of typebestanden bij te werken die worden vermeld in de sleutels FormatsToProcess of TypesToProcess , zelfs als deze assembly's ook worden vermeld als binaire modules in de sleutel NestedModules .
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredModules
Hiermee geeft u modules op die de globale sessiestatus moeten hebben. Als de vereiste modules niet de globale sessiestatus hebben, worden ze geïmporteerd in PowerShell. Als de vereiste modules niet beschikbaar zijn, mislukt de Import-Module
opdracht.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequireLicenseAcceptance
Hiermee geeft u op dat een licentieacceptatie is vereist voor de module.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RootModule
Hiermee geeft u het primaire of hoofdbestand van de module. Voer de bestandsnaam in van een script (.ps1
), een scriptmodule (.psm1
), een modulemanifest (.psd1
), een assembly (.dll
), een CMDLET-definitie-XML-bestand (.cdxml
) of een werkstroom (.xaml
). Wanneer de module wordt geïmporteerd, worden de leden die worden geëxporteerd uit het hoofdmodulebestand geïmporteerd in de sessiestatus van de aanroeper.
Als een module een manifestbestand heeft en er geen hoofdbestand is opgegeven in de RootModule-sleutel , wordt het manifest het primaire bestand voor de module. En de module wordt een manifestmodule (ModuleType = Manifest).
Als u leden wilt exporteren uit .psm1
of .dll
bestanden in een module met een manifest, moeten de namen van deze bestanden worden opgegeven in de waarden van de sleutels RootModule of NestedModules in het manifest. Anders worden hun leden niet geëxporteerd.
In PowerShell 2.0 heette deze sleutel ModuleToProcess.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptsToProcess
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 zou kunnen gebruiken.
Als u scripts wilt opgeven die worden uitgevoerd in de sessiestatus van de module, gebruikt u de sleutel NestedModules .
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tags
Hiermee geeft u een matrix van tags.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TypesToProcess
Hiermee geeft u het type bestanden (.ps1xml
) die worden uitgevoerd wanneer de module wordt geïmporteerd.
Wanneer u de module importeert, wordt de Update-TypeData
cmdlet met de opgegeven bestanden uitgevoerd.
Omdat typebestanden niet binnen het bereik vallen, zijn ze van invloed op alle sessiestatussen in de sessie.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VariablesToExport
Hiermee geeft u de variabelen op die de module exporteert. Jokertekens zijn toegestaan.
Gebruik deze parameter om de variabelen te beperken die door de module worden geëxporteerd. VariablesToExport kan variabelen verwijderen uit de lijst met geëxporteerde variabelen, maar er kunnen geen variabelen aan de lijst worden toegevoegd.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-WhatIf
Toont wat er zou gebeuren als Update-ModuleManifest
wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
Uitvoerwaarden
PSResourceGet