Freigeben über

Update-PSResource

  • Referenz
Modul:
Microsoft.PowerShell.PSResourceGet

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 Cmdlets Update-Module und Update-Script aus PowerShellGet- v2. Die neue Version der Ressource wird parallel mit früheren Versionen in einem neuen Versionsordner installiert.

Standardmäßig installiert Update-PSResource die neueste Version des Pakets und einer der 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 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                                        test

Parameter

-AcceptLicense

Für Ressourcen, die eine Lizenz erfordern, AcceptLicense den Lizenzvertrag während des Updates automatisch akzeptiert.

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

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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ät Werte haben eine höhere Priorität.

Beim Suchen nach Ressourcen über mehrere Repositorys hinweg 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. Akzeptierte Werte sind:

  • CurrentUser
  • AllUsers

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 mindestens inklusive Version in der NuGet-Versionsbereichsdokumentation aufgeführt. Die Verwendung von 1.0.0.0, da die Version die Versionen 1.0.0.0.0 und höher (minimaler inklusiver Bereich) nicht liefert. Stattdessen wird der Wert als erforderliche Version betrachtet. Verwenden Sie [1.0.0.0, ] als Versionsbereich, um nach einem minimal inklusiven Bereich zu suchen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-WhatIf

Zeigt, was passiert, 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.