Azure Active Directory PowerShell för Graph

  • Artikel

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. De cmdletar som anges här skiljer sig från de MSOL-cmdletar som ingår i MSOnline PowerShell-modulen.

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

Förhandsgranskningsmodulen Azure AD PowerShell för Graph kan laddas ned från PowerShell-galleriet på sidan AzureADPreview.

Modulen Azure AD PowerShell för allmän graph-tillgänglighet kan laddas ned från PowerShell-galleriet på AzureAD-sidan.

Installera Azure AD-modulen

Azure AD PowerShell för Graph-modulen 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 eller Windows Server 2008 R2.

Om datorn uppfyller installationskraven kan du installera den allmänt tillgängliga versionen av modulen på datorn genom att köra

Install-Module AzureAD

Om du vill installera den offentliga förhandsversionen använder du

Install-module AzureADPreview

Observera att du inte kan installera både förhandsversionen och den allmänt tillgängliga versionen samtidigt på samma dator.

Azure AD-modulen distribueras via PowerShell-galleriet. För att kunna installera objekt från galleriet krävs den senaste versionen av modulen PowerShellGet. Den är tillgänglig i Windows 10, Windows Management Framework 5.0 (WMF) och 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

Du kan kontrollera vilken version av modulen som du har installerat på datorn genom att köra följande kommando:

PS C:\WINDOWS\system32> 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 på nytt:

PS C:\WINDOWS\system32> Install-Module AzureADPreview

Med det här kommandot kontrolleras om det finns en nyare version tillgänglig i PowerShell-galleriet, och i så fall installeras den versionen 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 därmed 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.

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.

Har du förslag?

Om du har förslag på hur du kan förbättra Azure Active Directory PowerShell, tveka inte att meddela oss!

Mer information om Windows PowerShell

Windows PowerShell är ett uppgiftsbaserat kommandoradsgränssnitt och skriptspråk som utformats för systemadministration. Till skillnad från de flesta gränssnitt, som godkänner och returnerar text, bygger Windows PowerShell på .NET Framework och godkänner och returnerar .NET Framework-objekt.

I Windows PowerShell används något som kallas cmdlet (uttalas på engelska ”command-let”), som är ett enkelt kommandoradsverktyg för enskilda funktioner som är inbyggt i gränssnittet. Cmdletar har följande namngivningskonvention: ett verb och ett substantiv avgränsat med ett bindestreck (-), till exempel Get-Help, Get-Process och Start-Service. I Windows PowerShell finns flera hundra grundläggande cmdletar.

Om du vill ha mer information om cmdletar eller deras syntax kan du använda kommandot Get-Help <cmdlet name>, där <cmdlet name> är namnet på den cmdlet som du vill veta mer om. Om du vill ha mer detaljerad information kör du följande kommandon:

  • Get-Help <cmdlet name> -Detailed
  • Get-Help <cmdlet name> -Examples
  • Get-Help <cmdlet name> -Full

Mer information om Windows PowerShell finns i Komma igång med Windows PowerShell.