Update-Module

Update-Module
    [[-Name] <String[]>]
    [-RequiredVersion <Version>]
    [-MaximumVersion <Version>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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 . Vous pouvez effectuer une mise à jour vers la version spécifique d’un module à l’aide du paramètre RequiredVersion.

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.

Cet exemple met à jour tous les modules installés vers la version la plus récente dans une galerie en ligne.

Update-Module

Cet exemple met à jour un module spécifique vers la version la plus récente dans une galerie en ligne.

Update-Module -Name SpeculationControl

utilise le paramètre Name pour mettre à jour un module spécifique, SpeculationControl.

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'".

utilise le paramètre WhatIf affiche ce qui se passerait si ont été exécutés.

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

utilise le paramètre Name pour spécifier le module, SpeculationControl. Le paramètre RequiredVersion spécifie la version, 1.0.14.

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

utilise le paramètre Name pour spécifier le module, SpeculationControl. Le paramètre Forcer met à jour le module sans demander la confirmation de l’utilisateur.

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.

Pour PowerShell 5.1 ou inférieur, l’étendue par défaut d’une session avec élévation de privilèges est AllUserset, dans une session sans élévation de privilèges, CurrentUser. Les mises à jour des modules pour AllUsers, $env:ProgramFiles\PowerShell\Modules, ont besoin d’autorisations élevées. Les mises à jour de module pour CurrentUser, $home\Documents\PowerShell\Modules, n’ont pas besoin d’autorisations élevées.

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 de 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.