Update-PSModuleManifest

Module:

Microsoft.PowerShell.PSResourceGet

Updates een modulemanifestbestand.

Syntaxis

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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

-Author

Hiermee geeft u de auteur van de module.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CmdletsToExport

Hiermee geeft u de cmdlets op die de module exporteert. Jokertekens zijn toegestaan.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

-CompanyName

Hiermee geeft u het bedrijf of de leverancier op die de module heeft gemaakt.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CompatiblePSEditions

Hiermee geeft u de compatibele PSEditions van de module. Zie Modules met compatibele PowerShell-edities voor meer informatie over PSEdition.

Type:	String[]
Geaccepteerde waarden:	Desktop, Core
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Copyright

Hiermee geeft u een copyright-instructie voor de module.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultCommandPrefix

Hiermee geeft u het standaardopdrachtvoorvoegsel.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Description

Hiermee geeft u een beschrijving van de module.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DotNetFrameworkVersion

Hiermee geeft u de minimale versie van de Microsoft .NET Framework vereist voor de module.

Type:	Version
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

-ExternalModuleDependencies

Hiermee geeft u een matrix van externe moduleafhankelijkheden.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-FileList

Hiermee geeft u alle items die zijn opgenomen in de module.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-FunctionsToExport

Hiermee geeft u de functies op die de module exporteert. Jokertekens zijn toegestaan.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-LicenseUri

Hiermee geeft u de URL van de licentievoorwaarden voor de module.

Type:	Uri
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ModuleVersion

Hiermee geeft u de versie van de module op.

Type:	Version
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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.2opgeven.

Type:	Version
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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-previewde versie van de module .

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ProjectUri

Hiermee geeft u de URI van een webpagina over dit project.

Type:	Uri
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ReleaseNotes

Hiermee geeft u een tekenreeks op die releaseopmerkingen of opmerkingen voor de module bevat.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RequireLicenseAcceptance

Hiermee geeft u op dat een licentie-acceptatie is vereist voor de module.

Type:	SwitchParameter
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Tags

Hiermee geeft u een matrix van tags.

Type:	String[]
Aliassen:	Tag
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

Invoerwaarden

None

Uitvoerwaarden

Object

Notities

Zie about_Module_Manifests voor een volledige beschrijving van het modulemanifestbestand.

Verwante koppelingen

• New-ModuleManifest