Update-Module

  • Referencia
Modul:
PowerShellGet

Letölti és telepíti a megadott modulok legújabb verzióját egy online katalógusból a helyi számítógépre.

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

A Update-Module parancsmag egy modul legújabb verzióját telepíti egy online katalógusból. A rendszer arra kéri, hogy a telepítés előtt erősítse meg a frissítést. Frissítések csak olyan modulokra vannak telepítve, amelyek a helyi számítógépen lettek telepítve a következővel: Install-Module. Update-Module a telepített modulokat $env:PSModulePath keresi.

Ez a Microsoft.PowerShell.PSResourceGet parancsmag proxyparancsmagjaUpdate-PSResource. További információ: Update-PSResource.

Példák

1. példa: Az összes modul frissítése

Ez a példa frissíti az összes telepített modult egy online katalógus legújabb verziójára.

Update-Module

2. példa: Modul frissítése név szerint

Ez a példa egy adott modult frissít egy online katalógus legújabb verziójára.

Update-Module -Name SpeculationControl

Update-Module A Name paraméterrel frissít egy adott modult, a SpeculationControl paramétert.

3. példa: Lehetőségelemzési Update-Module futtatásainak megtekintése

Ez a példa egy lehetőségelemzési forgatókönyvet mutat be, amely azt mutatja be, hogy mi történik, ha Update-Module fut. A parancs nem fut.

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 a WhatIf paramétert használja, és megjeleníti, hogy mi történne, ha Update-Module futna.

4. példa: Modul frissítése egy megadott verzióra

Ebben a példában egy modul egy adott verzióra frissül. A verziónak léteznie kell az online katalógusban, vagy hiba jelenik meg.

Update-Module -Name SpeculationControl -RequiredVersion 1.0.14

Update-Module a Name paramétert használja a Spekulációvezérlő modul megadásához. A RequiredVersion paraméter az 1.0.14-es verziót adja meg.

5. példa: Modul frissítése megerősítés nélkül

Ez a példa nem kér megerősítést a modul online katalógusból származó legújabb verziójára való frissítéséhez. Ha a modul már telepítve van, a Force paraméter újratelepíti a modult.

Update-Module -Name SpeculationControl -Force

Update-Module a Name paramétert használja a Spekulációvezérlő modul megadásához. A Force paraméter felhasználói megerősítés kérése nélkül frissíti a modult.

Paraméterek

-AcceptLicense

A licencszerződés automatikus elfogadása a telepítés során, ha a csomagnak szüksége van rá.

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

-AllowPrerelease

Lehetővé teszi egy modul frissítését az újabb, előzetesként megjelölt modullal.

A proxyparancsmag ezt a paramétert a Prerelease paraméterére Update-PSResourceképezi le.

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

-Confirm

Megerősítést kér a futtatása Update-Moduleelőtt.

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

-Credential

Olyan felhasználói fiókot ad meg, amely engedéllyel rendelkezik egy modul frissítéséhez.

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

-Force

Kényszeríti az egyes modulok frissítését anélkül, hogy megerősítést kérnél. Ha a modul már telepítve van, a Force újratelepíti a modult.

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

-MaximumVersion

A proxyparancsmag ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési Update-PSResourcesztringet a Verzió paraméterrel való használatra.

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

-Name

Egy vagy több frissítendő modul nevét adja meg. Update-Module megkeresi $env:PSModulePath a frissíteni kívánt modulokat. Ha a megadott modulnévhez nem talál $env:PSModulePath egyezést, hiba történik.

A modulnevekben helyettesítő karaktereket fogad el a rendszer. Ha helyettesítő karaktereket ad hozzá a megadott névhez, és nem talál egyezést, nem történik hiba.

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

-PassThru

Egy objektumot ad vissza, amely azt az elemet jelöli, amellyel dolgozik. Alapértelmezés szerint ez a parancsmag nem ad kimenetet.

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

-Proxy

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel a nem támogatja.Update-PSResource

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

-ProxyCredential

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel a nem támogatja.Update-PSResource

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

-RequiredVersion

A proxyparancsmag ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési Update-PSResourcesztringet a Verzió paraméterrel való használatra.

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

-Scope

Megadja a modul telepítési hatókörét. A paraméter elfogadható értékei az AllUsers és a CurrentUser. Ha a Hatókör nincs megadva, a frissítés az CurrentUser hatókörbe lesz telepítve.

Az AllUsers hatókör emelt szintű engedélyeket igényel, és olyan helyre telepíti a modulokat, amely a számítógép összes felhasználója számára elérhető:

$env:ProgramFiles\PowerShell\Modules

A CurrentUser nem igényel emelt szintű engedélyeket, és olyan helyre telepíti a modulokat, amely csak a számítógép aktuális felhasználója számára érhető el:

$HOME\Documents\PowerShell\Modules

Ha nincs megadva hatókör , az alapértelmezett beállítás a PowerShellGet-verzió alapján van beállítva.

  • A PowerShellGet 2.0.0-s és újabb verzióiban az alapértelmezett érték a CurrentUser, amely nem igényel jogosultságszint-emelést a telepítéshez.
  • A PowerShellGet 1.x verzióiban az alapértelmezett érték az AllUsers, amely jogosultságszint-emelést igényel a telepítéshez.
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:CurrentUser
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Megjeleníti, hogy mi történne, ha Update-Module futna. A parancsmag nem fut.

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

Bevitelek

String[]

String

PSCredential

Uri

Kimenetek

Object

Jegyzetek

A PowerShell a következő aliasokat tartalmazza:Update-Module

  • Összes platform:
    • upmo

A PowerShell 6.0-s és újabb verziói esetében az alapértelmezett telepítési hatókör mindig CurrentUser. A CurrentUser modulfrissítéseihez $HOME\Documents\PowerShell\Modulesnincs szükség emelt szintű engedélyekre. Az AllUsers modulfrissítéseinek$env:ProgramFiles\PowerShell\Modules emelt szintű engedélyekre van szükségük.

A PowerShell-galéria már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. A TLS 1.2-s vagy újabb verzióját kell használnia. A következő paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:

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

Update-Module a PowerShell PowerShell 3.0-s vagy újabb kiadásain, a Windows 7-es vagy a Windows 2008 R2-es és újabb kiadásain fut.

Ha a Name paraméterrel megadott modul nem lett telepítve a használatával Install-Module, hiba történik.

Csak az online katalógusból telepített modulokon futtatható Update-Module a parancs futtatásával Install-Module.

Ha Update-Module a használatban lévő bináris fájlok frissítésére tesz kísérletet, hibát ad vissza, Update-Module amely azonosítja a problémafolyamatokat. A felhasználó értesítést kap arról, hogy a folyamatok leállítása után próbálkozzon Update-Module újra.