Partager via


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

Exemple 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 SpeculationControl

Update-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.14

Update-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 -Force

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

String

PSCredential

Uri

Sorties

Object

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.