Update-Module
Stáhne a nainstaluje nejnovější verzi zadaných modulů z online galerie do místního počítače.
Syntax
All
Update-Module
[[-Name] <String[]>]
[-RequiredVersion <String>]
[-MaximumVersion <String>]
[-Credential <PSCredential>]
[-Scope <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Update-Module nainstaluje nejnovější verzi modulu z online galerie. Před instalací se zobrazí výzva k potvrzení aktualizace. Aktualizace jsou nainstalovány pouze pro moduly, které byly nainstalovány v místním počítači s Install-Module.
Update-Module hledá nainstalované moduly $env:PSModulePath.
Update-Module bez parametrů zadaných aktualizací všech nainstalovaných modulů. Pokud chcete zadat modul, který se má aktualizovat, použijte parametr Name. K aktualizaci na konkrétní verzi modulu můžete použít parametr RequiredVersion.
Pokud už je nainstalovaný modul nejnovější verzí, modul se neaktualizuje. Pokud se modul v $env:PSModulePathnenajde, zobrazí se chyba.
K zobrazení nainstalovaných modulů použijte Get-InstalledModule.
Příklady
Příklad 1: Aktualizace všech modulů
Tento příklad aktualizuje všechny nainstalované moduly na nejnovější verzi v online galerii.
Update-Module
Příklad 2: Aktualizace modulu podle názvu
Tento příklad aktualizuje konkrétní modul na nejnovější verzi v online galerii.
Update-Module -Name SpeculationControl
Update-Module používá parametr Name k aktualizaci konkrétního modulu .
Příklad 3: Zobrazení Update-Module spuštění citlivosti
V tomto příkladu se zobrazí scénář citlivostní dokumentace, který ukazuje, co se stane, když se Update-Module spustí. Příkaz se nespustí.
Update-Module -WhatIf
What if: Performing the operation "Update-Module" on target "Version '2.8.0' of module
'Carbon', updating to version '2.8.1'".
What if: Performing the operation "Update-Module" on target "Version '1.0.10' of module
'SpeculationControl', updating to version '1.0.14'".
Update-Module používá parametr WhatIf display what would happen if Update-Module were run.
Příklad 4: Aktualizace modulu na zadanou verzi
V tomto příkladu se modul aktualizuje na konkrétní verzi. Verze musí existovat v online galerii nebo se zobrazí chyba.
Update-Module -Name SpeculationControl -RequiredVersion 1.0.14
Update-Module používá parametr Name k určení modulu . Parametr RequiredVersion určuje verzi 1.0.14.
Příklad 5: Aktualizace modulu bez potvrzení
Tento příklad nepožaduje potvrzení o aktualizaci modulu na nejnovější verzi z online galerie. Pokud je modul již nainstalovaný, parametr Force modul přeinstaluje.
Update-Module -Name SpeculationControl -Force
Update-Module používá parametr Name k určení modulu . Parametr Force aktualizuje modul bez vyžádání potvrzení uživatele.
Parametry
-AcceptLicense
Pokud balíček vyžaduje, automaticky přijměte licenční smlouvu během instalace.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-AllowPrerelease
Umožňuje aktualizovat modul s novějším modulem označeným jako předběžná verze.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním Update-Modulevás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Credential
Určuje uživatelský účet, který má oprávnění k aktualizaci modulu.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Force
Vynutí aktualizaci každého zadaného modulu bez výzvy k potvrzení. Pokud už je modul nainstalovaný, Vynutit modul znovu nainstaluje.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-MaximumVersion
Určuje maximální verzi jednoho modulu, který se má aktualizovat. Tento parametr nelze přidat, pokud se pokoušíte aktualizovat více modulů. MaximumVersion a parametry RequiredVersion nelze použít ve stejném příkazu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje názvy jednoho nebo více modulů, které se mají aktualizovat.
Update-Module prohledá $env:PSModulePath moduly, které se mají aktualizovat. Pokud se v $env:PSModulePath pro zadaný název modulu nenajde žádná shoda, dojde k chybě.
Zástupné cardy se přijímají v názvech modulů. Pokud k zadanému názvu přidáte zástupné znaky a nenajdete žádné shody, nedojde k žádné chybě.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Proxy
Určuje proxy server pro požadavek místo přímého připojení k internetovému prostředku.
Vlastnosti parametru
| Typ: | Uri |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-ProxyCredential
Určuje uživatelský účet, který má oprávnění používat proxy server určený parametrem proxy .
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-RequiredVersion
Určuje přesnou verzi, na kterou se bude aktualizovat existující nainstalovaný modul. Verze zadaná RequiredVersion musí existovat v online galerii nebo se zobrazí chyba. Pokud je v jednom příkazu aktualizováno více než jeden modul, nemůžete použít RequiredVersion.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Scope
Určuje rozsah instalace modulu. Přijatelné hodnoty pro tento parametr jsou AllUsers a CurrentUser. Pokud není zadaný obor , aktualizace se nainstaluje do oboru CurrentUser .
Obor AllUsers vyžaduje zvýšená oprávnění a instaluje moduly do umístění, které je přístupné všem uživatelům počítače:
$env:ProgramFiles\PowerShell\Modules
CurrentUser nevyžaduje zvýšená oprávnění a instaluje moduly do umístění, které je přístupné pouze aktuálnímu uživateli počítače:
$home\Documents\PowerShell\Modules
Pokud není definován žádný obor , nastaví se výchozí nastavení na základě verze PowerShellGet.
- Ve verzi PowerShellGet 2.0.0 a vyšší je výchozí hodnota CurrentUser, která nevyžaduje zvýšení oprávnění pro instalaci.
- Ve verzích PowerShellGet 1.xch
Vlastnosti parametru
| Typ: | String |
| Default value: | CurrentUser |
| Přípustné hodnoty: | CurrentUser, AllUsers |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co by se stalo, když se Update-Module spustí. Cmdlet se nespustil.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
String
PSCredential
Uri
Výstupy
Object
Poznámky
Pro PowerShell verze 6.0 a vyšší je výchozí instalační obor vždy CurrentUser.
Aktualizace modulů pro CurrentUser, $home\Documents\PowerShell\Modulesnepotřebují zvýšená oprávnění. Aktualizace modulů pro AllUsers, $env:ProgramFiles\PowerShell\Modulespotřebují zvýšená oprávnění.
Důležité
Od dubna 2020 galerie Prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Pokud nepoužíváte protokol TLS 1.2 nebo vyšší, při pokusu o přístup k galerii 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.
Update-Module běží v PowerShellu 3.0 nebo novějších verzích PowerShellu, ve Windows 7 nebo Windows 2008 R2 a novějších verzích Windows.
Pokud modul zadaný pomocí parametru Name nebyl nainstalován pomocí Install-Module, dojde k chybě.
Na modulech, které jste nainstalovali z online galerie, můžete spustit pouze Update-Module spuštěním Install-Module.
Pokud Update-Module pokusí aktualizovat používané binární soubory, Update-Module vrátí chybu, která identifikuje procesy problému. Uživatel je informován, aby po zastavení procesů zkusil opakovat Update-Module.