Update-PSResource

  • Referenz
Modul:
Microsoft.PowerShell.PSResourceGet

Lädt die neueste Version eines Pakets herunter, das bereits auf dem lokalen Computer installiert ist, und installiert sie.

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, das bereits auf dem lokalen Computer installiert ist, und installiert sie. Dieses Cmdlet ersetzt die Update-Module Cmdlets und Update-Script aus PowerShellGet v2. Die neue Version der Ressource wird parallel zu früheren Versionen in einem neuen Ordner mit versionsbasierter Version installiert.

Standardmäßig werden die neueste Version des Pakets und alle zugehörigen Abhängigkeiten installiert, Update-PSResource ohne die installierten älteren Versionen zu löschen.

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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthenticodeCheck

Überprüft signierte Dateien und Katalogdateien unter Windows.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Gibt optionale Anmeldeinformationen an, die beim Zugriff auf ein privates Repository verwendet werden.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Wenn angegeben, wird die Überprüfung auf TrustRepository und AcceptLicense umgangen und das Paket aktualisiert.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Gibt den Namen einer oder mehrerer zu aktualisierenden Ressourcen an. Feldhalter werden unterstützt, aber NuGet akzeptiert nur das * Zeichen. NuGet unterstützt keine Wildcardsuchen lokaler (dateibasierter) Repositorys.

Type:String[]
Position:0
Default value:"*"
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

Wenn angegeben, gibt ein PSResourceInfo-Objekt für die gespeicherte Ressource aus.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Prerelease

Wenn angegeben, ermöglicht das Aktualisieren auf eine Vorabversion.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Quiet

Unterdrückt Statusinformationen.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Repository

Gibt einen oder mehrere zu durchsuchende Repositorynamen an. Wenn nicht angegeben, umfasst die Suche alle registrierten Repositorys in der Prioritätsreihenfolge (höchste erste Reihenfolge), bis ein Repository gefunden wird, das das Paket enthält. Repositorys werden nach Priorität und dann nach Name sortiert. Niedrigere Prioritätswerte haben eine höhere Priorität.

Bei der Suche 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 * Feldhalterzeichen. Wenn Sie mehrere Repositorys angeben, müssen alle Namen das Feldhalterzeichen enthalten oder weglassen. Sie können keine Kombination von Namen mit und ohne Wildcards angeben.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Scope

Gibt den Installationsbereich an. Dies sind die zulässigen Werte:

  • CurrentUser
  • AllUsers

Der Standardbereich ist CurrentUser, was keine Erhöhung erfordert.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

Überspringt die Überprüfung auf Ressourcenabhängigkeiten. Dies bedeutet, dass nur benannte Ressourcen aktualisiert werden.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TemporaryPath

Gibt den Pfad zum vorübergehenden Installieren der Ressource vor der tatsächlichen Installation an. Wenn kein temporärer Pfad angegeben wird, wird die Ressource vorübergehend im temporären Ordner des aktuellen Benutzers installiert.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TrustRepository

Unterdrücken von Aufforderungen zum Vertrauen des Repositorys. Die Aufforderung zum Vertrauen des Repositorys erfolgt nur, wenn das Repository nicht als vertrauenswürdig konfiguriert ist.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

Gibt die Version der Ressource an, die zurückgegeben werden soll. Der Wert kann eine exakte Version oder ein Versionsbereich mit der NuGet-Versionssyntax sein.

Weitere Informationen zu NuGet-Versionsbereichen finden Sie unter Paketversionsverwaltung.

PowerShellGet unterstützt alle Versionen bis auf die mindeste inklusive Version , die in der Dokumentation zum NuGet-Versionsbereich aufgeführt ist. Die Verwendung 1.0.0.0 als Version ergibt keine Versionen 1.0.0.0 und höher (mindestumfang). Stattdessen wird der Wert als die erforderliche Version betrachtet. Verwenden Sie [1.0.0.0, ] als Versionsbereich, um nach einem inklusiven Mindestbereich zu suchen.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.