Instalace Azure Active Directory PowerShellu pro Graph

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í. Tady 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 obecnou dostupnost (GA). Verzi Public Preview se nedoporučuje používat pro produkční scénáře.

Pokud chcete stáhnout moduly z Galerie prostředí PowerShell použijte následující:

Historie verzí verze Azure Active Directory PowerShellu pro Graph

Historie verzí modulu Azure AD a modul Azure AD Preview najdete tady: Azure Active Directory PowerShell pro graf: 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 Azure AD PowerShellu není kompatibilní s PowerShellem 7. Podporuje se jenom v PowerShellu 5.1.

Pokud chcete nainstalovat verzi modulu Obecná dostupnost, spusťte:

Install-Module AzureAD

Pokud chcete nainstalovat verzi Public Preview, spusťte:

Install-module AzureADPreview

Nezapomeňte, že nejde současně nainstalovat verzi Preview a verzi GA na stejný počítač.

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 vyšší. 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...

K aktualizaci verze modulu Azure AD PowerShell ve vašem počítači znovu spusťte rutinu Install-Module:

Install-Module AzureADPreview

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

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. Zobrazí se 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 obsahují rutiny 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