• 05/14/2020
• 6 minutes pour lire
• • m
  • h

Cet article explique comment installer le Azure PowerShell modules usingPowerShellGet. Ces instructions fonctionnent sur les plates-formes Windows,macOS et Linux.

Azure PowerShell est également disponible dans Azure Cloud Shell et est maintenant installé dans les images Docker.

Besoins

Azure PowerShell fonctionne avec PowerShell 6.2.4 et versions ultérieures sur toutes les plates-formes. Il est également pris en charge avecpowershell 5.1 sous Windows. Installez la dernière version de PowerShell disponible pour votre système d’exploitation. Azure PowerShell n’a pas de configuration requise supplémentaire lorsqu’il est exécuté sur PowerShell 6.2.4 et versions ultérieures.

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

$PSVersionTable.PSVersion

Pour utiliser Azure PowerShell dans PowerShell 5.1 sous Windows:

1. mise à Jour àfenêtres PowerShell 5.1.,Si vous utilisez Windows 10 version 1607 ou supérieure, PowerShell 5.1 est déjà installé.
2. installez. NET Framework 4.7.2 ou version ultérieure.
3. assurez-vous d’avoir la dernière version de PowerShellGet. Exécutez Install-Module -Name PowerShellGet -Force.

installez le module Azure PowerShell

Installer pour L’utilisateur actuel

L’utilisation des applets de commande PowerShellGet est la méthode d’installation préférée. Installez le module Az uniquement pour l’utilisateur actuel. C’est la portée d’installation recommandée. Cette méthode fonctionne de la même manière surWindows, macOS et Linux. Exécutez la commande suivante à partir d’une session PowerShell:

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

réponseYes ouYes to All pour continuer l’installation.

Installer pour Tous les Utilisateurs

l’Installation d’un module pour tous les utilisateurs sur un système requiert des privilèges élevés. Démarrez la session PowerShell en utilisant exécuter en tant qu’administrateur sous Windows ou utilisez la commande sudo sous macOS ou Linux:

le module Az est un module cumulatif pour les applets de commande Azure PowerShell., Son installation télécharge tous les modules az PowerShell généralement disponibles et rend leurs applets de commande disponibles.

installer hors ligne

Dans certains environnements, il n’est pas possible de se connecter à la galerie PowerShell. Dans ces situations, vous pouvez toujours installer hors ligne en utilisant l’une des méthodes suivantes:

• Téléchargez les modules Vers un autre emplacement de votre réseau et utilisez-les comme source d’installation.Cette méthode vous permet de mettre en cache des modules PowerShell sur un seul serveur ou 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 installersur des systèmes déconnectés avectravailler avec des référentiels PowerShellGet locaux.

• Téléchargez le MSI Azure PowerShell sur une machine connectée au réseau,puis copiez le programme d’installation sur des systèmes sans accès à la galerie PowerShell. Gardez à l’esprit que themsi installer ne fonctionne que pour PowerShell 5.1 sous 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 machines:

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

dépannage

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, déposez un problème sur GitHub.

le Proxy bloque la connexion

Si vous obtenez des erreurs deInstall-Module qui indiquent que la galerie PowerShell est inaccessible, vous pouvez peut-être derrière un proxy., Différents systèmes d’exploitation et environnement réseau ont des exigences différentespour configurer un proxy à l’échelle du système. Contactez votre administrateur système pour connaître les paramètres de votre proxy etcomment les configurer pour votre environnement.

PowerShell lui-même peut ne pas être configuré pour utiliser ce proxy automatiquement. Avec PowerShell 5.1 andlater, configurez la session PowerShell pour utiliser un proxy à l’aide des commandes suivantes:

Si vos informations d’identification du système d’exploitation sont configurées correctement, cette configuration achemine les requêtes PowerShellrequests via le proxy., Pour que ce paramètre persiste entre les sessions, ajoutez les commandes au profil yourPowerShell.

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

Sign in

To start working with Azure PowerShell, sign in with your Azure credentials.

vous devrez répéter ces étapes pour chaque nouvelle session PowerShell que vous démarrez. Pour savoir comment répertorier votre connexion Azure entre les sessions PowerShell, seePersist informations d’identification utilisateur entre les sessions PowerShell.,

mettre à jour le module Azure PowerShell

pour mettre à jour n’importe quel module PowerShell, vous devez utiliser la même méthode que celle utilisée pour installer le module. Par exemple, si vous utilisiez à l’origine Install-Module, vous devez utiliser le module Update 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. MSIpackages ne met pas à jour les modules installés à L’aide de PowerShellGet., Si vous avez des problèmesupdating en utilisant PowershellGet, alors vous devriez réinstaller, plutôt que de mettre à jour. Réinstaller isdone de la même manière que l’installation, mais vous devez ajouter le paramètre -Force:

Contrairement aux installations basées sur MSI, l’installation ou la mise à jour à L’aide de PowerShellGet ne supprime pas les anciennes versions 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 un MSI.,

Utilisation de plusieurs versions d’Azure PowerShell

Il est possible d’installer plus d’une version d’Azure PowerShell. Pour vérifier si vous avez installé plusieurs versions D’Azure PowerShell, 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 plusieurs versions du module installées, le chargement automatique du module etImport-Module chargentla dernière version par défaut.,

Vous pouvez installer ou charger une version spécifique du moduleAzen utilisant le paramètre-RequiredVersion:

utilisez plusieurs référentiels avec PowerShellGet

le paramètre Repository est requis si vous avez ajouté des référentiels supplémentaires à PowerShellGeton votre système et que le module Az se trouve dans plusieurs d’entre eux.

feedback

Si vous trouvez un bogue dans Azure PowerShell,déposez un problème sur GitHub. Pour fournir un feedbackà partir de la ligne de commande, utilisez L’applet de commande Send-Feedback.,

pour en savoir plus sur les modules Azure PowerShell et leurs fonctionnalités, seeGet a commencé avec Azure PowerShell. Si vous connaissez AzurePowerShell et avez besoin de migrer D’AzureRM, seeMigrate D’AzureRM à Az.