Installer Azure Active Directory PowerShell pour Graph
Vous pouvez utiliser la version du module PowerShell Azure Active Directory pour Graph pour les tâches d’administration 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 en disponibilité générale (GA). Nous ne vous recommandons pas d’utiliser la préversion publique pour les scénarios de production.
Pour télécharger les modules à partir de la PowerShell Gallery utilisez les éléments suivants ;
Historique des versions de la version d’Azure Active Directory PowerShell pour Graph
L’historique des versions pour le module Azure AD et le module Azure AD Preview se trouve 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. Elle est uniquement prise 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
Notez que vous ne pouvez pas installer la préversion et la version de disponibilité générale sur le même ordinateur en même temps.
À propos de PowerShell Gallery
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 basé sur MSI (pour PowerShell 3 et 4).
Avec le module PowerShellGet le plus récent, vous pouvez effectuer les opérations suivantes :
- Parcourir les éléments de la galerie avec Find-Module et Find-Script
- Enregistrer des éléments dans votre système à partir de la galerie avec Save-Module et Save-Script
- Installer des éléments à partir de la galerie avec Install-Module et Install-Script
- Charger des éléments dans la galerie avec Publish-Module et Publish-Script
- Ajouter votre propre référentiel personnalisé avec Register-PSRepository
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 vérifier 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 c’est le cas, 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 êtes 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 comprennent des applets de commande avec différentes conventions d’affectation de noms, c’est-à-dire -AzureAD-AzureADMS. Les -AzureAD applets de commande se connectent au point de terminaison https://graph.windows.net Azure AD Graph pendant 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 pas invité à entrer à nouveau 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
- Consultez les nouvelles fonctionnalités et améliorations.