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
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
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-Module.
Update-Module a telepített modulok $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-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, SpeculationControl.
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 megmutatja, 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 azt jeleníti meg, 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 modul megadásához, SpeculationControl. A RequiredVersion paraméter az 1.0.14 -es verziójú.
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 modul megadásához, SpeculationControl. 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.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Confirm
Megerősítést kér a Update-Modulefuttatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Credential
Olyan felhasználói fiókot ad meg, amely rendelkezik a modul frissítéséhez szükséges engedéllyel.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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, kényszerítse újratelepíti a modult.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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ó: .
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Egy vagy több frissítendő modul nevét adja meg.
Update-Module megkeresi $env:PSModulePath a frissítendő modulokat. Ha a megadott modulnév $env:PSModulePath nem talál egyezést, 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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-PassThru
Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Proxy
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Update-PSResource.
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-ProxyCredential
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Update-PSResource.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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ó: .
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | CurrentUser |
| Elfogadott értékek: | CurrentUser, AllUsers |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha Update-Module futna. A parancsprogram nem lett futtatva.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
String
String
PSCredential
Uri
Kimenetek
Object
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.
Az CurrentUsermodulfrissítéseihez nincs szükség emelt szintű engedélyekre $HOME\Documents\PowerShell\Modules. A AllUsersmodulfrissítéseinek $env:ProgramFiles\PowerShell\Modulesemelt 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 modulokon futtathat Update-Module az Install-Modulefuttatásával.
Ha Update-Module megpróbálja frissíteni a használatban lévő bináris fájlokat, Update-Module hibát ad vissza, 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 újra Update-Module.
