Update-Module
Lädt die neueste Version der angegebenen Module aus einem Onlinekatalog auf den lokalen Computer herunter und installiert sie.
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>]
Beschreibung
Das Update-Module Cmdlet installiert die neueste Version eines Moduls aus einem Onlinekatalog. Sie werden aufgefordert, das Update zu bestätigen, bevor es installiert wird. Updates werden nur für Module installiert, die auf dem lokalen Computer mit Install-Moduleinstalliert wurden.
Update-Module sucht nach $env:PSModulePath installierten Modulen.
Dies ist ein Proxy-Cmdlet für das Update-PSResource Cmdlet in microsoft.PowerShell.PSResourceGet. Weitere Informationen finden Sie unter Update-PSResource.
Beispiele
Beispiel 1: Aktualisieren aller Module
In diesem Beispiel werden alle installierten Module auf die neueste Version in einem Onlinekatalog aktualisiert.
Update-Module
Beispiel 2: Aktualisieren eines Moduls anhand des Namens
In diesem Beispiel wird ein bestimmtes Modul auf die neueste Version in einem Onlinekatalog aktualisiert.
Update-Module -Name SpeculationControl
Update-Module verwendet den Parameter Name , um ein bestimmtes Modul, SpeculationControl, zu aktualisieren.
Beispiel 3: Anzeigen von Was-wäre-wenn-Update-Module ausgeführt wird
In diesem Beispiel wird ein Was-wäre-wenn-Szenario ausgeführt, um zu zeigen, was geschieht, wenn Update-Module sie ausgeführt wird. Der Befehl wird nicht ausgeführt.
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 verwendet den WhatIf-Parameter , um anzuzeigen, was bei Update-Module Ausführung geschehen würde.
Beispiel 4: Aktualisieren eines Moduls auf eine angegebene Version
In diesem Beispiel wird ein Modul auf eine bestimmte Version aktualisiert. Die Version muss im Onlinekatalog vorhanden sein, oder es wird ein Fehler angezeigt.
Update-Module -Name SpeculationControl -RequiredVersion 1.0.14
Update-Module verwendet den Parameter Name , um das Modul " SpeculationControl" anzugeben. Der Parameter RequiredVersion gibt die Version 1.0.14 an.
Beispiel 5: Aktualisieren eines Moduls ohne Bestätigung
In diesem Beispiel wird keine Bestätigung zum Aktualisieren des Moduls auf die neueste Version aus einem Onlinekatalog angefordert. Wenn das Modul bereits installiert ist, installiert der Parameter Force das Modul erneut.
Update-Module -Name SpeculationControl -Force
Update-Module verwendet den Parameter Name , um das Modul " SpeculationControl" anzugeben. Der Force-Parameter aktualisiert das Modul, ohne eine Benutzerbestätigung anzufordern.
Parameter
-AcceptLicense
Akzeptieren Sie den Lizenzvertrag während der Installation automatisch, wenn das Paket dies erfordert.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-AllowPrerelease
Ermöglicht es Ihnen, ein Modul mit dem neueren Modul zu aktualisieren, das als Vorabversionen gekennzeichnet ist.
Das Proxy-Cmdlet ordnet diesen Parameter dem Parameter Prerelease von Update-PSResource.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Update-Module ausgeführt wird.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Aktualisieren eines Moduls verfügt.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Force
Erzwingt eine Aktualisierung jedes angegebenen Moduls ohne Aufforderung zur Bestätigung. Wenn das Modul bereits installiert ist, installiert Force das Modul erneut.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MaximumVersion
Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge für die Verwendung mit dem Parameter "Version " Update-PSResourcezu erstellen.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt die Namen eines oder mehrerer module an, die aktualisiert werden sollen.
Update-Module sucht nach $env:PSModulePath den zu aktualisierenden Modulen. Wenn für den angegebenen Modulnamen keine Übereinstimmungen gefunden $env:PSModulePath werden, tritt ein Fehler auf.
Wildcards werden in Modulnamen akzeptiert. Wenn Sie dem angegebenen Namen Wildcardzeichen hinzufügen und keine Übereinstimmungen gefunden werden, tritt kein Fehler auf.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-PassThru
Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet keine Ausgabe.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Proxy
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Update-PSResource.
Parametereigenschaften
| Typ: | Uri |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ProxyCredential
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Update-PSResource.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-RequiredVersion
Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge für die Verwendung mit dem Parameter "Version " Update-PSResourcezu erstellen.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Scope
Gibt den Installationsumfang des Moduls an. Die zulässigen Werte für diesen Parameter sind AllUsers und CurrentUser. Wenn "Bereich " nicht angegeben ist, wird das Update im CurrentUser-Bereich installiert.
Der Bereich "AllUsers " erfordert erhöhte Berechtigungen und installiert Module an einem Speicherort, auf den alle Benutzer des Computers zugreifen können:
$env:ProgramFiles\PowerShell\Modules
Der CurrentUser erfordert keine erhöhten Berechtigungen und installiert Module an einem Speicherort, auf den nur der aktuelle Benutzer des Computers zugreifen kann:
$HOME\Documents\PowerShell\Modules
Wenn kein Bereich definiert ist, wird der Standardwert basierend auf der PowerShellGet-Version festgelegt.
- In PowerShellGet-Versionen 2.0.0 und höher ist "CurrentUser" standardmäßig "CurrentUser", für das keine Erhöhung für die Installation erforderlich ist.
- In PowerShellGet 1.x-Versionen ist die Standardeinstellung "AllUsers", für die eine Erhöhung für die Installation erforderlich ist.
Parametereigenschaften
| Typ: | String |
| Standardwert: | CurrentUser |
| Zulässige Werte: | CurrentUser, AllUsers |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn Update-Module ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
String
String
PSCredential
Uri
Ausgaben
Object
Hinweise
PowerShell enthält die folgenden Aliase für Update-Module:
- Alle Plattformen:
upmo
Für PowerShell, Version 6.0 und höher, ist der Standardinstallationsbereich immer CurrentUser.
Modulupdates für CurrentUser, $HOME\Documents\PowerShell\Modulesbenötigen keine erhöhten Berechtigungen.
Modulupdates für AllUsers, $env:ProgramFiles\PowerShell\Modulesbenötigen erhöhte Berechtigungen.
Der PowerShell-Katalog unterstützt die Tls-Versionen 1.0 und 1.1 nicht mehr. Sie müssen TLS 1.2 oder höher verwenden. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass Sie TLS 1.2 verwenden:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
Update-Module wird auf PowerShell 3.0- oder höher-Versionen von PowerShell, unter Windows 7 oder Windows 2008 R2 und höheren Versionen von Windows ausgeführt.
Wenn das mit dem Parameter Name angegebene Modul nicht mithilfe Install-Moduledes Namensparameters installiert wurde, tritt ein Fehler auf.
Sie können nur auf Modulen ausgeführt werden Update-Module , die Sie aus dem Onlinekatalog installiert haben, indem Sie folgendes ausführen Install-Module.
Wenn Update-Module versucht wird, binärdateien zu aktualisieren, die verwendet werden, wird ein Fehler zurückgegeben, Update-Module der die Problemprozesse identifiziert. Der Benutzer wird informiert, den Vorgang erneut zu wiederholen Update-Module , nachdem die Prozesse beendet wurden.
