Installera Azure Active Directory PowerShell för Graph
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.
Om PowerShell-galleriet
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:
- Söka bland objekten i galleriet med Find-Module och Find-Script
- Spara objekt i systemet från galleriet med Save-Module och Save-Script
- Installera objekt från galleriet med Install-Module och Install-Script
- Ladda upp objekt till galleriet med Publish-Module och Publish-Script
- Lägga till en egen anpassad databas med Register-PSRepository
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.