Update-PSResource
Lädt die neueste Version eines Pakets herunter und installiert es, das bereits auf dem lokalen Computer installiert ist.
Syntax
Update-PSResource
[[-Name] <String[]>]
[-Version <String>]
[-Prerelease]
[-Repository <String[]>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Credential <PSCredential>]
[-Quiet]
[-AcceptLicense]
[-Force]
[-PassThru]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Beschreibung
Update-PSResource lädt die neueste Version eines Pakets herunter und installiert es, das bereits auf dem lokalen Computer installiert ist. Dieses Cmdlet ersetzt die Update-Module Und-Cmdlets Update-Script aus PowerShellGet v2. Die neue Version der Ressource wird parallel mit früheren Versionen in einem neuen Versionsordner installiert.
Installiert standardmäßig Update-PSResource die neueste Version des Pakets und eine seiner Abhängigkeiten, ohne die älteren Versionen zu löschen. Es gibt keinen Befehl zum Deinstallieren älterer Versionen eines Pakets. Sie müssen die Dateien und Ordner der älteren Versionen manuell löschen.
Update-PSResource lädt das aktualisierte Modul nicht in die aktuelle Sitzung. Sie müssen die neue Version importieren oder eine neue Sitzung starten, um das aktualisierte Modul zu verwenden. Weitere Informationen finden Sie unter Import-Module.
Beispiele
Beispiel 1
In diesem Beispiel hat der Benutzer bereits das TestModule-Paket installiert, und er aktualisiert das Paket.
Get-PSResource -Name "TestModule"
Name Version Prerelease Description
---- ------- ---------- -----------
TestModule 1.2.0 test
Update-PSResource -Name "TestModule"
Name Version Prerelease Description
---- ------- ---------- -----------
TestModule 1.3.0 test
TestModule 1.2.0 testParameter
-AcceptLicense
Für Ressourcen, die eine Lizenz erfordern, akzeptiert AcceptLicense während des Updates automatisch den Lizenzvertrag.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AuthenticodeCheck
Überprüft signierte Dateien und Katalogdateien unter Windows.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Credential
Gibt optionale Anmeldeinformationen an, die beim Zugriff auf ein privates Repository verwendet werden.
| Typ: | PSCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Force
Wenn angegeben, werden Überprüfungen auf TrustRepository und AcceptLicense umgangen und das Paket aktualisiert.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Gibt den Namen einer oder mehrerer zu aktualisierenden Ressourcen an. Wildcards werden unterstützt, nuGet akzeptiert jedoch nur das * Zeichen. NuGet unterstützt keine Wildcardsuchen lokaler Repositorys (dateibasiert).
| Typ: | String[] |
| Position: | 0 |
| Standardwert: | "*" |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | True |
-PassThru
Wenn angegeben, gibt ein PSResourceInfo -Objekt für die gespeicherte Ressource aus.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Prerelease
Wenn angegeben, ermöglicht die Aktualisierung auf eine Vorabversion.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Quiet
Unterdrückt Statusinformationen.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Repository
Gibt einen oder mehrere Repositorynamen an, die durchsucht werden sollen. Wenn nicht angegeben, enthält die Suche alle registrierten Repositorys in der Prioritätsreihenfolge (zuerst) bis ein Repository gefunden wird, das das Paket enthält. Repositorys werden nach Priorität und dann nach Namen sortiert. Niedrigere Prioritätswerte haben eine höhere Priorität.
Beim Suchen nach Ressourcen in mehreren Repositorys durchsuchen die PSResourceGet-Cmdlets die Repositorys mithilfe dieser Sortierreihenfolge. Update-PSResource aktualisiert das erste übereinstimmende Paket aus der sortierten Liste der Repositorys.
Der Parameter unterstützt das * Wildcardzeichen. Wenn Sie mehrere Repositorys angeben, müssen alle Namen das Wildcardzeichen enthalten oder weglassen. Sie können keine Kombination aus Namen mit und ohne Wildcards angeben.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | True |
-Scope
Gibt den Installationsbereich an. Dies sind die zulässigen Werte:
CurrentUserAllUsers
Der Standardbereich ist CurrentUser, was keine Erhöhung erfordert.
| Typ: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
| Zulässige Werte: | CurrentUser, AllUsers |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SkipDependencyCheck
Überspringt die Überprüfung auf Ressourcenabhängigkeiten. Dies bedeutet, dass nur benannte Ressourcen aktualisiert werden.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TemporaryPath
Gibt den Pfad an, mit dem die Ressource vorübergehend vor dem tatsächlichen Installatoin installiert werden soll. Wenn kein temporärer Pfad angegeben wird, wird die Ressource vorübergehend im temporären Ordner des aktuellen Benutzers installiert.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TrustRepository
Unterdrücken Von Eingabeaufforderungen zum Vertrauenswürdigen Repository. Die Aufforderung zum Vertrauenswürdigen Repository tritt nur auf, wenn das Repository nicht als vertrauenswürdig konfiguriert ist.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Version
Gibt die Version der zurückzugebenden Ressource an. Der Wert kann eine genaue Version oder ein Versionsbereich mit der NuGet-Versionsverwaltungssyntax sein.
Weitere Informationen zu NuGet-Versionsbereichen finden Sie unter Paketversionsverwaltung.
PowerShellGet unterstützt alle, aber die mindestens inklusive Version, die in der NuGet-Versionsbereichsdokumentation aufgeführt ist. Die Verwendung 1.0.0.0 als Version führt nicht zu Versionen 1.0.0.0 und höher (minimaler inklusiver Bereich). Stattdessen wird der Wert als erforderliche Version betrachtet. Verwenden Sie zum Suchen nach einem minimalen inklusiven Bereich [1.0.0.0, ] als Versionsbereich.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | True |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
String[]
Ausgaben
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo
Standardmäßig gibt das Cmdlet keine Objekte zurück. Wenn der PassThru-Parameter verwendet wird, gibt das Cmdlet ein PSResourceInfo-Objekt für die gespeicherte Ressource aus.
Hinweise
Das Modul definiert udres als Alias für Update-PSResource.
