Update-Module
Télécharge et installe la version la plus récente des modules spécifiés à partir d’une galerie en ligne sur l’ordinateur local.
Syntax
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 Update-Module de commande installe la dernière version d’un module à partir d’une galerie en ligne. Vous êtes invité à confirmer la mise à jour avant son installation. Mises à jour sont installés uniquement pour les modules qui ont été installés sur l’ordinateur local avec Install-Module. Update-Module recherche les $env:PSModulePath modules installés.
Il s’agit d’une applet de commande proxy pour l’applet Update-PSResourcede commande dans Microsoft.PowerShell.PSResourceGet. Pour plus d’informations, consultez Update-PSResource.
Exemples
Exemple 1 : Mettre à jour tous les modules
Cet exemple met à jour tous les modules installés vers la dernière version d’une galerie en ligne.
Update-ModuleExemple 2 : Mettre à jour un module par nom
Cet exemple met à jour un module spécifique vers la dernière version d’une galerie en ligne.
Update-Module -Name SpeculationControlUpdate-Module utilise le paramètre Name pour mettre à jour un module spécifique, SpeculationControl.
Exemple 3 : Afficher les Update-Module s’exécutent
Cet exemple montre comment exécuter un scénario de scénario de type « what-if Update-Module ». 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'".Update-Module utilise le paramètre WhatIf pour afficher ce qui se passerait en cas Update-Module d’exécution.
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.14Update-Module utilise le paramètre Name pour spécifier le module SpeculationControl. Le paramètre RequiredVersion spécifie la version 1.0.14.
Exemple 5 : Mettre à jour un module sans confirmation
Cet exemple ne demande pas de confirmation de mise à jour du module vers la dernière version à 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 -ForceUpdate-Module utilise le paramètre Name pour spécifier le module SpeculationControl. Le paramètre Force met à jour le module sans demander la confirmation de l’utilisateur.
Paramètres
-AcceptLicense
Acceptez automatiquement le contrat de licence pendant l’installation si le package l’exige.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowPrerelease
Vous permet de mettre à jour un module avec le module plus récent marqué comme préversion.
L’applet de commande proxy mappe ce paramètre au paramètre Prerelease de Update-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Vous invite à confirmer avant d’exécuter Update-Module.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Spécifie un compte d’utilisateur qui est autorisé à mettre à jour un module.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Force une mise à jour de chaque module spécifié sans invite de demande de confirmation. Si le module est déjà installé, Force réinstalle le module.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
L’applet de commande proxy utilise la valeur de ce paramètre pour créer une chaîne de recherche de version NuGet à utiliser avec le paramètre Version de Update-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 de 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.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-PassThru
Retourne un objet représentant l’élément que vous utilisez. Par défaut, cette applet de commande ne génère aucun résultat.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Update-PSResource.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Update-PSResource.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RequiredVersion
L’applet de commande proxy utilise la valeur de ce paramètre pour créer une chaîne de recherche de version NuGet à utiliser avec le paramètre Version de Update-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 les 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 les modules dans un emplacement accessible uniquement à l’utilisateur actuel de l’ordinateur :
$HOME\Documents\PowerShell\Modules
Lorsqu’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, qui nécessite une élévation pour l’installation.
| Type: | String |
| Accepted values: | CurrentUser, AllUsers |
| Position: | Named |
| Default value: | CurrentUser |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Affiche ce qui se produirait en cas Update-Module d’exécution. 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
Notes
PowerShell inclut les alias suivants pour Update-Module:
- Toutes les plateformes :
upmo
Pour PowerShell version 6.0 et versions ultérieures, 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 de module pour AllUsers, $env:ProgramFiles\PowerShell\Modules, nécessitent des autorisations élevées.
Le PowerShell Gallery ne prend plus en charge les versions 1.0 et 1.1 du protocole TLS (Transport Layer Security). Vous devez utiliser TLS 1.2 ou version ultérieure. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
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-Modulede , une erreur se produit.
Vous pouvez uniquement 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 les fichiers binaires en cours d’utilisation, Update-Module retourne une erreur qui identifie les processus problématiques. L’utilisateur est informé de réessayer Update-Module une fois les processus arrêtés.
