Installer Microsoft Entra PowerShell

Le module PowerShell Microsoft Entra permet aux professionnels de l’informatique de gérer efficacement les ressources Microsoft Entra, ce qui garantit une intégration et des fonctionnalités transparentes sur différentes plateformes. Ce module améliore votre capacité à automatiser et à rationaliser les tâches administratives.

Dans cet article, vous allez apprendre à installer, vérifier, mettre à jour et résoudre les problèmes du module PowerShell Microsoft Entra sur les différents systèmes d’exploitation.

Le module PowerShell Microsoft Entra est divisé en deux modules, chacun avec des sous-modules qui peuvent être installés séparément. Les deux modules principaux sont les suivants :

  • Microsoft. Entra : disponibilité générale ou v1.0 version de Microsoft Entra PowerShell. Il pointe vers les ressources Microsoft Graph v1.0 et Microsoft Graph - SDK PowerShell v1.0.
  • Microsoft. Entra.Beta : version Beta préliminaire de Microsoft Entra PowerShell. Il pointe vers les ressources bêta de Microsoft Graph et le SDK bêta Microsoft Graph PowerShell.

PowerShell version 7 ou ultérieure est recommandé pour une utilisation avec le module PowerShell Microsoft Entra sur toutes les plateformes, notamment Windows, Linux et macOS.

Installez le module PowerShell Microsoft Entra sur Windows

Méthode d’installation recommandée et version PowerShell pour le module :

  • Installer à partir du PowerShell Gallery
  • Utilisez Windows PowerShell 5.1+ ou PowerShell 7+.

Conditions préalables sur Windows

  • Exécutez la commande suivante à partir de PowerShell pour déterminer votre version de PowerShell :

    $PSVersionTable.PSVersion

  • Déterminez si le module est installé :

    Get-Module -Name Microsoft.Entra -ListAvailable

  • Définissez la politique d'exécution PowerShell sur «RemoteSigned» ou moins restrictive

    • Vérifiez la stratégie d’exécution de PowerShell :

      Get-ExecutionPolicy -List

    • Définissez la stratégie d’exécution PowerShell sur RemoteSigned :

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    Pour plus d’informations sur les stratégies d’exécution, consultez about_Execution_Policies.

Installation

Lors de l’installation du module, vous pouvez choisir d’installer l’intégralité du module ou un sous-module spécifique. Les exemples suivants montrent comment installer l’intégralité du module pour les deux v1.0 et Beta.

Utilisez l’applet de commande Install-Module pour installer le module.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

Si vous le souhaitez, vous pouvez modifier l’étendue de l’installation à l’aide du paramètre Scope . Cette opération nécessite des autorisations d’administrateur.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Installer des sous-modules spécifiques

L’installation de modules spécifiques est idéale pour les scénarios d’automatisation tels que l’utilisation de Azure Functions et de Azure Automation.

Exécutez la commande suivante pour lister tous les modules Microsoft.Entra GA/v1.0 dans PowerShell Gallery :

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Cette commande répertorie tous les modules Microsoft Entra PowerShell GA/v1.0 dans la PowerShell Gallery.

Par exemple, pour installer le Users module, exécutez la commande suivante :

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Installer Microsoft Entra PowerShell sur Linux

Conditions préalables sur Linux

Installation sur Linux

Lors de l’installation du module, vous pouvez choisir d’installer l’intégralité du module ou un sous-module spécifique. L’exemple suivant montre comment installer l’intégralité du module.

Ouvrez le terminal ou une autre application hôte shell et exécutez-le pwsh pour démarrer PowerShell.

Utilisez l’applet de commande Install-Module pour installer le module :

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

Si vous le souhaitez, vous pouvez modifier l’étendue de l’installation à l’aide du paramètre Scope . Cette opération nécessite des autorisations d’administrateur.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Installer des sous-modules spécifiques sur Linux

L’installation de modules spécifiques est idéale pour les scénarios d’automatisation tels que l’utilisation de Azure Functions et de Azure Automation.

Exécutez la commande suivante pour lister tous les modules Microsoft.Entra GA/v1.0 dans PowerShell Gallery :

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Cette commande répertorie tous les modules Microsoft Entra PowerShell GA/v1.0 dans la PowerShell Gallery.

Par exemple, pour installer le Users module, exécutez la commande suivante :

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Installer Microsoft Entra PowerShell sur macOS

Cet article explique comment installer le module à partir du PowerShell Gallery sur macOS.

Conditions préalables sur macOS

Installation sur macOS

Lors de l’installation du module, vous pouvez choisir d’installer l’intégralité du module ou un sous-module spécifique. L’exemple suivant montre comment installer l’intégralité du module.

Ouvrez le terminal ou une autre application hôte shell et exécutez-le pwsh pour démarrer PowerShell.

Utilisez l’applet de commande Install-Module pour installer le module PowerShell Microsoft Entra :

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

Si vous le souhaitez, vous pouvez modifier l’étendue de l’installation à l’aide du paramètre Scope . Cette opération nécessite des autorisations d’administrateur.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Installer des sous-modules spécifiques sur macOS

L’installation de modules spécifiques est idéale pour les scénarios d’automatisation tels que l’utilisation de Azure Functions et de Azure Automation.

Exécutez la commande suivante pour lister tous les modules Microsoft.Entra GA/v1.0 dans PowerShell Gallery :

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Cette commande répertorie tous les modules Microsoft Entra PowerShell GA/v1.0 dans la galerie PowerShell.

Par exemple, pour installer le Users module, exécutez la commande suivante :

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Vérifier la version et l’emplacement du module installés

Une fois l’installation terminée, vous pouvez vérifier les sous-modules installés, leur version et leur emplacement avec la commande suivante.

Get-InstalledModule -Name Microsoft.Entra* |
Where-Object { $_.Name -notmatch "Beta" } | Format-Table Name, Version, InstalledLocation -AutoSize

Cette commande affiche l’Microsoft Entra module PowerShell installé, sa version et son emplacement d’installation. La version de sortie doit correspondre à la dernière version du PowerShell Gallery. Vous êtes maintenant prêt à utiliser le module.

Name                                Version InstalledLocation
----                                ------- -----------------
Microsoft.Entra                     1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra\1.0.1
Microsoft.Entra.Applications        1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Applications\1.0.1
Microsoft.Entra.Authentication      1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Authentication\1.0.1
Microsoft.Entra.DirectoryManagement 1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.DirectoryManagement\1.0.1
Microsoft.Entra.Governance          1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Governance\1.0.1
Microsoft.Entra.Groups              1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Groups\1.0.1
Microsoft.Entra.Reports             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Reports\1.0.1
Microsoft.Entra.SignIns             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.SignIns\1.0.1
Microsoft.Entra.Users               1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Users\1.0.1

Pour vérifier si un sous-module spécifique, par exemple, Users est installé, exécutez :

Get-InstalledModule -Name Microsoft.Entra.Users

La version de sortie doit correspondre à la dernière version du PowerShell Gallery.

Version              Name                                Repository           Description
-------              ----                                ----------           -----------
1.0.1                Microsoft.Entra.Users               PSGallery            Microsoft Entra PowerShell

Résoudre les problèmes d’installation

Error Cause Solution de contournement
Install-Module : un paramètre est introuvable qui correspond au nom de paramètre AllowPrerelease. Vous utilisez une version antérieure d’Install-Module. Pour effectuer une mise à niveau, suivez ce guide. Le problème s’applique uniquement à Windows plateforme.
Le module dépendant « module-name » n’est pas installé sur cet ordinateur. Pour utiliser le module actuel ' Microsoft. Entra, vérifiez que son module dépendant « module-name » est installé. Les dépendances PowerShell de Microsoft Entra ne sont pas installées Pour l’installer, utilisez ce script
Les applets de commande existent déjà sur le système Ajouter un -AllowClobber paramètre : Install-Module -Name Microsoft.Entra -Repository PSGallery -Force -AllowClobber
Les commandes suivantes sont déjà disponibles sur ce système : « Enable-EntraAzureADAlias, Get-EntraUnsupportedCommand, Test-EntraScript » Il y a un conflit si Beta ou v1.0 est déjà installé Pour résoudre le problème, désinstallez la version de module incriminant.

Pour obtenir des solutions à d’autres problèmes courants d’installation et d’autres problèmes généraux, consultez Résoudre les problèmes d’installation du module.

Connectez-vous

Pour commencer à gérer vos ressources Microsoft Entra avec le module PowerShell Microsoft Entra, lancez une session PowerShell et exécutez Connect-Entra pour vous connecter à Microsoft Entra ID :

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUser -Filter "userPrincipalName eq 'SawyerM@contoso.com'"

Utilisez vos informations d’identification Microsoft Entra pour vous connecter à la fenêtre de connexion qui s’ouvre.

Vous devez répéter cette étape pour chaque nouvelle session PowerShell que vous démarrez.

Pour plus d’informations sur d’autres scénarios d’authentification, consultez d’autres scénarios d’authentification.

Mettre à jour le module

Si le module est installé, procédez comme suit pour le mettre à jour.

Tout d’abord, vérifiez la version et l’emplacement du module à l’aide des instructions de la section vérifier l’installation de cet article.

Mise à jour vers la dernière version

Utilisez Update-Module pour effectuer une mise à jour vers la dernière version du module PowerShell Microsoft Entra.

Update-Module -Name Microsoft.Entra -Force

Pour mettre à jour un sous-module spécifique, tel que Users, exécutez :

Update-Module -Name Microsoft.Entra.Users -Force

La mise à jour du module Microsoft Entra PowerShell à l'aide Update-Module de ne supprime pas les anciennes versions du module de votre système.

Désinstaller le module Az

Pour supprimer le module, exécutez la commande :

Uninstall-Module -Name Microsoft.Entra -AllVersions -Force

Pour désinstaller un sous-module spécifique, tel que Users, exécutez :

Uninstall-Module -Name Microsoft.Entra.Users -AllVersions -Force

Pour désinstaller toutes les sous-modules, exécutez :

$InstalledSubModules = Get-InstalledModule -Name Microsoft.Entra.* |
Where-Object { $_.Name -notmatch "Beta" }
foreach ($module in $InstalledSubModules) {
    Write-Host "Checking for submodule: $($module.Name)" -ForegroundColor Yellow -BackgroundColor DarkBlue
    Uninstall-Module -Name $module.Name -Force -ErrorAction Stop
    Write-Host "Successfully uninstalled submodule: $($module.Name)" -ForegroundColor Green
}

Étapes suivantes

  • Last updated on