Update-Module

Module:

PowerShellGet v3 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.

Il s’agit d’une applet de commande proxy pour l’applet Update-PSResource de 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 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

utilise le paramètre Name pour mettre à jour un module spécifique, 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'".

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

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

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

Paramètres

-AcceptLicense

Acceptez automatiquement le contrat de licence pendant l’installation si le package l’exige.

Propriétés du paramètre

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.

L’applet de commande proxy mappe ce paramètre au paramètre Prerelease de Update-PSResource.

Propriétés du paramètre

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 du paramètre

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 du paramètre

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 du paramètre

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

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.

Propriétés du paramètre

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 du paramètre

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 du paramètre

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

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Update-PSResource.

Propriétés du paramètre

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

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Update-PSResource.

Propriétés du paramètre

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

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.

Propriétés du paramètre

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 du paramètre

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 du paramètre

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.

PowerShell Gallery ne prend plus en charge les versions TLS (Transport Layer Security) 1.0 et 1.1. 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-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.

Liens associés

• Find-Module
• Get-InstalledModule
• Install-Module
• Publish-Module
• Uninstall-Module