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