Update-ModuleManifest

Syntax

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

Exempel

Exempel 1: Uppdatera ett modulmanifest

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

Update-ModuleManifest @Params

Parametrar

-AliasesToExport

Anger de alias som modulen exporterar. Jokertecken tillåts.

Använd den här parametern för att begränsa de alias som exporteras av modulen. AliasEsToExport kan ta bort alias från listan över exporterade alias, men det kan inte lägga till alias i listan.

Parameteregenskaper

Parameteruppsättningar

-Author

Anger modulförfattaren.

Parameteregenskaper

Parameteruppsättningar

-ClrVersion

Anger den lägsta versionen av Common Language Runtime (CLR) för Microsoft .NET Framework som modulen kräver.

Parameteregenskaper

Parameteruppsättningar

-CmdletsToExport

Anger de cmdletar som modulen exporterar. Jokertecken tillåts.

Använd den här parametern för att begränsa de cmdletar som exporteras av modulen. CmdletsToExport kan ta bort cmdletar från listan över exporterade cmdletar, men det går inte att lägga till cmdletar i listan.

Parameteregenskaper

Parameteruppsättningar

-CompanyName

Anger det företag eller den leverantör som skapade modulen.

Parameteregenskaper

Parameteruppsättningar

-CompatiblePSEditions

Anger de kompatibla PSEditions- i modulen. Information om PSEditionfinns i -moduler med kompatibla PowerShell-utgåvor.

Parameteregenskaper

Parameteruppsättningar

-Confirm

Uppmanar dig att bekräfta innan du kör Update-ModuleManifest.

Parameteregenskaper

Parameteruppsättningar

-Copyright

Anger en copyright-instruktion för modulen.

Parameteregenskaper

Parameteruppsättningar

-DefaultCommandPrefix

Anger standardkommandoprefixet.

Parameteregenskaper

Parameteruppsättningar

-Description

Anger en beskrivning av modulen.

Parameteregenskaper

Parameteruppsättningar

-DotNetFrameworkVersion

Anger den lägsta version av Microsoft .NET Framework som modulen kräver.

Parameteregenskaper

Parameteruppsättningar

-DscResourcesToExport

Anger de DSC-resurser (Desired State Configuration) som modulen exporterar. Jokertecken tillåts.

Parameteregenskaper

Parameteruppsättningar

-ExternalModuleDependencies

Anger en matris med externa modulberoenden.

Parameteregenskaper

Parameteruppsättningar

-FileList

Anger alla objekt som ingår i modulen.

Parameteregenskaper

Parameteruppsättningar

-FormatsToProcess

Anger de formateringsfiler (.ps1xml) som körs när modulen importeras.

När du importerar en modul kör PowerShell cmdleten Update-FormatData med de angivna filerna. Eftersom formateringsfiler inte är begränsade påverkar de alla sessionstillstånd i sessionen.

Parameteregenskaper

Parameteruppsättningar

-FunctionsToExport

Anger de funktioner som modulen exporterar. Jokertecken tillåts.

Använd den här parametern för att begränsa de funktioner som exporteras av modulen. FunctionsToExport kan ta bort funktioner från listan över exporterade alias, men det går inte att lägga till funktioner i listan.

Parameteregenskaper

Parameteruppsättningar

-Guid

Anger en unik identifierare för modulen. GUID kan användas för att skilja mellan moduler med samma namn.

Parameteregenskaper

Parameteruppsättningar

-HelpInfoUri

Anger internetadressen för modulens HelpInfo XML-fil . Ange en URI (Uniform Resource Identifier) som börjar med http eller https.

XML-filen HelpInfo stöder funktionen Updatable Help som introducerades i PowerShell version 3.0. Den innehåller information om platsen för modulens nedladdningsbara hjälpfiler och versionsnumren för de senaste hjälpfilerna för varje språk som stöds.

Information om Updatable Help finns i about_Updatable_Help. Information om XML-filen HelpInfo finns i Support Updatable Help (Stöd för uppdateringsbar hjälp).

Parameteregenskaper

Parameteruppsättningar

-IconUri

Anger URL:en för en ikon för modulen. Den angivna ikonen visas på galleriets webbsida för modulen.

Parameteregenskaper

Parameteruppsättningar

-LicenseUri

Anger URL:en för licensvillkoren för modulen.

Parameteregenskaper

Parameteruppsättningar

-ModuleList

Anger en matris med moduler som ingår i modulen.

Ange varje modulnamn som en sträng eller som en hashtabell med ModuleName- och ModuleVersion nycklar. Hash-tabellen kan också ha en valfri GUID- nyckel. Du kan kombinera strängar och hash-tabeller i parametervärdet.

Den här nyckeln är utformad för att fungera som en modulinventering. Modulerna som anges i värdet för den här nyckeln bearbetas inte automatiskt.

Parameteregenskaper

Parameteruppsättningar

-ModuleVersion

Anger versionen av modulen.

Parameteregenskaper

Parameteruppsättningar

-NestedModules

Anger skriptmoduler (.psm1) och binära moduler (.dll) som importeras till modulens sessionstillstånd. Filerna körs i den ordning som de visas i värdet i nyckeln NestedModules.

Ange varje modulnamn som en sträng eller som en hashtabell med ModuleName- och ModuleVersion nycklar. Hash-tabellen kan också ha en valfri GUID- nyckel. Du kan kombinera strängar och hash-tabeller i parametervärdet.

Parameteregenskaper

Parameteruppsättningar

-PackageManagementProviders

Anger en matris med pakethanteringsprovidrar.

Parameteregenskaper

Parameteruppsättningar

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar Update-ModuleManifest inga utdata.

Parameteregenskaper

Parameteruppsättningar

-Path

Anger sökvägen och filnamnet för modulmanifestet. Ange en sökväg och ett filnamn med filnamnstillägget .psd1, till exempel $PSHOME\Modules\MyModule\MyModule.psd1.

Om du anger sökvägen till en befintlig fil ersätter Update-ModuleManifest filen utan varning såvida inte filen har det skrivskyddade attributet.

Manifestet ska finnas i modulens katalog och manifestfilens namn ska vara samma som modulkatalognamnet, men med ett .psd1 tillägg.

Du kan inte använda variabler, till exempel eller $PSHOME, som $HOME svar på en uppmaning om ett path-parametervärde. Om du vill använda en variabel tar du med parametern Path i kommandot .

Parameteregenskaper

Parameteruppsättningar

-PowerShellHostName

Anger namnet på det PowerShell-värdprogram som modulen kräver. Ange namnet på värdprogrammet, till exempel PowerShell ISE-värd eller ConsoleHost. Jokertecken är inte tillåtna.

Om du vill hitta namnet på ett värdprogram skriver du $Host.Namei programmet .

Parameteregenskaper

Parameteruppsättningar

-PowerShellHostVersion

Anger den lägsta versionen av PowerShell-värdprogrammet som fungerar med modulen. Ange ett versionsnummer, till exempel 1.1.

Parameteregenskaper

Parameteruppsättningar

-PowerShellVersion

Anger den lägsta versionen av PowerShell som ska fungera med den här modulen. Du kan till exempel ange 3.0, 4.0 eller 5.0 som värdet för den här parametern.

Parameteregenskaper

Parameteruppsättningar

-Prerelease

Anger att modulen är förhandsversion.

Parameteregenskaper

Parameteruppsättningar

-PrivateData

Anger data som skickas till modulen när den importeras.

Parameteregenskaper

Parameteruppsättningar

-ProcessorArchitecture

Anger den processorarkitektur som modulen kräver.

De godtagbara värdena för den här parametern är:

• Amd64
• Arm
• IA64
• MSIL (MSIL)
• Ingen (okänd eller ospecificerad)
• X86

Parameteregenskaper

Parameteruppsättningar

-ProjectUri

Anger URL:en för en webbsida om det här projektet.

Parameteregenskaper

Parameteruppsättningar

-ReleaseNotes

Anger en strängmatris som innehåller viktig information eller kommentarer som du vill ska vara tillgänglig för den här versionen av skriptet.

Parameteregenskaper

Parameteruppsättningar

-RequiredAssemblies

Anger de sammansättningsfiler (.dll) som modulen kräver. Ange sammansättningsfilnamnen. PowerShell läser in de angivna sammansättningarna innan du uppdaterar typer eller format, importerar kapslade moduler eller importerar modulfilen som anges i värdet för RootModule nyckel.

Använd den här parametern för att ange alla sammansättningar som krävs för modulen, inklusive sammansättningar som måste läsas in för att uppdatera formaterings- eller typfiler som anges i tangenterna FormatsToProcess eller TypesToProcess , även om dessa sammansättningar också visas som binära moduler i nestedModules-nyckeln .

Parameteregenskaper

Parameteruppsättningar

-RequiredModules

Anger moduler som måste vara i det globala sessionstillståndet. Om de moduler som krävs inte är i det globala sessionstillståndet importerar PowerShell dem. Om de moduler som krävs inte är tillgängliga misslyckas kommandot Import-Module.

Parameteregenskaper

Parameteruppsättningar

-RequireLicenseAcceptance

Anger att en licensgodkännande krävs för modulen.

Parameteregenskaper

Parameteruppsättningar

-RootModule

Anger modulens primära fil eller rotfil. Ange filnamnet för ett skript (.ps1), en skriptmodul (.psm1), ett modulmanifest (.psd1), en sammansättning (.dll), en CMDLET-definitions-XML-fil (.cdxml) eller ett arbetsflöde (.xaml). När modulen importeras importeras de medlemmar som exporteras från rotmodulfilen till anroparens sessionstillstånd.

Om en modul har en manifestfil och ingen rotfil har angetts i RootModule-nyckeln blir manifestet den primära filen för modulen. Och modulen blir en manifestmodul (ModuleType = Manifest).

Om du vill exportera medlemmar från .psm1- eller .dll-filer i en modul som har ett manifest, måste namnen på dessa filer anges i värdena för RootModule eller NestedModules nycklar i manifestet. Annars exporteras inte deras medlemmar.

I PowerShell 2.0 anropades den här nyckeln ModuleToProcess.

Parameteregenskaper

Parameteruppsättningar

-ScriptsToProcess

Anger skriptfiler (.ps1) som körs i anroparens sessionstillstånd när modulen importeras. Du kan använda dessa skript för att förbereda en miljö, precis som du kan använda ett inloggningsskript.

Om du vill ange skript som körs i modulens sessionstillstånd använder du nyckeln NestedModules.

Parameteregenskaper

Parameteruppsättningar

-Tags

Anger en matris med taggar.

Parameteregenskaper

Parameteruppsättningar

-TypesToProcess

Anger de typfiler (.ps1xml) som körs när modulen importeras.

När du importerar modulen kör PowerShell cmdleten Update-TypeData med de angivna filerna. Eftersom typfiler inte är begränsade påverkar de alla sessionstillstånd i sessionen.

Parameteregenskaper

Parameteruppsättningar

-VariablesToExport

Anger de variabler som modulen exporterar. Jokertecken tillåts.

Använd den här parametern för att begränsa de variabler som exporteras av modulen. VariablesToExport kan ta bort variabler från listan över exporterade variabler, men det går inte att lägga till variabler i listan.

Parameteregenskaper

Parameteruppsättningar

-WhatIf

Visar vad som skulle hända om Update-ModuleManifest kördes. Cmdleten körs inte.

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

String

Utdata

Object