Update-Module
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. A frissítések csak olyan modulok esetén vannak telepítve, amelyek a helyi számítógépen Install-Modulelettek telepítve.
Update-Module telepített modulokat $env:PSModulePath keres.
Ez egy proxyparancsmag a Update-PSResourceMicrosoft.PowerShell.PSResourceGet parancsmaghoz. 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-Module2. 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 Név paraméterrel frissít egy adott modult, a SpeculationControlt.
3. példa: A Update-Module futtatások megtekintése
Ez a példa egy lehetőségelemzési forgatókönyvet mutat be, amely bemutatja, 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, amely 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 Név paraméter használatával adja meg a SpeculationControl modult. 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 Név paraméter használatával adja meg a SpeculationControl modult. A Force paraméter felhasználói megerősítés kérése nélkül frissíti a modult.
Paraméterek
-AcceptLicense
Ha a csomag megköveteli, a telepítés során automatikusan elfogadja a licencszerződést.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-AllowPrerelease
Lehetővé teszi egy modul frissítését az újabb, előzetesként megjelölt modullal.
A proxy parancsmag ezt a paramétert a prerelease paraméterreUpdate-PSResourceképezi le.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Confirm
Megerősítést kér a Update-Modulefuttatása előtt.
| Típus: | SwitchParameter |
| Aliasok: | cf |
| Position: | Named |
| Alapértelmezett érték: | False |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Credential
Olyan felhasználói fiókot ad meg, amely rendelkezik a modul frissítéséhez szükséges engedéllyel.
| Típus: | PSCredential |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | 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.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-MaximumVersion
A proxyparancsmag ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési sztringet, amely a következő verzióparaméterrelUpdate-PSResourcehasználható: .
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | 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 nem található $env:PSModulePath egyezés a megadott modulnévhez, hiba történik.
A modulnevekben helyettesítő karaktereket fogadunk el. Ha helyettesítő karaktereket ad hozzá a megadott névhez, és nem található egyezés, nem történik hiba.
| Típus: | String[] |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | True |
-PassThru
Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Proxy
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Update-PSResource.
| Típus: | Uri |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-ProxyCredential
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Update-PSResource.
| Típus: | PSCredential |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-RequiredVersion
A proxyparancsmag ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési sztringet, amely a következő verzióparaméterrelUpdate-PSResourcehasználható: .
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-Scope
Megadja a modul telepítési hatókörét. A paraméter elfogadható értékei az AllUsers és a CurrentUser. Ha nincs megadva hatókör , a frissítés telepítve van a CurrentUser hatókörben.
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 definiálva 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 currentUser, amely nem igényel jogosultságszint-emelést a telepítéshez.
- A PowerShellGet 1.x verzióiban az alapértelmezett allUsers, amely a telepítéshez jogosultságszint-emelést igényel.
| Típus: | String |
| Elfogadott értékek: | CurrentUser, AllUsers |
| Position: | Named |
| Alapértelmezett érték: | CurrentUser |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-WhatIf
Megjeleníti, mi történne, ha Update-Module futna. A parancsprogram nem lett futtatva.
| Típus: | SwitchParameter |
| Aliasok: | wi |
| Position: | Named |
| Alapértelmezett érték: | False |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
Bevitelek
String[]
Kimenetek
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Update-Module:
- Minden platform:
upmo
A PowerShell 6.0-s vagy újabb verziója esetén az alapértelmezett telepítési hatókör mindig CurrentUser.
A CurrentUser$HOME\Documents\PowerShell\Modules modulfrissítéseihez nincs 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-katalógus már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. A TLS 1.2 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 fut, Windows 7 vagy Windows 2008 R2 rendszeren, valamint a Windows újabb kiadásain.
Ha a Név paraméterrel megadott modul nem lett telepítve Install-Module, hiba történik.
Csak az online katalógusból telepített modulokat futtathatjaUpdate-Module.Install-Module
Ha Update-Module a használatban lévő bináris fájlok frissítésére tesz kísérletet, Update-Module a problémafolyamatokat azonosító hibát ad vissza. A folyamat leállítása után a rendszer tájékoztatja a felhasználót, hogy próbálkozzon Update-Module újra.
