Update-Module
Télécharge et installe la dernière version des modules spécifiés à partir d’une galerie en ligne sur l’ordinateur local.
Syntaxe
All
Update-Module
[[-Name] <String[]>]
[-RequiredVersion <String>]
[-MaximumVersion <String>]
[-Credential <PSCredential>]
[-Scope <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Update-Module installe la version la plus récente d’un module à partir d’une galerie en ligne. Vous êtes invité à confirmer la mise à jour avant son installation. Les mises à jour sont installées uniquement pour les modules installés sur l’ordinateur local avec Install-Module.
Update-Module recherche $env:PSModulePath les modules installés.
Update-Module sans paramètres spécifiés met à jour tous les modules installés. Pour spécifier un module à mettre à jour, utilisez le paramètre Name
Les paramètres qui prennent les numéros de version du module s’attendent à ce que les chaînes mises en forme en tant que numéros de version.
- Les numéros de version standard ont un format où
x.y.zx, y et z sont des nombres - Les versions préliminaires ont un format où
x.y.z-<prerelease_label>la<prerelease_label>chaîne arbitraire affectée à cette version est arbitraire.
Si un module installé est déjà la version la plus récente, le module n’est pas mis à jour. Si le module est introuvable dans $env:PSModulePath, une erreur s’affiche.
Pour afficher les modules installés, utilisez Get-InstalledModule.
Exemples
Exemple 1 : Mettre à jour tous les modules
Cet exemple met à jour tous les modules installés vers la version la plus récente dans une galerie en ligne.
Update-Module
Exemple 2 : Mettre à jour un module par nom
Cet exemple met à jour un module spécifique vers la version la plus récente dans une galerie en ligne.
Update-Module -Name SpeculationControl
Exemple 3 : Afficher les Update-Module de scénarios
Cet exemple montre comment afficher ce qui se passe si Update-Module est exécuté. La commande n’est pas exécutée.
Update-Module -WhatIf
What if: Performing the operation "Update-Module" on target "Version '2.8.0' of module
'Carbon', updating to version '2.8.1'".
What if: Performing the operation "Update-Module" on target "Version '1.0.10' of module
'SpeculationControl', updating to version '1.0.14'".
Exemple 4 : Mettre à jour un module vers une version spécifiée
Dans cet exemple, un module est mis à jour vers une version spécifique. La version doit exister dans la galerie en ligne ou une erreur s’affiche.
Update-Module -Name SpeculationControl -RequiredVersion 1.0.14
Exemple 5 : Mettre à jour un module sans confirmation
Cet exemple ne demande pas la confirmation de mettre à jour le module vers la version la plus récente à partir d’une galerie en ligne. Si le module est déjà installé, le paramètre Force réinstalle le module.
Update-Module -Name SpeculationControl -Force
Paramètres
-AcceptLicense
Acceptez automatiquement le contrat de licence pendant l’installation si le package l’exige.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AllowPrerelease
Vous permet de mettre à jour un module avec le module plus récent marqué comme une préversion.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter Update-Module.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Credential
Spécifie un compte d’utilisateur autorisé à mettre à jour un module.
Propriétés des paramètres
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Force
Force une mise à jour de chaque module spécifié sans invite à demander la confirmation. Si le module est déjà installé, Force réinstalle le module.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MaximumVersion
Spécifie la version maximale d’un seul module à mettre à jour. Vous ne pouvez pas ajouter ce paramètre si vous tentez de mettre à jour plusieurs modules. Les MaximumVersion
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Name
Spécifie les noms d’un ou plusieurs modules à mettre à jour.
Update-Module recherche $env:PSModulePath les modules à mettre à jour. Si aucune correspondance n’est trouvée dans $env:PSModulePath pour le nom du module spécifié, une erreur se produit.
Les caractères génériques sont acceptés dans les noms de module. Si vous ajoutez des caractères génériques au nom spécifié et qu’aucune correspondance n’est trouvée, aucune erreur ne se produit.
Propriétés des paramètres
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-PassThru
Retourne un objet représentant l’élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucune sortie.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Proxy
Spécifie un serveur proxy pour la requête, au lieu de se connecter directement à une ressource Internet.
Propriétés des paramètres
| Type: | Uri |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ProxyCredential
Spécifie un compte d’utilisateur autorisé à utiliser le serveur proxy spécifié par le paramètre proxy.
Propriétés des paramètres
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-RequiredVersion
Spécifie la version exacte à laquelle le module installé existant sera mis à jour. La version spécifiée par RequiredVersion doit exister dans la galerie en ligne ou une erreur s’affiche. Si plusieurs modules sont mis à jour dans une seule commande, vous ne pouvez pas utiliser RequiredVersion.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Scope
Spécifie l’étendue d’installation du module. Les valeurs acceptables pour ce paramètre sont AllUsers et CurrentUser. Si l’étendue n’est pas spécifiée, la mise à jour est installée dans l’étendue CurrentUser .
L’étendue AllUsers nécessite des autorisations élevées et installe des modules dans un emplacement accessible à tous les utilisateurs de l’ordinateur :
$env:ProgramFiles\PowerShell\Modules
CurrentUser ne nécessite pas d’autorisations élevées et installe des modules dans un emplacement accessible uniquement à l’utilisateur actuel de l’ordinateur :
$HOME\Documents\PowerShell\Modules
Quand aucune étendue n’est définie, la valeur par défaut est définie en fonction de la version de PowerShellGet.
- Dans PowerShellGet versions 2.0.0 et ultérieures, la valeur par défaut est CurrentUser, qui ne nécessite pas d’élévation pour l’installation.
- Dans les versions de PowerShellGet 1.x, la valeur par défaut est AllUsers, ce qui nécessite une élévation pour l’installation.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | CurrentUser |
| Valeurs acceptées: | CurrentUser, AllUsers |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Montre ce qui se passerait si Update-Module s’exécute. L’applet de commande n’est pas exécutée.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
String
String
PSCredential
Uri
Sorties
Object
Notes
PowerShell inclut les alias suivants pour Update-Module:
- Toutes les plateformes :
upmo
Pour PowerShell version 6.0 et ultérieure, l’étendue d’installation par défaut est toujours CurrentUser.
Les mises à jour de module pour CurrentUser, $HOME\Documents\PowerShell\Modules, n’ont pas besoin d’autorisations élevées. Les mises à jour des modules pour AllUsers, $env:ProgramFiles\PowerShell\Modules, ont besoin d’autorisations élevées.
Important
Depuis avril 2020, PowerShell Gallery ne prend plus en charge les versions TLS (Transport Layer Security) 1.0 et 1.1. Si vous n’utilisez pas TLS 1.2 ou version ultérieure, vous recevez une erreur lors de la tentative d’accès à PowerShell Gallery. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Pour plus d’informations, consultez l’annonce dans le blog PowerShell.
Update-Module s’exécute sur PowerShell 3.0 ou versions ultérieures de PowerShell, sur Windows 7 ou Windows 2008 R2 et versions ultérieures de Windows.
Si le module que vous spécifiez avec le paramètre Name n’a pas été installé à l’aide Install-Module, une erreur se produit.
Vous ne pouvez exécuter Update-Module sur les modules que vous avez installés à partir de la galerie en ligne en exécutant Install-Module.
Si Update-Module tente de mettre à jour des fichiers binaires en cours d’utilisation, Update-Module retourne une erreur qui identifie les processus de problème. L’utilisateur est informé de réessayer Update-Module une fois les processus arrêtés.
