Installera Microsoft Entra PowerShell

Med Microsoft Entra PowerShell-modulen kan IT-proffs effektivt hantera Microsoft Entra resurser, vilket säkerställer sömlös integrering och funktionalitet på olika plattformar. Den här modulen förbättrar din förmåga att automatisera och effektivisera administrativa uppgifter.

I den här artikeln får du lära dig hur du installerar, verifierar, uppdaterar och felsöker Microsoft Entra PowerShell-modulen i de olika operativsystemen.

Microsoft Entra PowerShell-modulen är uppdelad i två moduler, var och en med undermoduler som kan installeras separat. De två huvudmodulerna är:

  • Microsoft. Entra – allmän tillgänglighet eller v1.0 version av Microsoft Entra PowerShell. Den pekar på Microsoft Graph v1.0- och Microsoft Graph PowerShell SDK v1.0-resurser.
  • Microsoft. Entra.Beta – Beta eller förhandsversion av Microsoft Entra PowerShell. Den pekar på Microsoft Graph Beta- och Microsoft Graph PowerShell SDK Beta-resurser.

PowerShell version 7 eller senare rekommenderas för användning med Microsoft Entra PowerShell-modulen på alla plattformar, inklusive Windows, Linux och macOS.

Installera Microsoft Entra PowerShell-modulen på Windows

Den rekommenderade installationsmetoden och PowerShell-versionen för modulen:

  • Installera från PowerShell Gallery
  • Använd med Windows PowerShell 5.1+ eller PowerShell 7+.

Förutsättningar för Windows

  • Kör följande kommando från PowerShell för att fastställa din PowerShell-version:

    $PSVersionTable.PSVersion

  • Kontrollera om du har modulen installerad:

    Get-Module -Name Microsoft.Entra -ListAvailable

  • Ange PowerShell-körningsprincipen till fjärrsignerad eller mindre restriktiv

    • Kontrollera PowerShell-körningsprincipen:

      Get-ExecutionPolicy -List

    • Ställ in PowerShell-körningspolicyn till fjärrsignerad:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    Mer information om exekveringsprinciper finns i about_Execution_Policies.

Installation

När du installerar modulen kan du välja att installera hela modulen eller en specifik undermodul. I följande exempel visas hur du installerar hela modulen för både v1.0 och Beta.

Använd cmdleten Install-Module för att installera modulen.

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

Du kan också ändra omfånget för installationen med hjälp av parametern Omfång . Den här åtgärden kräver administratörsbehörigheter.

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

Installera specifika undermoduler

Att installera specifika moduler är perfekt för automatiseringsscenarier som att använda Azure Functions och Azure Automation.

Kör följande kommando för att visa alla Microsoft.Entra GA/v1.0-moduler i PowerShell Gallery:

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

Det här kommandot visar alla Microsoft Entra PowerShell-moduler GA/v1.0 i PowerShell Gallery.

Om du till exempel vill installera modulen Users kör du följande kommando:

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

Installera Microsoft Entra PowerShell på Linux

Krav i Linux

Installation på Linux

När du installerar modulen kan du välja att installera hela modulen eller en specifik undermodul. I följande exempel visas hur du installerar hela modulen.

Öppna terminalen eller andra gränssnittsvärdprogram och kör pwsh för att starta PowerShell.

Använd cmdleten Install-Module för att installera modulen:

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

Du kan också ändra omfånget för installationen med hjälp av parametern Omfång . Den här åtgärden kräver administratörsbehörigheter.

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

Installera specifika undermoduler i Linux

Att installera specifika moduler är perfekt för automatiseringsscenarier som att använda Azure Functions och Azure Automation.

Kör följande kommando för att visa alla Microsoft.Entra GA/v1.0-moduler i PowerShell Gallery:

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

Det här kommandot visar alla Microsoft Entra PowerShell-moduler GA/v1.0 i PowerShell Gallery.

Om du till exempel vill installera modulen Users kör du följande kommando:

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

Installera Microsoft Entra PowerShell på macOS

I den här artikeln beskrivs hur du installerar modulen från PowerShell Gallery på macOS.

Krav för macOS

Installation på macOS

När du installerar modulen kan du välja att installera hela modulen eller en specifik undermodul. I följande exempel visas hur du installerar hela modulen.

Öppna terminalen eller andra gränssnittsvärdprogram och kör pwsh för att starta PowerShell.

Använd cmdleten Install-Module för att installera Microsoft Entra PowerShell-modulen:

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

Du kan också ändra omfånget för installationen med hjälp av parametern Omfång . Den här åtgärden kräver administratörsbehörigheter.

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

Installera specifika undermoduler på macOS

Att installera specifika moduler är perfekt för automatiseringsscenarier som att använda Azure Functions och Azure Automation.

Kör följande kommando för att visa alla Microsoft.Entra GA/v1.0-moduler i PowerShell Gallery:

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

Det här kommandot visar alla Microsoft Entra PowerShell-moduler GA/v1.0 i PowerShell Gallery.

Om du till exempel vill installera modulen Users kör du följande kommando:

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

Verifiera installerad modulversion och plats

När installationen är klar kan du verifiera de installerade undermodulerna, deras version och plats med följande kommando.

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

Det här kommandot visar den installerade Microsoft Entra PowerShell-modulen, dess version och installationsplats. Utdataversionen ska matcha den senaste versionen på PowerShell Gallery. Nu är du redo att använda modulen.

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

Om du till exempel Users vill kontrollera om en specifik undermodul är installerad kör du:

Get-InstalledModule -Name Microsoft.Entra.Users

Utdataversionen ska matcha den senaste versionen på PowerShell Gallery.

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

Felsöka installationsproblem

Error Orsak Övergångslösning
Install-Module: Det går inte att hitta en parameter som matchar parameternamnet AllowPrerelease. Du använder en äldre version av Install-Module. Följ den här guiden om du vill uppgradera. Problemet gäller endast Windows plattform.
Den beroende modulen "module-name" är inte installerad på den här datorn. Så här använder du den aktuella modulen "Microsoft. Entra, se till att den beroende modulen "module-name" är installerad. Microsoft Entra PowerShell-beroenden är inte installerade Om du vill installera använder du det här skriptet
Cmdlet finns redan på systemet Lägg till -AllowClobber parameter: Install-Module -Name Microsoft.Entra -Repository PSGallery -Force -AllowClobber
Följande kommandon är redan tillgängliga i det här systemet: "Enable-EntraAzureADAlias,Get-EntraUnsupportedCommand,Test-EntraScript" Det finns en konflikt när antingen Beta eller v1.0 redan är installerad Lös problemet genom att avinstallera den felaktiga modulversionen.

Lösningar på andra vanliga installationer och andra allmänna problem finns i Felsöka problem med modulinstallation.

Logga in

Om du vill börja hantera dina Microsoft Entra resurser med Microsoft Entra PowerShell-modulen startar du en PowerShell-session och kör Connect-Entra för att logga in på Microsoft Entra ID:

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

Använd dina Microsoft Entra autentiseringsuppgifter för att logga in på inloggningsfönstret som öppnas.

Du måste upprepa det här steget för varje ny PowerShell-session som du startar.

Mer information om andra autentiseringsscenarier finns i fler autentiseringsscenarier.

Uppdatera modulen

Om modulen är installerad följer du de här stegen för att uppdatera den.

Kontrollera först modulversionen och platsen med hjälp av vägledningen i avsnittet verifiera installationen i den här artikeln.

Uppdatera till den senaste versionen

Använd Update-Module för att uppdatera till den senaste versionen av Microsoft Entra PowerShell-modulen.

Update-Module -Name Microsoft.Entra -Force

Om du vill uppdatera en specifik undermodul, till exempel Users, kör du:

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

Att uppdatera Microsoft Entra PowerShell-modulen med hjälp Update-Module av tar inte bort gamla versioner av modulen från systemet.

Avinstallera modulen

Om du vill ta bort modulen kör du kommandot:

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

Så här avinstallerar du en specifik undermodul, till exempel Users, kör:

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

Om du vill avinstallera alla undermoduler kör du:

$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
}

Nästa steg

  • Mer information om hur du navigerar i Microsoft Entra PowerShell-modulen finns i artikeln Navigera i modulen.
  • Last updated on