Si vous êtes amenés à gérer et administrer un ou plusieurs tenants Azure AD au quotidien, et que vous souhaitez automatiser toutes les tâches et opérations répétitives et fastidieuses, eh bien sachez que vous êtes à la bonne adresse :).
Aujourd’hui, je vais vous parler d’un module PowerShell qui va vous faciliter la vie quand il s’agit de déployer, gérer, administrer mais aussi troubleshooter Azure Active Directory.
Il s’agit du module « AzureAD » (ou Azure Active Directory PowerShell for Graph).
Les Cmd-Lets fournies avec ce Module vous permettent de récupérer les données à partir de l’annuaire/service Azure Active Directory, créer de nouveaux objets, modifier et mettre à jour les objets existants, supprimer des objets AAD, mais aussi configurer votre tenant Azure AD et ses options /fonctionnalités associées.
Enfin, notez que le module AzureAD vous permet également de gérer vos AAD Application Proxy et Connecteurs.
HowTo : Installer le module PowerShell AzureAD
Le module AzureAD est disponible depuis la PowerShellGallery et peut être installer via un simple
Install-Module AzureAD
HowTo : Utiliser le module PowerShell AzureAD
Une fois installé, commencez par importer le module « AzureAD » en saisissant la commande suivante :
Import-Module AzureAD
ou simplement
ipmo AzureAD
Exécutez ensuite la commande suivante pour lister toutes les Cmd-lets du module PowerShell AzureAD :
Get-Command -Module AzureAD | ft -AutoSize
Vous pouvez connaitre le nombre exact des Cmd-lets fournies avec le module AzureAD en exécutant la commande ci-dessous :
(Get-Command -Module AzureAD).Count
164 Cmd-Lets au total sont fournies avec le module PowerShell AzureAD, cela vous permet d’automatiser presque toutes les opérations disponibles depuis le Nouveau Portail Azure (portal.azure.com)
Avant de pouvoir créer et gérer vos objets (users & groups) Azure AD, vous devez connecter votre Interface PowerShell à votre tenant AzureAD, pour ce faire, saisissez la commande suivante :
Connect-AzureAD
Vous êtes invités à renseigner votre compte Microsoft (ou Professionnel) pour vous connecter :
Comme montré ci-dessous, mon compte Azure a été connecté correctement :
Commençons maintenant par lister tous les users AzureAD existants, saisissez la commande suivante :
Get-AzureADUser
Pour créer un nouvel utilisateur AzureAD, la commande suivante sera utilisée :
Note : dans l’exemple suivant, nous allons créer un nouvel utilisateur avec les informations suivantes :
UPN : hicham.kadiri-demo@k-nd-k-group.com
GivenName : hicham.kadiri-demo
DisplayName : Hicham KADIRI
City : Paris
Country : France
Department : IT
Mot de passe : « MyP@ss0rd2018! »
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile $PasswordProfile.Password = « MyP@ss0rd2018! »
New-AzureADUser -City Paris -Country France -Department IT -DisplayName « Hicham KADIRI » -GivenName hicham.kadiri-demo -JobTitle « Azure Cloud Architect » -AccountEnabled $true -PostalCode 75000 -UserPrincipalName hicham.kadiri-demo@k-nd-k-group.com -PasswordProfile $PasswordProfile -MailNickName hicham.kadiri-demo
Pour supprimer cette fois-ci l’utilisateur créé précédemment, exécutez la commande suivante :
- Notez que vous devez d’abord exécutez la Cmd-let Get-AzureADUser pour récupérer l’ObjectID de l’utilisateur à supprimer (af3dbbdd-e51b-44e3-8944-91150d296fd4 dans l’exemple suivant) :
- Remove-AzureADUser -ObjectId af3dbbdd-e51b-44e3-8944-91150d296fd4
Vous pouvez lister tous les domaines AAD déclarés/enregistrés en saisissant la commande suivante :
Get-AzureADDomain
La liste des devices enregistrés dans votre domaine Azure AD peut être obtenue via la commande suivante :
Get-AzureADDevice
Je vous invite à consulter cet article pour en savoir plus sur l’ensemble des Cmd-lets fournies avec le module AzureAD.
Blog de Hicham KADIRI | Just Another IT Guy 