Partager via

Installation d’Azure PowerShell

Cet article explique comment installer les modules Azure PowerShell à l’aide de PowerShellGet. Ces instructions fonctionnent sur les plateformes Windows, Linux et macOS.

Azure PowerShell est également disponible dans Azure Cloud Shell.

Spécifications

Azure PowerShell fonctionne avec PowerShell 5.1 ou version ultérieure sur Windows, ou PowerShell Core 6.x et versions ultérieures sur toutes les plateformes. Vous devez installer la dernière version de PowerShell disponible pour votre système d’exploitation. Azure PowerShell n’a aucune configuration supplémentaire requise lors de l’exécution sur PowerShell 6.2.4 et versions ultérieures.

Pour vérifier votre version de PowerShell, exécutez la commande :

$PSVersionTable.PSVersion

Pour utiliser Azure PowerShell dans PowerShell 5.1 sur Windows :

  1. Mettez à jour vers Windows PowerShell 5.1. Si vous êtes sur Windows 10 version 1607 ou ultérieure, PowerShell 5.1 est déjà installé.
  2. Installez .NET Framework 4.7.2 ou version ultérieure.
  3. Vérifiez que vous disposez de la dernière version de PowerShellGet. Exécutez Install-Module -Name PowerShellGet -Force.

Installer le module Azure PowerShell

Avertissement

Nous ne prenons pas en charge l’installation des modules AzureRM et Az pour PowerShell 5.1 sur Windows en même temps. Si vous devez conserver AzureRM disponible sur votre système, installez le module Az pour PowerShell 6.2.4 ou version ultérieure.

L’utilisation des applets de commande PowerShellGet est la méthode d’installation par défaut. Installez le module Az pour l’utilisateur actuel uniquement. Il s’agit de la portée d’installation recommandée. Cette méthode fonctionne de la même façon sur les plateformes Windows, Linux et macOS. Exécutez la commande suivante à partir d’une session PowerShell :

if (Get-Module -Name AzureRM -ListAvailable) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope CurrentUser
}

Par défaut, la galerie PowerShell n’est pas configurée comme un référentiel de confiance pour PowerShellGet. La première fois que vous utilisez PSGallery, vous voyez l’invite suivante :

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 continuer l'installation.

L’installation du module pour tous les utilisateurs sur un système nécessite des privilèges élevés. Démarrez la session PowerShell à l’aide d’Exécuter en tant qu’administrateur dans Windows ou utilisez la sudo commande sur macOS ou Linux :

if (Get-Module -Name AzureRM -ListAvailable) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope AllUsers
}

Le module Az est un module cumulatif pour les cmdlets Azure PowerShell. L’installation télécharge tous les modules Az PowerShell généralement disponibles et rend leurs applets de commande disponibles pour une utilisation.

Installer hors connexion

Dans certains environnements, il n’est pas possible de se connecter au PowerShell Gallery. Dans ces situations, vous pouvez toujours installer hors connexion à l’aide de l’une des méthodes suivantes :

  • Téléchargez les modules vers un autre emplacement de votre réseau et utilisez-le comme source d’installation. Cette méthode vous permet de mettre en cache des modules PowerShell sur un seul serveur ou un partage de fichiers à déployer avec PowerShellGet sur tous les systèmes déconnectés. Découvrez comment configurer un référentiel local et l’installer sur des systèmes déconnectés avec l’utilisation de référentiels PowerShellGet locaux.

  • Téléchargez la MSI Azure PowerShell sur une machine connectée au réseau, puis copiez le programme d’installation sur les systèmes sans accéder à PowerShell Gallery. N’oubliez pas que le programme d’installation MSI ne fonctionne que pour PowerShell 5.1 sur Windows.

  • Enregistrez le module avec Save-Module dans un partage de fichiers, ou enregistrez-le dans une autre source et copiez-le manuellement sur d’autres ordinateurs :

    Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force

Résolution des problèmes

Voici quelques problèmes courants rencontrés lors de l’installation du module Azure PowerShell. Si vous rencontrez un problème non répertorié ici, créez un problème sur GitHub.

Le proxy bloque la connexion

Si vous recevez des erreurs de Install-Module indiquant que PowerShell Gallery est inaccessible, vous êtes peut-être derrière un proxy. Les différents systèmes d’exploitation et environnements réseau ont des exigences propres pour configurer un proxy à l’échelle du système. Contactez votre administrateur système pour vos paramètres de proxy et pour savoir comment les configurer pour votre environnement.

PowerShell lui-même peut ne pas être configuré pour utiliser ce proxy automatiquement. Avec PowerShell 5.1 et ultérieur, configurez la session PowerShell pour utiliser un proxy avec les commandes suivantes :

$webClient = New-Object System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

Si vos informations d’identification du système d’exploitation sont configurées correctement, cette configuration route les demandes PowerShell via le proxy. Pour conserver cette configuration entre les sessions, ajoutez les commandes à votre profil PowerShell.

Pour installer le package, votre proxy doit autoriser les connexions HTTPS à l’adresse suivante :

  • https://www.powershellgallery.com

Connectez-vous

Pour commencer à utiliser Azure PowerShell, connectez-vous avec vos informations d’identification Azure.

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

Remarque

Si vous avez désactivé le chargement automatique du module, importez manuellement le module avec Import-Module -Name Az. En raison de la façon dont le module est structuré, cela peut prendre quelques secondes.

Vous devez répéter ces étapes pour chaque nouvelle session PowerShell que vous démarrez. Pour savoir comment conserver votre connexion Azure dans les sessions PowerShell, consultez Conserver les informations d’identification de l’utilisateur dans les sessions PowerShell.

Mettre à jour le module Azure PowerShell

Pour mettre à jour un module PowerShell, vous devez utiliser la même méthode que celle utilisée pour installer le module. Par exemple, si vous avez utilisé Install-Moduleà l’origine, vous devez utiliser Update-Module pour obtenir la dernière version. Si vous avez utilisé le package MSI à l’origine, vous devez télécharger et installer le nouveau package MSI.

Les applets de commande PowerShellGet ne peuvent pas mettre à jour les modules installés à partir d’un package MSI. Les packages MSI ne mettent pas à jour les modules installés à l’aide de PowerShellGet. Si vous rencontrez des problèmes de mise à jour à l’aide de PowershellGet, vous devez réinstaller, plutôt que mettre à jour. La réinstallation est effectuée de la même façon que l’installation, mais vous devez ajouter le -Force paramètre :

if (Get-Module -Name AzureRM -ListAvailable) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Force
}

Contrairement aux installations basées sur MSI, l’installation ou la mise à jour à l’aide de PowerShellGet ne supprime pas les versions antérieures qui peuvent exister sur votre système. Pour supprimer les anciennes versions d’Azure PowerShell de votre système, consultez Désinstaller le module Azure PowerShell. Pour plus d’informations sur les installations basées sur MSI, consultez Installer Azure PowerShell avec une msi.

Utiliser plusieurs versions d’Azure PowerShell

Il est possible d’installer plusieurs versions d’Azure PowerShell. Pour vérifier si plusieurs versions d’Azure PowerShell sont installées, utilisez la commande suivante :

Get-InstalledModule -Name Az -AllVersions | Select-Object -Property Name, Version

Pour supprimer une version d’Azure PowerShell, consultez Désinstaller le module Azure PowerShell.

Si vous avez installé plusieurs versions du module, le module autoload et Import-Module chargent la dernière version par défaut.

Vous pouvez installer ou charger une version spécifique du Az module à l’aide du -RequiredVersion paramètre :

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

Fournir des commentaires

Si vous trouvez un bogue dans Azure PowerShell, créez un problème sur GitHub. Pour fournir des commentaires à partir de la ligne de commande, utilisez l’applet de commande Send-Feedback .

Étapes suivantes

Pour en savoir plus sur les modules Azure PowerShell et leurs fonctionnalités, consultez Prise en main d’Azure PowerShell. Si vous êtes familiarisé avec Azure PowerShell et que vous devez migrer d’AzureRM, consultez Migrer d’AzureRM vers Az.