Update-ModuleManifest

Referentie

Module:: PowerShellGet

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

Met de Update-ModuleManifest cmdlet wordt een modulemanifestbestand (.psd1) bijgewerkt.

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.

$Parms = @{
  Path = "C:\Test\TestManifest.psd1"
  Author = "TestUser1"
  CompanyName = "Contoso Corporation"
  Copyright = "(c) 2019 Contoso Corporation. All rights reserved."
}

Update-ModuleManifest @Parms

$Parms is een splat die de parameterwaarden voor Path, Author, CompanyName en Copyright opslaat. Update-ModuleManifest haalt de parameterwaarden van @Parms en werkt het modulemanifest, TestManifest.psd1, bij.

Parameters

-AliasesToExport

Hiermee geeft u de aliassen op die door de module worden geëxporteerd. 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 kan geen aliassen toevoegen aan de lijst.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-Author

Hiermee geeft u de auteur van de module op.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ClrVersion

Hiermee geeft u de minimale versie van Common Language Runtime (CLR) van de Microsoft-.NET Framework die de module vereist.

Type:	Version
Position:	Named
Default value:	None
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 kan geen cmdlets toevoegen aan de lijst.

Type:	String[]
Position:	Named
Default value:	None
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
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
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Vraagt u om bevestiging voordat u wordt uitgevoerd Update-ModuleManifest.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Copyright

Hiermee geeft u een copyrightverklaring voor de module op.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultCommandPrefix

Hiermee geeft u het standaardopdrachtvoorvoegsel.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Hiermee geeft u een beschrijving van de module.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DotNetFrameworkVersion

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

Type:	Version
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-ExternalModuleDependencies

Hiermee geeft u een matrix van externe moduleafhankelijkheden.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-FileList

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

Type:	String[]
Position:	Named
Default value:	None
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, hebben ze invloed op alle sessiestatussen in de sessie.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-FunctionsToExport

Hiermee geeft u de functies op die door de module worden geëxporteerd. 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 kan geen functies toevoegen aan de lijst.

Type:	String[]
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-HelpInfoUri

Hiermee geeft u het internetadres van het XML-bestand HelpInfo van de module op. Voer een URI (Uniform Resource Identifier) in die begint met http of https.

Het XML-bestand Help van Help help voor Help dat kan worden bijgewerkt, 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 Ondersteunende Help voor meer informatie over het XML-bestand Help voor Help- en ondersteuningsinformatie.

Type:	Uri
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-LicenseUri

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

Type:	Uri
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ModuleList

Hiermee geeft u een matrix van modules op die zijn opgenomen in de module.

Voer elke modulenaam in als een tekenreeks of als een hash-tabel met ModuleName - en ModuleVersion-sleutels . De hashtabel kan ook een optionele GUID-sleutel hebben. U kunt tekenreeksen en hashtabellen 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
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
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
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageManagementProviders

Hiermee geeft u een matrix van pakketbeheerproviders.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Retourneert een object dat het item aangeeft waarmee u werkt. Update-ModuleManifest Genereert standaard geen uitvoer.

Type:	SwitchParameter
Position:	Named
Default value:	None
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, vervangt u het bestand zonder waarschuwing, Update-ModuleManifest 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 dezelfde zijn als de naam van de modulemap, maar met een .psd1 extensie.

U kunt geen variabelen gebruiken, zoals $PSHOME of $HOME, als reactie op een prompt voor een path-parameterwaarde . Als u een variabele wilt gebruiken, neemt u de parameter Path op in de opdracht.

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PowerShellHostName

Hiermee geeft u de naam op 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 zoeken, typt $Host.Nameu in het programma.

Type:	String
Position:	Named
Default value:	None
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, zoals 1.1.

Type:	Version
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-Prerelease

Geeft aan dat de module vooraf wordt opgegeven.

Type:	String
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-ProcessorArchitecture

Hiermee geeft u de processorarchitectuur die de module 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
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
Accept pipeline input:	False
Accept wildcard characters:	False

-ReleaseNotes

Hiermee geeft u een tekenreeksmatrix op die releaseopmerkingen of opmerkingen bevat die beschikbaar zijn voor deze versie van het script.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RequiredAssemblies

Hiermee geeft u de assemblybestanden (.dll) op die de module nodig heeft. Voer de namen van de assemblybestanden 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 vereist, 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
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 deze geïmporteerd in PowerShell. Als de vereiste modules niet beschikbaar zijn, mislukt de Import-Module opdracht.

Type:	Object[]
Position:	Named
Default value:	None
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:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RootModule

Hiermee geeft u het primaire of hoofdbestand van de module. Voer de bestandsnaam van een script (), een scriptmodule (.ps1.psm1), een modulemanifest (.psd1), een assembly (.dll), een XML-bestand met de cmdlet-definitie () of een werkstroom (.cdxml.xaml) in. Wanneer de module wordt geïmporteerd, worden de leden die uit het hoofdmodulebestand worden geëxporteerd, 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 uit .psm1 of .dll bestanden in een module met een manifest wilt exporteren, 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 werd deze sleutel ModuleToProcess genoemd.

Type:	String
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-Tags

Hiermee geeft u een matrix van tags.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-TypesToProcess

Hiermee geeft u de typebestanden (.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 binnen het bereik vallen, hebben ze invloed op alle sessiestatussen in de sessie.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-VariablesToExport

Hiermee geeft u de variabelen op die door de module worden geëxporteerd. 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 kan geen variabelen toevoegen aan de lijst.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-WhatIf

Laat zien wat er zou gebeuren als Update-ModuleManifest deze wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	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) versie 1.0 en 1.1. Als u TLS 1.2 of hoger niet gebruikt, wordt er een foutbericht weergegeven bij het openen van 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.