Update-PSModuleManifest
Uppdaterar en modulmanifestfil.
Syntax
Default (Standard)
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
Den här cmdleten uppdaterar data som lagras i en modulmanifestfil. Med parametrarna kan du ange vilka egenskaper som ska uppdateras.
Update-PSModuleManifest skriver över befintliga värden i modulmanifestet.
Cmdleten returnerar inte något objekt.
Exempel
Exempel 1
I det här exemplet ändras egenskapen Author i modulmanifestet till New Author.
Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Author 'New Author'
Exempel 2
I det här exemplet ändras egenskapen Prerelease till beta2.
Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Prerelease 'beta2'
Exempel 3
Det här exemplet uppdaterar flera egenskaper.
$parameters = @{
Path = 'C:\MyModules\TestModule'
Tags = 'Windows', 'Linux'
Description = 'A module for managing packages.'
}
Update-PSModuleManifest
Parametrar
-AliasesToExport
Anger de alias som modulen exporterar. Jokertecken tillåts.
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: True
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Author
Anger modulförfattaren.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ClrVersion
Anger den lägsta versionen av COMMON Language Runtime (CLR) för Microsoft .NET Framework som krävs av modulen.
Parameteregenskaper
Typ: Version
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-CmdletsToExport
Anger de cmdletar som modulen exporterar. Jokertecken tillåts.
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: True
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-CompanyName
Anger det företag eller den leverantör som skapade modulen.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-CompatiblePSEditions
Anger de kompatibla PSEditions- i modulen. Information om PSEdition finns i -moduler med kompatibla PowerShell-utgåvor .
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Godkända värden: Desktop, Core
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Copyright
Anger en copyright-instruktion för modulen.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-DefaultCommandPrefix
Anger standardkommandoprefixet.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Description
Anger en beskrivning av modulen.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-DotNetFrameworkVersion
Anger den lägsta versionen av Microsoft .NET Framework som krävs av modulen.
Parameteregenskaper
Typ: Version
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-DscResourcesToExport
Anger de DSC-resurser (Desired State Configuration) som modulen exporterar. Jokertecken tillåts.
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: True
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ExternalModuleDependencies
Anger en matris med externa modulberoenden.
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-FileList
Anger alla objekt som ingår i modulen.
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
Anger de formateringsfiler (.ps1xml) som bearbetas 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.
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-FunctionsToExport
Anger de funktioner som modulen exporterar. Jokertecken tillåts.
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: True
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Guid
Anger en unik identifierare för modulen. Den GUID- används för att skilja mellan moduler med samma namn.
Parameteregenskaper
Typ: Guid
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-HelpInfoUri
Anger internetadressen för modulens HelpInfo XML-fil. Ange en URI (Uniform Resource Identifier) som börjar med http: eller https:.
Mer information finns i Updatable Help .
Parameteregenskaper
Typ: Uri
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-IconUri
Anger URI för en ikon för modulen. Den angivna ikonen visas på galleriets webbsida för modulen.
Parameteregenskaper
Typ: Uri
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-LicenseUri
Anger URL:en för licensvillkoren för modulen.
Parameteregenskaper
Typ: Uri
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ModuleList
Anger en matris med moduler som ingår i modulen.
Ange varje modulnamn som en sträng eller som en hashtable med ModuleName- och ModuleVersion nycklar.
Hashtabellen kan också ha en valfri GUID- nyckel. Du kan kombinera strängar och hashtables i parametervärdet.
Den här nyckeln är utformad för att fungera som en modulinventering.
Parameteregenskaper
Typ: Object [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ModuleVersion
Anger versionen av modulen.
Parameteregenskaper
Typ: Version
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-NestedModules
Anger skriptmoduler (.psm1) och binära moduler (.dll) som importeras till modulens sessionstillstånd. Filerna i NestedModules nyckel körs i den ordning som de visas.
Ange varje modulnamn som en sträng eller som en hashtable med ModuleName- och ModuleVersion nycklar.
Hashtabellen kan också ha en valfri GUID- nyckel. Du kan kombinera strängar och hashtables i parametervärdet.
Parameteregenskaper
Typ: Object [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Path
Anger sökvägen och filnamnet för modulmanifestet. Ange filnamn med filnamnstillägget .psd1.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: 0
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-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.
Namnet på ett värdprogram lagras i $Host.Name.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-PowerShellHostVersion
Anger den lägsta versionen av PowerShell-värdprogrammet som fungerar med modulen. Ange ett versionsnummer, till exempel 1.1.
Parameteregenskaper
Typ: Version
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-PowerShellVersion
Anger den lägsta versionen av PowerShell som fungerar med den här modulen. Du kan till exempel ange versioner som 5.1 eller 7.2.
Parameteregenskaper
Typ: Version
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Prerelease
Anger det förhandsversionsvärde som läggs till i modulversionen. Om till exempel Prerelease är preview och ModuleVersion är 1.0.0är modulversionen 1.0.0-preview.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-PrivateData
Anger data som skickas till modulen när den importeras. Det kan vara godtyckliga värden som lagras i en hashtable.
Parameteregenskaper
Typ: Hashtable
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ProcessorArchitecture
Anger den processorarkitektur som modulen kräver.
De godtagbara värdena för den här parametern är:
Amd64
Arm
IA64
MSIL
None (okänd eller ospecificerad)
X86
Parameteregenskaper
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ProjectUri
Anger URI för en webbsida om det här projektet.
Parameteregenskaper
Typ: Uri
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ReleaseNotes
Anger en sträng som innehåller viktig information eller kommentarer för modulen.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-RequiredAssemblies
Anger de sammansättningsfiler (.dll) som krävs av modulen. PowerShell läser in de angivna sammansättningarna innan du uppdaterar typer eller format, importerar kapslade moduler eller importerar modulfilen som anges i RootModule- nyckel.
Använd RequiredAssemblies för sammansättningar som måste läsas in för att uppdatera formaterings- eller typfiler som anges i FormatToProcess eller TypesToProcess nycklar, även om dessa sammansättningar också visas i NestedModules nyckel.
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-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.
Värdet kan vara en matris som innehåller modulnamn eller modulspecifikationer. En modulspecifikation är en hashtable som har följande nycklar.
ModuleName
-
Obligatoriskt Anger modulnamnet.
GUID
-
Valfri Anger GUID för modulen.
Det är också Krävs för att ange minst en av de tre nycklarna nedan.
ModuleVersion – Anger en lägsta godtagbar version av modulen.
MaximumVersion – Anger den maximala godkända versionen av modulen.
RequiredVersion – Anger en exakt, nödvändig version av modulen. Detta kan inte användas med de andra versionsnycklarna.
Parameteregenskaper
Typ: Object [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-RequireLicenseAcceptance
Anger att en licensgodkännande krävs för modulen.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: False
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-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) eller en XML-fil för cmdlet-definition (.cdxml). När modulen importeras importeras medlemmarna som exporteras från rotmodulen till anroparens sessionstillstånd.
Om en modul har en manifestfil och ingen fil anges i RootModule- nyckel blir manifestet den primära filen för modulen. Modulen kallas för en manifestmodul (ModuleType =
Manifest).
Om du vill exportera medlemmar från .psm1- eller .dll filer måste namnen på filerna anges i värdena för RootModule eller NestedModules nycklar i manifestet.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-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
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
Anger en matris med taggar.
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: Tag
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-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
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-VariablesToExport
Anger de variabler som modulen exporterar. Jokertecken tillåts.
Använd den här parametern för att begränsa vilka variabler som exporteras av modulen.
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: True
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters .
None
Utdata
Kommentarer