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č.
O Galerii prostředí PowerShell
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:
- Prohledat položky v galerii pomocí příkazů Find-Module a Find-Script
- Uložení položek do systému z galerie pomocí modulu Save-Module a Save-Script
- Nainstalovat položky z galerie pomocí příkazu Install-Module a Install-Script
- Nahrát položky do galerie pomocí příkazu Publish-Module a Publish-Script
- Přidat vlastní úložiště pomocí příkazu Register-PSRepository
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.com
Microsoft 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
- Podívejte se na nové funkce a vylepšení.