Update-PSResource

  • Référence
Module:
Microsoft.PowerShell.PSResourceGet

Télécharge et installe la version la plus récente d’un package déjà installé sur l’ordinateur local.

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

Description

Update-PSResource télécharge et installe la version la plus récente d’un package déjà installé sur l’ordinateur local. Cette applet de commande remplace les Update-Module applets de commande et Update-Script de PowerShellGet v2. La nouvelle version de la ressource est installée côte à côte avec les versions précédentes dans un nouveau dossier avec version.

Par défaut, Update-PSResource installe la dernière version du package et l’une de ses dépendances sans supprimer les anciennes versions installées.

Exemples

Exemple 1

Dans cet exemple, l’utilisateur a déjà installé le package TestModule et met à jour le package.

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

Paramètres

-AcceptLicense

Pour les ressources qui nécessitent une licence, AcceptLicense accepte automatiquement le contrat de licence pendant la mise à jour.

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

-AuthenticodeCheck

Valide les fichiers signés et les fichiers catalogue sur Windows.

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-Credential

Spécifie les informations d’identification facultatives utilisées lors de l’accès à un dépôt privé.

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

-Force

Lorsque cette option est spécifiée, ignore les vérifications de TrustRepository et AcceptLicense et met à jour le package.

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

-Name

Spécifie le nom d’une ou plusieurs ressources à mettre à jour. Les caractères génériques sont pris en charge, mais NuGet accepte uniquement le * caractère. NuGet ne prend pas en charge les recherches par caractères génériques dans les référentiels locaux (basés sur des fichiers).

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

-PassThru

Lorsqu’il est spécifié, génère un objet PSResourceInfo pour la ressource enregistrée.

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

-Prerelease

Quand il est spécifié, autorise la mise à jour vers une version préliminaire.

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

-Quiet

Supprime les informations de progression.

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

-Repository

Spécifie un ou plusieurs noms de référentiels à rechercher. Si elle n’est pas spécifiée, la recherche inclut tous les dépôts inscrits, dans l’ordre de priorité (le plus élevé en premier), jusqu’à ce qu’un dépôt contenant le package soit trouvé. Les dépôts sont triés par priorité, puis par nom. Les valeurs de priorité inférieure ont une priorité plus élevée.

Lors de la recherche de ressources dans plusieurs référentiels, les applets de commande PSResourceGet recherchent les dépôts à l’aide de cet ordre de tri. Update-PSResource met à jour le premier package correspondant de la liste triée des dépôts.

Le paramètre prend en charge le * caractère générique. Si vous spécifiez plusieurs référentiels, tous les noms doivent inclure ou omettre le caractère générique. Vous ne pouvez pas spécifier une combinaison de noms avec et sans caractères génériques.

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

-Scope

Spécifie l’étendue d’installation. Les valeurs acceptées sont :

  • CurrentUser
  • AllUsers

L’étendue par défaut est CurrentUser, qui ne nécessite pas d’élévation.

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

Ignore la case activée pour les dépendances de ressources. Cela signifie que seules les ressources nommées sont mises à jour.

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

-TemporaryPath

Spécifie le chemin d’installation temporaire de la ressource avant l’installation réelle. Si aucun chemin d’accès temporaire n’est fourni, la ressource est installée temporairement dans le dossier temporaire de l’utilisateur actuel.

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

-TrustRepository

Supprimez les invites à approuver le dépôt. L’invite à approuver le dépôt se produit uniquement si le dépôt n’est pas configuré comme approuvé.

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

-Version

Spécifie la version de la ressource à retourner. La valeur peut être une version exacte ou une plage de versions à l’aide de la syntaxe de contrôle de version NuGet.

Pour plus d’informations sur les plages de versions NuGet, consultez Gestion des versions des packages.

PowerShellGet prend en charge toutes les versions inclusives, sauf la version minimale répertoriée dans la documentation de la plage de versions NuGet. L’utilisation 1.0.0.0 de comme version ne produit pas les versions 1.0.0.0 et ultérieures (plage inclusive minimale). Au lieu de cela, la valeur est considérée comme étant la version requise. Pour rechercher une plage inclusive minimale, utilisez [1.0.0.0, ] comme plage de versions.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

String[]

Sorties

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Par défaut, l’applet de commande ne retourne aucun objet. Lorsque le paramètre PassThru est utilisé, l’applet de commande génère un objet PSResourceInfo pour la ressource enregistrée.

Notes

Le module définit udres comme alias pour Update-PSResource.