Update-PSModuleManifest
Updates een modulemanifestbestand.
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>]
Description
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 worden overschreven.
De cmdlet retourneert geen object.
Voorbeelden
Voorbeeld 1
In dit voorbeeld wordt de eigenschap Author in het modulemanifest gewijzigd in New Author
.
Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Author 'New Author'
Voorbeeld 2
In dit voorbeeld wordt de eigenschap Prerelease gewijzigd in beta2
.
Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Prerelease 'beta2'
Voorbeeld 3
In dit voorbeeld worden meerdere eigenschappen bijgewerkt.
$parameters = @{
Path = 'C:\MyModules\TestModule'
Tags = 'Windows', 'Linux'
Description = 'A module for managing packages.'
}
Update-PSModuleManifest
Parameters
-AliasesToExport
Hiermee geeft u de aliassen op die de module exporteert. Jokertekens zijn toegestaan.
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 vereist door de module.
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.
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 |
-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 vereist voor de module.
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: | True |
-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
) 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 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.
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 wordt 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:
.
Zie Bijwerkbare Help voor meer informatie.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IconUri
Hiermee geeft u de URI 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 hashtabel met de sleutels ModuleName en ModuleVersion . De hashtable 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.
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.
Voer elke modulenaam in als een tekenreeks of als een hashtabel met de sleutels ModuleName en ModuleVersion . De hashtable kan ook een optionele GUID-sleutel hebben. U kunt tekenreeksen en hashtables combineren in de parameterwaarde.
Type: | Object[] |
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 bestandsnaam in met een .psd1
bestandsextensie.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
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.
De naam van een hostprogramma wordt opgeslagen in $Host.Name
.
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 versies zoals 5.1
of 7.2
opgeven.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Prerelease
Hiermee geeft u de prerelease-waarde op die wordt toegevoegd aan de moduleversie. Als prerelease bijvoorbeeld is preview
en de ModuleVersion is 1.0.0
, is 1.0.0-preview
de versie van de module .
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. Dit kunnen willekeurige waarden zijn die zijn opgeslagen in een hashtabel.
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
None
(onbekend of niet opgegeven)X86
Type: | ProcessorArchitecture |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProjectUri
Hiermee geeft u de URI 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 tekenreeks op die releaseopmerkingen of opmerkingen voor de module bevat.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredAssemblies
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 sleutels FormatsToProcess of TypesToProcess , zelfs als deze assembly's ook worden vermeld 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 status van de globale sessie hebben, worden ze geïmporteerd door PowerShell. Als de vereiste modules niet beschikbaar zijn, mislukt de Import-Module
opdracht.
De waarde kan een matrix zijn met modulenamen of modulespecificaties. Een modulespecificatie is een hashtabel met de volgende sleutels.
ModuleName
- Vereist Hiermee geeft u de naam van de module.GUID
- Optionele Hiermee geeft u de GUID van de module.- Het is ook Vereist om ten minste een van de drie onderstaande sleutels op te geven.
ModuleVersion
- Hiermee geeft u een minimaal aanvaardbare versie van de module op.MaximumVersion
- Hiermee geeft u de maximaal aanvaardbare versie van de module op.RequiredVersion
- Hiermee geeft u een exacte, vereiste versie van de module op. Dit kan niet worden gebruikt met de andere versiesleutels.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequireLicenseAcceptance
Hiermee geeft u op dat een licentie-acceptatie is vereist voor de module.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
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
) of een XML-bestand met de cmdletdefinitie (.cdxml
). Wanneer de module wordt geïmporteerd, worden de leden die uit de hoofdmodule worden 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 (ModuleType =
Manifest
) genoemd.
Als u leden uit .psm1
of .dll
bestanden wilt exporteren, moeten de namen van deze bestanden worden opgegeven in de waarden van de sleutels RootModule of NestedModules in het manifest.
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 kunt 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[] |
Aliases: | Tag |
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 te beperken welke variabelen door de module worden geëxporteerd.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Invoerwaarden
None
Uitvoerwaarden
Notities
Zie about_Module_Manifests voor een volledige beschrijving van het modulemanifestbestand.
Verwante koppelingen
PSResourceGet
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor