Installera Azure Active Directory PowerShell för Graph

  • Artikel

Viktigt

Azure AD Powershell planeras att fasas ut den 30 mars 2024. Mer information om utfasningsplanerna finns i utfasningsuppdateringen. Vi rekommenderar att du fortsätter att migrera till Microsoft Graph PowerShell, som är den rekommenderade modulen för att interagera med Azure AD. Dessutom ger Microsoft Graph PowerShell dig åtkomst till alla Microsoft Graph-API:er och är tillgängligt i PowerShell 7. Svar på vanliga migreringsfrågor finns i Vanliga frågor och svar om migrering.

Du kan använda Azure Active Directory PowerShell-modulversionen för Graph för Azure AD administrativa uppgifter som användarhantering, domänhantering och för att konfigurera enkel inloggning. Cmdletarna som anges här skiljer sig från MSOnline-cmdletarna som ingår i Azure Active Directory PowerShell version 1.0.

Modulen Azure AD PowerShell för Graph har två versioner: en allmänt tillgänglig förhandsversion och en allmän tillgänglighetsversion (GA). Vi rekommenderar inte att du använder den allmänt tillgängliga förhandsversionen för produktionsscenarier.

Ladda ned modulerna från PowerShell-galleriet använda följande;

Versionshistorik för Azure Active Directory PowerShell för Graph

Versionshistoriken för modulen Azure AD och modulen Azure AD Förhandsversion finns här:azure active directory powershell för graph: versionshistorik.

Installera Azure AD-modulen

Förutsättningar

Modulen Azure AD stöds på följande Windows-operativsystem med standardversionen av Microsoft .NET Framework och Windows PowerShell:

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

Anteckning

Azure AD PowerShell-modulen är inte kompatibel med PowerShell 7. Det stöds bara i PowerShell 5.1.

Installera den allmänt tillgängliga versionen av modulen genom att köra:

Install-Module AzureAD

Om du vill installera den offentliga förhandsversionen kör du:

Install-module AzureADPreview

Du kan inte installera både förhandsversionen och ga-versionen på samma dator samtidigt.

Modulen Azure AD distribueras med hjälp av PowerShell-galleriet. Installation av objekt från galleriet kräver den senaste versionen av PowerShellGet-modulen, som är tillgänglig i Windows 10, i Windows Management Framework (WMF) 5.0 eller i det MSI-baserade installationsprogrammet (för PowerShell 3 och 4).

Med den senaste PowerShellGet-modulen kan du:

Se Komma igång för mer information om hur du använder PowerShellGet-kommandon med galleriet. Du kan också köra Update-Help -Module PowerShellGet om du vill installera lokal hjälp för dessa kommandon.

Operativsystem som stöds

PowerShellGet-modulen kräver PowerShell 3.0 eller senare.

Det innebär att PowerShellGet kräver något av följande operativsystem:

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

PowerShellGet kräver också .NET Framework 4.5 eller senare. Du kan installera .NET Framework 4.5 eller senare här.

Uppdatera Azure AD-modulen

Kör följande kommando för att kontrollera vilken version av modulen som är installerad på datorn:

Get-Module AzureADPreview

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

Om du vill uppdatera versionen av Azure AD PowerShell-modulen på datorn kör du cmdleten Install-Module igen:

Install-Module AzureADPreview

Det här kommandot kontrollerar PowerShell-galleriet för att se om en nyare version är tillgänglig. Om ja, den nyare än den som är installerad på datorn.

Anslut till Azure AD

Innan du kan köra någon av cmdletarna i den här artikeln måste du ansluta till din onlinetjänst. Det gör du genom att köra cmdleten Connect-AzureAD i Windows PowerShell-kommandotolken. Du uppmanas sedan att ange dina autentiseringsuppgifter. Om du vill kan du ange dina autentiseringsuppgifter i förväg. Exempel:

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

Det första kommandot frågar efter autentiseringsuppgifter och lagrar dem som $AzureAdCred. Nästa kommando använder dessa autentiseringsuppgifter som $azureadcred för att ansluta till tjänsten.

Anteckning

Modulerna Azure AD och Azure AD Preview består av cmdletar med olika namngivningskonventioner, t.ex. -AzureAD och -AzureADMS. Cmdletarna -AzureAD ansluter till Azure AD Graph-slutpunkten https://graph.windows.net medan -AzureADMS cmdletarna anropar Microsoft Graph-slutpunkten graph.microsoft.com. Autentiseringen hanteras tyst när du ändrar anropen från en slutpunkt till en annan och du inte uppmanas att ange autentiseringsuppgifterna igen.

Om du vill ansluta till en viss miljö i Azure Active Directory använder du parametern AzureEnvironment på följande sätt:

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

I det här exemplet ansluts din PowerShell-session till den tyska AzureAD-miljön. Se Connect-AzureAD för mer information.

Nästa steg