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 <Version>]
[-MaximumVersion <Version>]
[-Force]
[-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.
Update-Module paraméterek nélkül az összes telepített modul frissül. A frissíteni kívánt modul megadásához használja a Név paramétert. A modul adott verziójára a RequiredVersion paraméterrel frissíthet.
Ha egy telepített modul már a legújabb verzió, a modul nem frissül. Ha a modul nem található $env:PSModulePath, hibaüzenet jelenik meg.
A telepített modulok megjelenítéséhez használja a Get-InstalledModule.
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
-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 |
-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
Egy frissítendő modul maximális verzióját adja meg. Ezt a paramétert nem lehet hozzáadni, ha több modult próbál frissíteni. A MaximumVersion és a RequiredVersion paraméterek nem használhatók ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | Version |
| 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 |
-RequiredVersion
Megadja a meglévő telepített modul frissítésének pontos verzióját. A RequiredVersion által megadott verziónak az online katalógusban kell lennie, vagy hiba jelenik meg. Ha egyetlen parancsban több modul is frissül, nem használhatja RequiredVersion.
Paramétertulajdonságok
| Típus: | Version |
| 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 |
-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.
Jegyzetek
A PowerShell 5.1 vagy újabb verziójának alapértelmezett hatóköre egy emelt szintű munkamenetben AllUsers, és egy nem emelt szintű munkamenetben CurrentUser. A AllUsersmodulfrissítéseinek $env:ProgramFiles\PowerShell\Modulesemelt szintű engedélyekre van szükségük. Az CurrentUsermodulfrissítéseihez nincs szükség emelt szintű engedélyekre $home\Documents\PowerShell\Modules.
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 Name paraméterrel megadott modul nem lett telepítve Install-Modulehasználatával, 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.