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

Příklady

Příklad 1: Aktualizace manifestu modulu

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

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

Update-ModuleManifest @Parms

$Parms jeplat, který ukládá hodnoty parametrů pro Path, Author, CompanyName a Copyright. Update-ModuleManifest získá hodnoty parametrů z @Parms manifestu modulu TestManifest.psd1 a aktualizuje ho.

Parametry

-AliasesToExport

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

Tento parametr použijte k omezení aliasů exportovaných modulem. AliasesToExport může odebrat aliasy ze seznamu exportovaných aliasů, ale do seznamu nemůže přidávat aliasy.

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

-Author

Určuje autora modulu.

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

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

-CmdletsToExport

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

Tento parametr použijte k omezení rutin, které modul exportuje. RutinyToExport můžou odebrat rutiny ze seznamu exportovaných rutin, ale nemůžou do seznamu přidávat rutiny.

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

-CompatiblePSEditions

Určuje kompatibilní psEditions modulu. Informace o psEdition naleznete v tématu Moduly s kompatibilními edicemi PowerShellu.

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

-Confirm

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

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

-Copyright

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

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

-DefaultCommandPrefix

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

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

-Description

Určuje popis modulu.

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

-DotNetFrameworkVersion

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

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

-DscResourcesToExport

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

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

-ExternalModuleDependencies

Určuje pole závislostí externího modulu.

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

-FormatsToProcess

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

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

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

-FunctionsToExport

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

Tento parametr použijte k omezení funkcí, 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
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í mezi moduly se stejným názvem.

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

-HelpInfoUri

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

Soubor HelpInfo XML podporuje funkci Aktualizovatelná nápověda, která byla představena 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 HelpInfo XML naleznete v tématu Podpora aktualizovatelné nápovědy.

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

-LicenseUri

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

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

-ModuleList

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

Zadejte název každého modulu jako řetězec nebo jako tabulku hash pomocí klíčů 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 automaticky nezpracují.

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

-ModuleVersion

Určuje verzi modulu.

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

-NestedModules

Určuje moduly skriptů () a binární moduly (.psm1.dll), které se importují do stavu relace modulu. Soubory v klíči NestedModules běží v pořadí, ve kterém jsou uvedeny v hodnotě.

Zadejte název každého modulu jako řetězec nebo jako tabulku hash pomocí klíčů 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
Accept pipeline input:False
Accept wildcard characters:False

-PackageManagementProviders

Určuje pole poskytovatelů správy balíčků.

Type:String[]
Position:Named
Default value:None
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 nevygeneruje žádný výstup.

Type:SwitchParameter
Position:Named
Default value:None
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é, například $PSHOME nebo $HOME, nemůžete použít v reakci na výzvu k zadání hodnoty parametru Path . Pokud chcete použít proměnnou, zahrňte parametr Path do příkazu.

Type:String
Position:0
Default value:None
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, jako je například hostitel ISE PowerShellu nebo ConsoleHost. Zástupné cardy nejsou povolené.

Chcete-li najít název hostitelského programu, zadejte $Host.Namev programu .

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

-PowerShellHostVersion

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

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

-PowerShellVersion

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

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

-Prerelease

Označuje, že je modul předem připravený.

Type:String
Position:Named
Default value:None
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
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
  • Paže
  • IA64
  • MSIL
  • Žádná (neznámá nebo nezadaná)
  • 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

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

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

-ReleaseNotes

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

Type:String[]
Position:Named
Default value:None
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 zadaného v hodnotě klíče RootModule .

Tento parametr použijte k určení všech sestavení, která modul vyžaduje, včetně sestavení, která je třeba načíst, aby se aktualizovaly všechny formátovací nebo typové soubory uvedené v klíčích FormatsToProcess nebo TypesToProcess , i když jsou tato sestavení také uvedena jako binární moduly v klíči NestedModules .

Type:String[]
Position:Named
Default value:None
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 dostupné, Import-Module příkaz selže.

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

-RequireLicenseAcceptance

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

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

-RootModule

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

Pokud modul obsahuje 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.dll modulu, který má manifest, musí být názvy těchto souborů zadány v hodnotách klíče RootModule nebo NestedModules v manifestu. Jinak se jejich členové nevyexportují.

V PowerShellu 2.0 se tento klíč nazývá ModuleToProcess.

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

-ScriptsToProcess

Určuje soubory skriptu (.ps1), které se spouští 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 zadat skripty, které se spouští ve stavu relace modulu, použijte klíč NestedModules .

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

-Tags

Určuje pole značek.

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

-TypesToProcess

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

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

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

-VariablesToExport

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

Tento parametr použijte k omezení proměnných exportovaných modulem. ProměnnéToExport mohou odebrat proměnné ze seznamu exportovaných proměnných, ale do seznamu nemůžou přidávat proměnné.

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

-WhatIf

Ukazuje, co by se stalo, když Update-ModuleManifest se spustí. Rutina se nespustí.

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

Vstupy

String

Výstupy

Object

Poznámky

Důležité

Od dubna 2020 už Galerie prostředí PowerShell nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Pokud nepoužíváte protokol TLS 1.2 nebo novější, při pokusu o přístup k Galerie prostředí PowerShell se zobrazí chyba. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Další informace najdete v oznámení v blogu PowerShellu.