Update-ModuleManifest

Referentie

Module:: PowerShellGet

Updates een modulemanifestbestand.

Syntax

PowerShell

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[]>]
      [-HelpInfoUri <Uri>]
      [-PassThru]
      [-DefaultCommandPrefix <String>]
      [-ExternalModuleDependencies <String[]>]
      [-PackageManagementProviders <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

De Update-ModuleManifest cmdlet werkt een modulemanifestbestand (.psd1) bij.

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.

PowerShell

$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

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.

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.Nameu 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

-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) op die voor de module nodig zijn. 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

-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:	False

-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

String

Uitvoerwaarden

Object

Notities

Belangrijk

Vanaf april 2020 biedt de PowerShell Gallery geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. Als u tls 1.2 of hoger niet gebruikt, krijgt u een foutmelding wanneer u toegang probeert te krijgen tot de PowerShell Gallery. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Zie de aankondiging in de PowerShell-blog voor meer informatie.

Delen via