Sdílet prostřednictvím


Update-ModuleManifest

Aktualizace soubor manifestu modulu.

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

Rutina Update-ModuleManifest aktualizuje soubor manifestu modulu (.psd1).

Toto je rutina proxy pro rutinu Update-PSModuleManifest v Microsoft.PowerShell.PSResourceGet. Další informace najdete v tématu Update-PSModuleManifest.

Příklady

Příklad 1: Aktualizace manifestu modulu

Tento příklad aktualizuje existující soubor manifestu modulu. Splatting slouží k předání hodnot parametrů do Update-ModuleManifest. Další informace najdete v tématu about_Splatting.

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

Update-ModuleManifest @Params

$Params je splat, který ukládá hodnoty parametrů Path, Author, CompanyName a Copyright. Update-ModuleManifest získá hodnoty parametrů z @Params a aktualizuje manifest modulu TestManifest.psd1.

Parametry

-AliasesToExport

Určuje aliasy, které modul exportuje. Jsou povoleny zástupné y.

Pomocí tohoto parametru můžete omezit aliasy, které modul exportuje. AliasesToExport může odebrat aliasy ze seznamu exportovaných aliasů, ale nemůže přidat aliasy do seznamu.

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

-Author

Určuje autora modulu.

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

-ClrVersion

Určuje minimální verzi modulu CLR (Common Language Runtime) rozhraní Microsoft .NET Framework, kterou modul vyžaduje.

Poznámka

Toto nastavení je platné pouze pro edici PowerShell Desktopu, například Windows PowerShell 5.1, a platí jenom pro .NET Framework verze nižší než 4.5. Tento požadavek nemá žádný vliv na novější verze PowerShellu nebo rozhraní .NET Framework.

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

-CmdletsToExport

Určuje rutiny, které modul exportuje. Jsou povoleny zástupné y.

Pomocí tohoto parametru můžete omezit rutiny, které modul exportuje. Rutiny RutinyToExport může odebrat rutiny ze seznamu exportovaných rutin, ale nemůže přidat rutiny do seznamu.

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

-CompanyName

Určuje společnost nebo dodavatele, který modul vytvořil.

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

-CompatiblePSEditions

Určuje kompatibilní PSEditions modulu. Informace o PSEdition najdete v tématu Moduly s kompatibilními edicemi PowerShellu.

Type:String[]
Accepted values:Desktop, Core
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Zobrazí výzvu k potvrzení před spuštěním příkazu Update-ModuleManifest.

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

Určuje prohlášení o autorských právech pro modul.

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

-DefaultCommandPrefix

Určuje výchozí předponu příkazu.

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

-Description

Určuje popis modulu.

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

-DotNetFrameworkVersion

Určuje minimální verzi rozhraní Microsoft .NET Framework, kterou modul vyžaduje.

Poznámka

Toto nastavení je platné pouze pro edici PowerShell Desktopu, například Windows PowerShell 5.1, a platí jenom pro .NET Framework verze nižší než 4.5. Tento požadavek nemá žádný vliv na novější verze PowerShellu nebo rozhraní .NET Framework.

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

-DscResourcesToExport

Určuje prostředky Desired State Configuration (DSC), které modul exportuje. Jsou povoleny zástupné y.

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

-ExternalModuleDependencies

Určuje pole závislostí externích modulů.

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

-FileList

Určuje všechny položky, které jsou součástí modulu.

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

-FormatsToProcess

Určuje formátovací soubory (.ps1xml), které se spustí při importu modulu.

Při importu modulu PowerShell spustí rutinu Update-FormatData se zadanými soubory. Vzhledem k tomu, že soubory formátování nejsou vymezené, mají vliv na všechny stavy relace v relaci.

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

-FunctionsToExport

Určuje funkce, které modul exportuje. Jsou povoleny zástupné y.

Pomocí tohoto parametru můžete omezit funkce, které modul exportuje. FunctionsToExport může odebrat funkce ze seznamu exportovaných aliasů, ale nemůže do seznamu přidávat funkce.

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

-Guid

Určuje jedinečný identifikátor modulu. Identifikátor GUID lze použít k rozlišení modulů se stejným názvem.

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

-HelpInfoUri

Určuje internetovou adresu souboru XML HelpInfo modulu. Zadejte identifikátor URI (Uniform Resource Identifier), který začíná na http nebo https.

Soubor XML HelpInfo podporuje funkci aktualizovatelné nápovědy, která byla zavedena v PowerShellu verze 3.0. Obsahuje informace o umístění souborů nápovědy ke stažení modulu a čísla verzí nejnovějších souborů nápovědy pro každé podporované národní prostředí.

Informace o aktualizovatelné nápovědě najdete v tématu about_Updatable_Help. Informace o souboru XML HelpInfo najdete v tématu Podpora aktualizovatelné nápovědy.

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

-IconUri

Určuje adresu URL ikony modulu. Zadaná ikona se zobrazí na webové stránce galerie modulu.

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

-LicenseUri

Určuje adresu URL licenčních podmínek pro modul.

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

-ModuleList

Určuje pole modulů, které jsou součástí modulu.

Zadejte názvy jednotlivých modulů jako řetězec nebo jako hashovací tabulku s klíči ModuleName a ModuleVersion . Tabulka hash může mít také volitelný klíč GUID . V hodnotě parametru můžete zkombinovat řetězce a tabulky hash.

Tento klíč je navržený tak, aby fungoval jako inventář modulů. Moduly uvedené v hodnotě tohoto klíče se nezpracují automaticky.

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

-ModuleVersion

Určuje verzi modulu.

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

-NestedModules

Určuje moduly skriptu (.psm1) a binární moduly (.dll), které se importují do stavu relace modulu. Soubory v klíči NestedModules se spouští v pořadí, ve kterém jsou uvedené v hodnotě.

Zadejte názvy jednotlivých modulů jako řetězec nebo jako hashovací tabulku s klíči ModuleName a ModuleVersion . Tabulka hash může mít také volitelný klíč GUID . V hodnotě parametru můžete zkombinovat řetězce a tabulky hash.

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

-PackageManagementProviders

Určuje pole zprostředkovatelů správy balíčků.

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

-PassThru

Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení Update-ModuleManifest negeneruje žádný výstup.

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

-Path

Určuje cestu a název souboru manifestu modulu. Zadejte cestu a název souboru s příponou .psd1 názvu souboru, například $PSHOME\Modules\MyModule\MyModule.psd1.

Pokud zadáte cestu k existujícímu souboru, nahradí soubor bez upozornění, Update-ModuleManifest pokud soubor nemá atribut jen pro čtení.

Manifest by měl být umístěný v adresáři modulu a název souboru manifestu by měl být stejný jako název adresáře modulu, ale s příponou .psd1 .

Proměnné, jako $PSHOME$HOMEje nebo , nemůžete použít jako odpověď na výzvu k zadání hodnoty parametru Path . Pokud chcete použít proměnnou, zahrňte do příkazu parametr Path .

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

-PowerShellHostName

Určuje název hostitelského programu PowerShellu, který modul vyžaduje. Zadejte název hostitelského programu, například PowerShell ISE Host nebo ConsoleHost. Zástupné cardy nejsou povolené.

Pokud chcete najít název hostitelského programu, zadejte do programu .$Host.Name

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

-PowerShellHostVersion

Určuje minimální verzi hostitelského programu PowerShellu, která s modulem funguje. Zadejte číslo verze, například 1.1.

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

-PowerShellVersion

Určuje minimální verzi PowerShellu, která bude s tímto modulem fungovat. Jako hodnotu tohoto parametru můžete například zadat 3.0, 4.0 nebo 5.0.

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

-Prerelease

Označuje, že modul je předběžně připravený.

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

-PrivateData

Určuje data, která se předávají modulu při importu.

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

-ProcessorArchitecture

Určuje architekturu procesoru, kterou modul vyžaduje.

Tento parametr přijímá tyto hodnoty:

  • Amd64
  • Rameno
  • IA64
  • MSIL
  • Žádný (neznámý nebo nespecifikovaný)
  • 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

Určuje adresu URL webové stránky o tomto projektu.

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

-ReleaseNotes

Určuje pole řetězců obsahující poznámky k verzi nebo komentáře, které chcete pro tuto verzi skriptu zpřístupnit.

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

-RequiredAssemblies

Určuje soubory sestavení (.dll), které modul vyžaduje. Zadejte názvy souborů sestavení. PowerShell načte zadaná sestavení před aktualizací typů nebo formátů, importem vnořených modulů nebo importem souboru modulu, který je zadán v hodnotě klíče RootModule .

Pomocí tohoto parametru můžete určit všechna sestavení, která modul vyžaduje, včetně sestavení, která musí být načtena k aktualizaci souborů formátování nebo typů, které jsou uvedeny v klíčích FormatsToProcess nebo TypesToProcess , a to i v případě, že jsou tato sestavení uvedena také jako binární moduly v klíči NestedModules .

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

-RequiredModules

Určuje moduly, které musí být ve stavu globální relace. Pokud požadované moduly nejsou ve stavu globální relace, PowerShell je naimportuje. Pokud požadované moduly nejsou k dispozici, Import-Module příkaz selže.

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

-RequireLicenseAcceptance

Určuje, že modul vyžaduje přijetí licence.

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

-RootModule

Určuje primární nebo kořenový soubor modulu. Zadejte název souboru skriptu (.ps1), modulu skriptu (.psm1), manifestu modulu modulu (.psd1), sestavení (.dll), souboru XML definice rutiny (.cdxml) nebo pracovního postupu (.xaml). Při importu modulu se členy exportované z kořenového souboru modulu naimportují do stavu relace volajícího.

Pokud má modul soubor manifestu a v klíči RootModule nebyl zadán žádný kořenový soubor, stane se manifest primárním souborem modulu. A modul se stane modulem manifestu (ModuleType = Manifest).

Chcete-li exportovat členy z .psm1 nebo .dll soubory v modulu, který má manifest, musí být názvy těchto souborů zadány v hodnotách klíčů RootModule nebo NestedModules v manifestu . Jinak se jejich členové neexportují.

V PowerShellu 2.0 se tento klíč jmenoval ModuleToProcess.

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

-ScriptsToProcess

Určuje soubory skriptu (.ps1), které běží ve stavu relace volajícího při importu modulu. Tyto skripty můžete použít k přípravě prostředí, stejně jako můžete použít přihlašovací skript.

Pokud chcete určit skripty, které se spouštějí ve stavu relace modulu, použijte klíč NestedModules .

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

-Tags

Určuje pole značek.

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

-TypesToProcess

Určuje soubory typu (.ps1xml), které se spouštějí při importu modulu.

Při importu modulu PowerShell spustí rutinu Update-TypeData se zadanými soubory. Vzhledem k tomu, že soubory typu nejsou vymezeny, mají vliv na všechny stavy relace v relaci.

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

-VariablesToExport

Určuje proměnné, které modul exportuje. Jsou povoleny zástupné y.

Pomocí tohoto parametru můžete omezit proměnné, které modul exportuje. VariablesToExport může odebrat proměnné ze seznamu exportovaných proměnných, ale nemůže přidat proměnné do seznamu.

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

-WhatIf

Ukazuje, co by se stalo při Update-ModuleManifest spuštění. Rutina se nespustí.

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

Vstupy

String

Výstupy

Object