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 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                                        test

Parameter

-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:

  • 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, 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.