Installer Azure Active Directory PowerShell pour Graph

  • Article

Important

La dépréciation d’Azure AD PowerShell est prévue le 30 mars 2024. Pour plus d’informations sur les plans de dépréciation, consultez la mise à jour de la dépréciation. Nous vous encourageons à poursuivre la migration vers Microsoft Graph PowerShell, qui est le module recommandé pour interagir avec Azure AD. En outre, Microsoft Graph PowerShell vous permet d’accéder à toutes les API Microsoft Graph et est disponible sur PowerShell 7. Pour obtenir des réponses aux requêtes de migration fréquentes, consultez le FAQ sur la migration.

Vous pouvez utiliser la version du module PowerShell Azure Active Directory pour Graph pour les tâches administratives Azure AD telles que la gestion des utilisateurs, la gestion de domaine et la configuration de l’authentification unique. Les applets de commande répertoriées ici sont différentes des applets de commande MSOnline qui font partie d’Azure Active Directory PowerShell version 1.0.

Le module Azure AD PowerShell pour Graph a deux versions : une version en préversion publique et une version de disponibilité générale (GA). Il n’est pas recommandé d’utiliser la préversion publique pour des scénarios de production.

Téléchargez les modules à partir du PowerShell Gallery utilisez les éléments suivants :

Historique des versions d’Azure Active Directory PowerShell pour Graph

L’historique des versions pour le module Azure AD et le module Azure AD Preview est ici :azure active directory powershell pour graph : historique des versions.

Installation du module Azure AD

Prérequis

Le module Azure AD est pris en charge sur les systèmes d’exploitation Windows suivants avec la version par défaut de Microsoft .NET Framework et Windows PowerShell :

  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Server 2012 R2,
  • Windows Server 2012
  • Windows Server 2008 R2.

Notes

Le module Azure AD PowerShell n’est pas compatible avec PowerShell 7. Il est uniquement pris en charge dans PowerShell 5.1.

Pour installer la version de disponibilité générale du module, exécutez :

Install-Module AzureAD

Pour installer la préversion publique, exécutez :

Install-module AzureADPreview

Vous ne pouvez pas installer la version d’évaluation et la version en disponibilité générale sur le même ordinateur en même temps.

Le module Azure AD est distribué à l’aide du PowerShell Gallery. L’installation d’éléments à partir de la galerie nécessite la dernière version du module PowerShellGet, disponible dans Windows 10, dans Windows Management Framework (WMF) 5.0 ou dans le programme d’installation MSI (pour PowerShell 3 et 4).

Avec le module PowerShellGet le plus récent, vous pouvez effectuer les opérations suivantes :

Pour plus d’informations sur l’utilisation des commandes PowerShellGet avec la galerie, consultez la page Getting Started. Vous pouvez également exécuter Update-Help-Module PowerShellGet pour installer l’aide locale sur ces commandes.

Systèmes d’exploitation pris en charge

Le module PowerShellGet nécessite PowerShell 3.0 ou ultérieur.

Par conséquent, PowerShellGet nécessite l’un des systèmes d’exploitation suivants :

  • Windows 10
  • Windows 8.1 Professionnel
  • Windows 8.1 Enterprise
  • Windows 7 SP1
  • Windows Server 2016 TP5
  • Windows Server 2012 R2
  • Windows Server 2008 R2 SP1

PowerShellGet nécessite également .NET Framework 4.5 ou ultérieur. Vous pouvez installer .NET Framework 4.5 ou ultérieur à partir d’ici.

Mise à jour du module Azure AD

Pour case activée la version du module installée sur votre ordinateur, exécutez cette commande :

Get-Module AzureADPreview

ModuleType Version Name                ExportedCommands
---------- ------- ----                ----------------
Binary     2.0.0.7 azureadpreview     {Add-AzureADAdmini...

Pour mettre à jour la version du module Azure AD PowerShell sur votre ordinateur, réexécutez l’applet de commande Install-Module :

Install-Module AzureADPreview

Cette commande vérifie la galerie PowerShell pour voir si une version plus récente est disponible. Si oui, le plus récent que celui installé sur votre ordinateur.

Se connecter à Azure AD

Pour pouvoir exécuter les applets de commande décrites dans cet article, vous devez d’abord vous connecter à votre service en ligne. Pour ce faire, exécutez l’applet de commande Connect-AzureAD à l’invite de commande Windows PowerShell. Vous serez ensuite invité à entrer vos informations d’identification. Si vous le souhaitez, vous pouvez fournir vos informations d’identification à l’avance, par exemple :

$AzureAdCred = Get-Credential
Connect-AzureAD -Credential $AzureAdCred

La première commande vous invite à entrer vos informations d’identification et les stocke sous la forme $AzureAdCred. La commande suivante utilise ces informations d’identification sous la forme $azureadcred pour se connecter au service.

Notes

Les modules Azure AD et Azure AD Preview se composent d’applets de commande avec différentes conventions de nommage, à savoir -AzureAD et -AzureADMS. Les -AzureAD applets de commande se connectent au point de terminaison https://graph.windows.net Azure AD Graph tandis que les -AzureADMS applets de commande effectuent des appels au point de terminaison graph.microsoft.comMicrosoft Graph . L’authentification est gérée en mode silencieux lorsque vous modifiez les appels d’un point de terminaison à un autre et que vous n’êtes plus invité à entrer les informations d’identification.

Pour vous connecter à un environnement spécifique d’Azure Active Directory, utilisez le paramètre AzureEnvironment comme suit :

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

Cet exemple décrit la connexion de votre session PowerShell à l’environnement Azure AD allemand. Consultez Connect-AzureAD pour plus d’informations.

Étapes suivantes