Update-ModuleManifest

Syntaxis

All

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

Voorbeelden

Voorbeeld 1: Een modulemanifest bijwerken

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

Update-ModuleManifest @Params

Parameters

-AliasesToExport

Hiermee geeft u de aliassen op die de module exporteert. Wildcards 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.

Parametereigenschappen

Parametersets

-Author

Hiermee geeft u de auteur van de module op.

Parametereigenschappen

Parametersets

-ClrVersion

Hiermee geeft u de minimale versie van de Common Language Runtime (CLR) van microsoft .NET Framework op die voor de module is vereist.

Parametereigenschappen

Parametersets

-CmdletsToExport

Hiermee geeft u de cmdlets op die de module exporteert. Wildcards 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.

Parametereigenschappen

Parametersets

-CompanyName

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

Parametereigenschappen

Parametersets

-CompatiblePSEditions

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

Parametereigenschappen

Parametersets

-Confirm

Vraagt u om bevestiging voordat u Update-ModuleManifestuitvoert.

Parametereigenschappen

Parametersets

-Copyright

Hiermee specificeert u een copyrightverklaring voor de module.

Parametereigenschappen

Parametersets

-DefaultCommandPrefix

Hiermee geeft u het standaardopdrachtvoorvoegsel.

Parametereigenschappen

Parametersets

-Description

Hiermee geeft u een beschrijving van de module.

Parametereigenschappen

Parametersets

-DotNetFrameworkVersion

Hiermee geeft u de minimale versie van microsoft .NET Framework op die voor de module is vereist.

Parametereigenschappen

Parametersets

-DscResourcesToExport

Hiermee geeft u de DSC-resources (Desired State Configuration) op die door de module worden geëxporteerd. Wildcards zijn toegestaan.

Parametereigenschappen

Parametersets

-ExternalModuleDependencies

Hiermee geeft u een matrix van externe moduleafhankelijkheden.

Parametereigenschappen

Parametersets

-FileList

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

Parametereigenschappen

Parametersets

-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 beperkt zijn, hebben ze invloed op alle sessiestanden in de sessie.

Parametereigenschappen

Parametersets

-FunctionsToExport

Hiermee geeft u de functies op die door de module worden geëxporteerd. Wildcards 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.

Parametereigenschappen

Parametersets

-Guid

Hiermee geeft u een unieke id voor de module. De GUID kan worden gebruikt om onderscheid te maken tussen modules met dezelfde naam.

Parametereigenschappen

Parametersets

-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 Help-functie Updatable 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_Helpvoor meer informatie over Help die kan worden bijgewerkt. Zie Ondersteunende Help-informatie over het XML-bestand help voor Help voor Help-informatie over help die kan worden bijgewerkt.

Parametereigenschappen

Parametersets

-IconUri

Hiermee geeft u de URL van een pictogram voor de module. Het opgegeven pictogram wordt weergegeven op de galeriewebpagina voor de module.

Parametereigenschappen

Parametersets

-LicenseUri

Hiermee geeft u de URL van licentievoorwaarden voor de module.

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

-ModuleVersion

Hiermee geeft u de versie van de module.

Parametereigenschappen

Parametersets

-NestedModules

Hiermee geeft u scriptmodules (.psm1) en binaire modules (.dll) op die in de sessiestatus van de module worden geïmporteerd. De bestanden in de sleutel NestedModules worden uitgevoerd in de volgorde waarin ze in de waardelijst zijn vermeld.

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.

Parametereigenschappen

Parametersets

-PackageManagementProviders

Hiermee geeft u een matrix van pakketbeheerproviders.

Parametereigenschappen

Parametersets

-PassThru

Hiermee wordt een object geretourneerd dat het item aangeeft waarmee u werkt. Standaard genereert Update-ModuleManifest geen uitvoer.

Parametereigenschappen

Parametersets

-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 Update-ModuleManifest 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 naam van het manifestbestand moet hetzelfde 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 padparameterwaarde . Als u een variabele wilt gebruiken, neemt u de parameter Path op in de opdracht.

Parametereigenschappen

Parametersets

-PowerShellHostName

Hiermee geeft u de naam op van het PowerShell-hostprogramma dat voor de module is vereist. Voer de naam in van het hostprogramma, zoals PowerShell ISE Host of ConsoleHost. Jokertekens zijn niet toegestaan.

Als u de naam van een hostprogramma wilt zoeken, typt u $Host.Namein het programma.

Parametereigenschappen

Parametersets

-PowerShellHostVersion

Hiermee geeft u de minimale versie van het PowerShell-hostprogramma op dat met de module werkt. Voer een versienummer in, zoals 1.1.

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

-Prerelease

Geeft aan dat de module vooraf is opgegeven.

Parametereigenschappen

Parametersets

-PrivateData

Hiermee geeft u gegevens op die worden doorgegeven aan de module wanneer deze worden geïmporteerd.

Parametereigenschappen

Parametersets

-ProcessorArchitecture

Hiermee geeft u de processorarchitectuur op die nodig is voor de module.

De acceptabele waarden voor deze parameter zijn:

• Amd64
• Arm
• IA64
• MSIL
• Geen (onbekend of niet opgegeven)
• X86

Parametereigenschappen

Parametersets

-ProjectUri

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

Parametereigenschappen

Parametersets

-ReleaseNotes

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

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

-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 opdracht Import-Module.

Parametereigenschappen

Parametersets

-RequireLicenseAcceptance

Hiermee geeft u op dat een licentieacceptatie vereist is voor de module.

Parametereigenschappen

Parametersets

-RootModule

Geeft het primaire of hoofdbestand van de module op. 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 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 RootModule- of NestedModules sleutels in het manifest. Anders worden hun leden niet geëxporteerd.

In PowerShell 2.0 werd deze sleutel ModuleToProcessgenoemd.

Parametereigenschappen

Parametersets

-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 NestedModules-sleutel.

Parametereigenschappen

Parametersets

-Tags

Hiermee specificeert u een reeks van tags.

Parametereigenschappen

Parametersets

-TypesToProcess

Hiermee geeft u het type bestanden (.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 specifiek afgebakend zijn, hebben ze invloed op alle sessiestatussen.

Parametereigenschappen

Parametersets

-VariablesToExport

Hiermee geeft u de variabelen op die door de module worden geëxporteerd. Wildcards 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.

Parametereigenschappen

Parametersets

-WhatIf

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

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

String

Uitvoerwaarden

Object