Sdílet prostřednictvím

Instalace Azure Active Directory PowerShellu pro Graph

  • Článek

Důležité

Azure AD PowerShellu se plánuje 30. března 2024 vyřadit. Další podrobnosti o plánech vyřazení najdete v aktualizaci o vyřazení. Doporučujeme pokračovat v migraci na Microsoft Graph PowerShell, což je doporučený modul pro interakci s Azure AD. Microsoft Graph PowerShell navíc umožňuje přístup ke všem rozhraním Microsoft Graph API a je k dispozici v PowerShellu 7. Odpovědi na časté dotazy k migraci najdete v nejčastějších dotazech k migraci.

Verzi modulu Azure Active Directory PowerShell pro Graph můžete použít pro Azure AD úlohy správy, jako je správa uživatelů, správa domén a konfigurace jednotného přihlašování. Zde uvedené rutiny se liší od rutin MSOnline, které jsou součástí Azure Active Directory PowerShellu verze 1.0.

Modul Azure AD PowerShellu pro Graph má dvě verze: verzi Public Preview a verzi General Availability (GA). Pro produkční scénáře se nedoporučuje používat verzi Public Preview.

Stáhněte si moduly z Galerie prostředí PowerShell použijte následující:

Historie verzí Azure Active Directory PowerShellu pro Graph

Historie vydaných verzí modulu Azure AD a modulu Azure AD Preview je tady:azure active directory PowerShell for Graph: historie verzí.

Instalace modulu Azure AD

Požadavky

Modul Azure AD je podporován v následujících operačních systémech Windows s výchozí verzí rozhraní Microsoft .NET Framework a Windows PowerShell:

  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Server 2012 R2
  • Windows Server 2012
  • Windows Server 2008 R2.

Poznámka

Modul powershellu Azure AD není kompatibilní s PowerShellem 7. Podporuje se jenom v PowerShellu 5.1.

Pokud chcete nainstalovat verzi modulu Pro obecnou dostupnost, spusťte příkaz:

Install-Module AzureAD

Pokud chcete nainstalovat verzi Public Preview, spusťte příkaz:

Install-module AzureADPreview

Na stejný počítač nelze současně nainstalovat verzi Preview i verzi GA.

Modul Azure AD se distribuuje pomocí Galerie prostředí PowerShell. Instalace položek z galerie vyžaduje nejnovější verzi modulu PowerShellGet, která je k dispozici v Windows 10, v Windows Management Framework (WMF) 5.0 nebo v instalačním programu založeném na MSI (pro PowerShell 3 a 4).

S nejnovějším modulem PowerShellGet můžete:

Další informace o použití příkazů PowerShellGet pro galerii najdete na stránce Začínáme. Můžete také spuštěním příkazu Update-Help -Module PowerShellGet nainstalovat místní nápovědu pro tyto příkazy.

Podporované operační systémy

Modul PowerShellGet vyžaduje PowerShell 3.0 nebo novější.

Proto PowerShellGet vyžaduje jeden z těchto operačních systémů:

  • 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 také vyžaduje rozhraní .NET Framework 4.5 nebo novější. Rozhraní .NET Framework 4.5 nebo novější můžete nainstalovat odsud.

Aktualizace modulu Azure AD

Pokud chcete zkontrolovat verzi modulu nainstalovaného v počítači, spusťte tento příkaz:

Get-Module AzureADPreview

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

Pokud chcete aktualizovat verzi modulu Azure AD PowerShellu na počítači, spusťte znovu rutinu Install-Module:

Install-Module AzureADPreview

Tento příkaz zkontroluje galerii PowerShellu a zjistí, jestli je k dispozici novější verze. Pokud ano, novější než ten, který je nainstalovaný v počítači.

Připojení k Azure AD

Před spuštěním libovolné rutiny popsané v tomto článku se nejdřív musíte připojit k vaší službě online. Z příkazového řádku Windows PowerShellu proto spusťte rutinu Connect-AzureAD. Pak se zobrazí výzva k zadání přihlašovacích údajů. Pokud chcete, můžete přihlašovací údaje zadat v předstihu, třeba takto:

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

První příkaz vyzve k zadání přihlašovacích údajů a uloží je jako $AzureAdCred. Další příkaz využije tyto přihlašovací údaje jako $azureadcred pro připojení ke službě.

Poznámka

Moduly Azure AD a Azure AD Preview se skládají z rutin s různými konvencemi vytváření názvů, tj. -AzureAD a -AzureADMS. Rutiny -AzureAD se připojují ke koncovému bodu https://graph.windows.net Azure AD Graphu-AzureADMS, zatímco rutiny volat koncový bod graph.microsoft.comMicrosoft Graphu . Ověřování se zpracovává bezobslužně, když změníte volání z jednoho koncového bodu na jiný a nebudete znovu vyzváni k zadání přihlašovacích údajů.

Pokud se chcete připojit ke konkrétnímu prostředí Azure Active Directory, použijte parametr AzureEnvironment následujícím způsobem:

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

Tento příklad připojí relaci PowerShellu k německému prostředí Azure AD. Další informace najdete v tématu Connect-AzureAD.

Další kroky