Sdílet prostřednictvím

Update-Module

  • Reference
Modul:
PowerShellGet

Stáhne a nainstaluje nejnovější verzi zadaných modulů z online galerie do místního počítače.

Syntax

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 pomocí Install-Modulenástroje . Update-Module vyhledá nainstalované moduly $env:PSModulePath .

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

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 , SpeculationControl.

Příklad 3: Zobrazení citlivostní analýzy Update-Module spuštění

Tento příklad vytvoří scénář citlivostní analýzy, který ukazuje, co se stane, když Update-Module se 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 pomocí parametru WhatIf zobrazí, co by se stalo, kdyby Update-Module byly spuštěny.

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, jinak se zobrazí chyba.

Update-Module -Name SpeculationControl -RequiredVersion 1.0.14

Update-Module použije parametr Name k zadání modulu , SpeculationControl. Parametr RequiredVersion určuje verzi 1.0.14.

Příklad 5: Aktualizace modulu bez potvrzení

Tento příklad nevyžaduje potvrzení aktualizace 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žije parametr Name k zadání modulu , SpeculationControl. Parametr Force aktualizuje modul bez vyžádání potvrzení uživatele.

Parametry

-AcceptLicense

Automaticky přijmout licenční smlouvu během instalace, pokud to balíček vyžaduje.

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

-AllowPrerelease

Umožňuje aktualizovat modul s novějším modulem označeným jako předběžné vydání.

Rutina proxy serveru mapuje tento parametr na parametr Prerelease parametru .Update-PSResource

Type:SwitchParameter
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-Module.

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

-Credential

Určuje uživatelský účet, který má oprávnění k aktualizaci modulu.

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

-Force

Vynutí aktualizaci každého zadaného modulu bez výzvy k žádosti o potvrzení. Pokud už je modul nainstalovaný, vynutit ho znovu nainstaluje.

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

-MaximumVersion

Rutina proxy používá hodnotu tohoto parametru k vytvoření vyhledávacího řetězce verze NuGet pro použití s parametrem Version parametru .Update-PSResource

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

-Name

Určuje názvy jednoho nebo více modulů, které se mají aktualizovat. Update-Module vyhledá moduly $env:PSModulePath , které chcete aktualizovat. Pokud se v $env:PSModulePath zadaném názvu 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ě.

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

-PassThru

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

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

-Proxy

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje Update-PSResource.

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

-ProxyCredential

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje Update-PSResource.

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

-RequiredVersion

Rutina proxy používá hodnotu tohoto parametru k vytvoření vyhledávacího řetězce verze NuGet pro použití s parametrem Version parametru .Update-PSResource

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

-Scope

Určuje rozsah instalace modulu. Přijatelné hodnoty pro tento parametr jsou AllUsers a CurrentUser. Pokud obor není zadaný, aktualizace se nainstaluje do oboru CurrentUser .

Obor AllUsers vyžaduje zvýšená oprávnění a nainstaluje 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 nainstaluje moduly do umístění, které je přístupné jenom aktuálnímu uživateli počítače:

$HOME\Documents\PowerShell\Modules

Pokud není definován žádný obor , nastaví se výchozí hodnota na základě verze PowerShellGet.

  • Ve verzi PowerShellGet 2.0.0 a novějších je výchozí hodnota CurrentUser, která nevyžaduje zvýšení oprávnění k instalaci.
  • Ve verzích PowerShellGet 1.x je výchozí hodnota AllUsers, která vyžaduje zvýšení oprávnění k instalaci.
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:CurrentUser
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Ukazuje, co by se stalo při Update-Module 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[]

String

PSCredential

Uri

Výstupy

Object

Poznámky

PowerShell obsahuje následující aliasy pro Update-Module:

  • Všechny platformy:
    • upmo

Pro PowerShell verze 6.0 a vyšší je výchozím oborem instalace vždy CurrentUser. Aktualizace modulů pro CurrentUser, $HOME\Documents\PowerShell\Modules, nepotřebují zvýšená oprávnění. Aktualizace modulů pro AllUsers, $env:ProgramFiles\PowerShell\Modules, vyžadují zvýšená oprávnění.

Galerie prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Musíte použít protokol TLS 1.2 nebo novější. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

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

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, který zadáte pomocí parametru Name , nebyl nainstalován pomocí Install-Modulenástroje , dojde k chybě.

Spuštěním příkazu můžete spustit Update-Module pouze moduly, které jste nainstalovali Install-Modulez online galerie.

Při Update-Module pokusu o aktualizaci binárních souborů, které se používají, Update-Module vrátí chybu, která identifikuje problémové procesy. Uživatel je informován, aby to zkusil Update-Module znovu po zastavení procesů.