Update-PSResource
Télécharge et installe la version la plus récente d’un package déjà installé sur l’ordinateur local.
Syntaxe
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 les applets de commande 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 versionné.
Par défaut, Update-PSResource installe la dernière version du package et l’une de ses dépendances sans supprimer les versions antérieures installées. Il n’existe aucune commande pour désinstaller les versions antérieures d’un package. Vous devez supprimer manuellement les fichiers et dossiers des versions antérieures.
Update-PSResource ne charge pas le module mis à jour dans la session active. Vous devez importer la nouvelle version ou démarrer une nouvelle session pour utiliser le module mis à jour. Pour plus d’informations, voir Import-Module.
Exemples
Exemple 1
Dans cet exemple, l’utilisateur a déjà installé le package TestModule et il 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 testParamè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 |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AuthenticodeCheck
Valide les fichiers signés et les fichiers catalogue sur Windows.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Credential
Spécifie les informations d’identification facultatives utilisées lors de l’accès à un référentiel privé.
| Type: | PSCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Force
Quand elle est spécifiée, contourne les vérifications de TrustRepository et AcceptLicense et met à jour le package.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 génériques de référentiels locaux (basés sur des fichiers).
| Type: | String[] |
| Position: | 0 |
| Valeur par défaut: | "*" |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | True |
-PassThru
Quand elle est spécifiée, génère un objet PSResourceInfo pour la ressource enregistrée.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Prerelease
Quand elle est spécifiée, autorise la mise à jour vers une version préliminaire.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Quiet
Supprime les informations de progression.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 référentiels inscrits, dans l’ordre de priorité (le plus élevé), jusqu’à ce qu’un référentiel soit trouvé qui contient le package. Les référentiels sont triés par priorité, puis par nom. Les valeurs de priorité inférieure ont une priorité plus élevée.
Lorsque vous recherchez des ressources dans plusieurs référentiels, les applets de commande PSResourceGet recherchent les référentiels à l’aide de cet ordre de tri. Update-PSResource met à jour le premier package correspondant à partir de la liste triée des référentiels.
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 de combinaison de noms avec et sans caractères génériques.
| Type: | String[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | True |
-Scope
Spécifie l’étendue d’installation. Les valeurs acceptées sont :
CurrentUserAllUsers
L’étendue par défaut est CurrentUser, qui ne nécessite pas d’élévation.
| Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
| Valeurs acceptées: | CurrentUser, AllUsers |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SkipDependencyCheck
Ignore la vérification des dépendances de ressources. Cela signifie que seules les ressources nommées sont mises à jour.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-TemporaryPath
Spécifie le chemin d’accès pour installer temporairement la ressource avant l’installation réelle d’installatoin. Si aucun chemin temporaire n’est fourni, la ressource est temporairement installée dans le dossier temporaire de l’utilisateur actuel.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-TrustRepository
Supprimez les invites pour approuver le référentiel. L’invite à approuver le référentiel se produit uniquement si le référentiel n’est pas configuré comme approuvé.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 du package.
PowerShellGet prend en charge toutes les versions inclusives minimales répertoriées dans la documentation de la plage de versions NuGet. L’utilisation 1.0.0.0 comme version ne génère pas les versions 1.0.0.0 et ultérieures (plage inclusive minimale). Au lieu de cela, la valeur est considérée comme la version requise. Pour rechercher une plage inclusive minimale, utilisez [1.0.0.0, ] la plage de versions.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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.
