Installer le module Azure PowerShellInstall the Azure PowerShell module

Cet article vous indique comment installer les modules Azure PowerShell à l’aide de PowerShellGet.This article tells you how to install the Azure PowerShell modules using PowerShellGet. Ces instructions s’appliquent aux plateformes Windows, macOS et Linux.These instructions work on Windows, macOS, and Linux platforms. Pour le module Az, actuellement aucune autre méthode d’installation n’est prise en charge.For the Az module, currently no other installation methods are supported.

Configuration requiseRequirements

Azure PowerShell fonctionne avec PowerShell 5.1 ou ultérieur sur Windows, ou avec PowerShell 6.x et ultérieur sur toutes les plateformes.Azure PowerShell works with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. Si vous n’êtes pas sûr d’avoir PowerShell, ou si vous êtes sur Mac OS ou Linux, installez la dernière version de PowerShell Core.If you aren't sure if you have PowerShell, or are on macOS or Linux, install the latest version of PowerShell Core.

Pour vérifier votre version de PowerShell, exécutez la commande :To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

Pour exécuter Azure PowerShell dans PowerShell 5.1 sur Windows :To run Azure PowerShell in PowerShell 5.1 on Windows:

  1. Mettrez à jour vers Windows PowerShell 5.1 si nécessaire.Update to Windows PowerShell 5.1 if needed. Si vous êtes sur Windows 10, PowerShell 5.1 est déjà installé.If you're on Windows 10, you already have PowerShell 5.1 installed.
  2. Installez .NET Framework 4.7.2 ou ultérieur.Install .NET Framework 4.7.2 or later.

Il n’existe aucune exigence supplémentaire pour Azure PowerShell lors de l’utilisation de PowerShell Core.There are no additional requirements for Azure PowerShell when using PowerShell Core.

Installer le module Azure PowerShellInstall the Azure PowerShell module

Avertissement

Vous ne pouvez pas avoir en même temps les modules AzureRM et Az installés pour PowerShell 5.1 pour Windows installés.You can't have both the AzureRM and Az modules installed for PowerShell 5.1 for Windows at the same time. Si vous avez besoin de conserver AzureRM disponible sur votre système, installez le module Az pour PowerShell Core 6.x ou ultérieur.If you need to keep AzureRM available on your system, install the Az module for PowerShell Core 6.x or later. Pour cela, installez PowerShell Core 6.x ou ultérieur et suivez ces instructions dans un terminal PowerShell Core.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

La méthode d’installation recommandée consiste seulement à installer pour l’utilisateur actif :The recommended install method is to only install for the active user:

Install-Module -Name Az -AllowClobber -Scope CurrentUser

Si vous souhaitez installer pour tous les utilisateurs d’un système, vous devez avoir des privilèges d’administrateur.If you want to install for all users on a system, this requires administrator privileges. À partir d’une session PowerShell avec élévation de privilèges, effectuez l’exécution en tant qu’administrateur ou avec la commande sudo sur MacOS ou Linux :From an elevated PowerShell session either run as administrator or with the sudo command on macOS or Linux:

Install-Module -Name Az -AllowClobber -Scope AllUsers

Par défaut, la galerie PowerShell n’est pas configurée comme un référentiel de confiance pour PowerShellGet.By default, the PowerShell gallery isn't configured as a trusted repository for PowerShellGet. La première fois que vous utilisez PSGallery, le message suivant s’affiche :The first time you use the PSGallery you see the following prompt:

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the Set-PSRepository cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

Répondez Yes ou Yes to All pour procéder à l’installation.Answer Yes or Yes to All to continue with the installation.

Le module Az est un module cumulatif pour les cmdlets Azure PowerShell.The Az module is a rollup module for the Azure PowerShell cmdlets. Son installation permet de télécharger tous les modules Azure Resource Manager disponibles, et rend leurs cmdlets disponibles.Installing it downloads all of the available Azure Resource Manager modules, and makes their cmdlets available for use.

Résolution de problèmesTroubleshooting

Voici quelques problèmes courants rencontrés lors de l’installation du module Azure PowerShell.Here are some common problems seen when installing the Azure PowerShell module. Si vous rencontrez un problème qui n’est pas listé ici, signalez ce problème sur GitHub.If you experience a problem not listed here, please file an issue on GitHub.

Le proxy bloque la connexionProxy blocks connection

Si vous recevez des erreurs de Install-Module indiquant que PowerShell Gallery est inaccessible, vous êtes peut-être derrière un proxy.If you get errors from Install-Module that indicate the PowerShell Gallery is unreachable, you may be behind a proxy. Les différents systèmes d’exploitation ont des exigences propres pour la configuration d’un proxy à l’échelle du système, qui ne sont pas abordées en détail ici.Different operating systems will have different requirements for configuring a system-wide proxy, which are not covered in detail here. Contactez votre administrateur système pour vos paramètres de proxy et pour savoir comment les configurer pour votre système d’exploitation.Contact your system administrator for your proxy settings and how to configure them for your OS.

PowerShell lui-même peut ne pas être configuré pour utiliser ce proxy automatiquement.PowerShell itself may not be configured to use this proxy automatically. Avec PowerShell 5.1 et ultérieur, configurez le proxy à utiliser pour une session PowerShell avec la commande suivante :With PowerShell 5.1 and later, configure the proxy to use for a PowerShell session with the following command:

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

Si vos informations d’identification du système d’exploitation sont configurées correctement, ceci va router les demandes PowerShell via le proxy.If your operating system credentials are configured correctly, this will route PowerShell requests through the proxy. Pour conserver cette configuration entre les sessions, ajoutez la commande à un profil PowerShell.In order to have this setting persist between sessions, add the command to a PowerShell profile.

Pour que l’installation du package soit possible, votre proxy doit autoriser les connexions HTTPS à l’adresse suivante :In order to install the package, your proxy needs to allow HTTPS connections to the following address:

  • https://www.powershellgallery.com

Se connecterSign in

Pour commencer à utiliser Azure PowerShell, connectez-vous à l’aide de vos informations d’identification Azure.To start working with Azure PowerShell, sign in with your Azure credentials.

# Connect to Azure with a browser sign in token
Connect-AzAccount

Notes

Si vous avez désactivé le chargement automatique de modules, importez manuellement le module avec Import-Module Az.If you've disabled module autoloading, manually import the module with Import-Module Az. En raison de la structure du module, cette opération peut prendre quelques secondes.Because of the way the module is structured, this can take a few seconds.

Vous devez répéter ces étapes pour chaque nouvelle session PowerShell que vous démarrez.You'll need to repeat these steps for every new PowerShell session you start. Pour savoir comment conserver votre connexion Azure sur plusieurs sessions PowerShell, consultez Conserver les informations d’identification d’utilisateur sur plusieurs sessions PowerShell.To learn how to persist your Azure sign-in across PowerShell sessions, see Persist user credentials across PowerShell sessions.

Mise à jour du module Azure PowerShellUpdate the Azure PowerShell module

En raison de la façon dont le module Az est empaqueté, la commande Update-Module ne met pas correctement à jour votre installation.Because of how the Az module is packaged, the Update-Module command won't update your installation correctly. Quand vous installez le module Az, celui-ci collecte et installe en fait tous ses sous-modules dépendants, lesquels fournissent les applets de commande pour chaque service.When you install the Az module, it actually collects and installs all of its dependent submodules, and which provide the cmdlets for each service. Cela signifie que pour mettre à jour le module Azure PowerShell, vous devez faire une réinstallation au lieu d’une simple mise à jour.That means that to update the Azure PowerShell module, you will need to reinstall, rather than just update. Cette opération s’effectue de la même façon que l’installation, mais il peut être nécessaire d’ajouter l’argument -Force :This is done in the same way as installing, but you may need to add the -Force argument:

Install-Module -Name Az -AllowClobber -Force

Bien que cela puisse remplacer les modules installés, des versions plus anciennes peuvent néanmoins rester présentes sur votre système.Although this can overwrite installed modules, you may still have older versions left on your system. Pour savoir comment supprimer d’anciennes versions d’Azure PowerShell de votre système, consultez l’article Désinstaller le module Azure PowerShell.To learn how to remove old versions of Azure PowerShell from your system, see Uninstall the Azure PowerShell module.

Utiliser plusieurs versions d’Azure PowerShellUse multiple versions of Azure PowerShell

Il est possible d’installer plusieurs versions d’Azure PowerShell.It's possible to install more than one version of Azure PowerShell. Pour vérifier si plusieurs versions d’Azure PowerShell sont installées, utilisez la commande suivante :To check if you have multiple versions of Azure PowerShell installed, use the following command:

Get-InstalledModule -Name Az -AllVersions | select Name,Version

Pour supprimer une version d’Azure PowerShell, consultez Désinstaller le module Azure PowerShell.To remove a version of Azure PowerShell, see Uninstall the Azure PowerShell module.

Vous pouvez installer ou charger une version spécifique du module Az à l’aide de l’argument -RequiredVersion :You can install or load a specific version of the Az module by using the -RequiredVersion argument:

# Install Az version 0.7.0
Install-Module -Name Az -RequiredVersion 0.7.0 
# Load Az version 0.7.0
Import-Module -Name Az -RequiredVersion 0.7.0

Si plusieurs versions du module sont installées, la version la plus récente est chargée par défaut par Import-Module et le chargement automatique de module.If you have more than one version of the module installed, module autoload and Import-Module load the latest version by default.

Fournir des commentairesProvide feedback

Si vous rencontrez un bogue dans Azure PowerShell, signalez un problème sur GitHub.If you find a bug in Azure Powershell, file an issue on GitHub. Pour fournir des commentaires à partir de la ligne de commande, utilisez la cmdlet Send-Feedback.To provide feedback from the command line, use the Send-Feedback cmdlet.

Étapes suivantesNext Steps

Pour en savoir plus sur les modules PowerShell et leurs fonctionnalités, consultez l’article sur la prise en main d’Azure PowerShell.To learn more about the Azure PowerShell modules and their features, see Get Started with Azure PowerShell. Si vous êtes familiarisé avec Azure PowerShell et devez effectuer une migration depuis AzureRM, consultez l’article sur la migration d’AzureRM vers Az.If you're familiar with Azure PowerShell and need to migrate from AzureRM, see Migrate from AzureRM to Az.