Azure Active Directory PowerShell for Graph

  • Článek

Verzi modulu Azure Active Directory PowerShell pro Graph můžete použít k Azure AD úloh 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 MSOL, které jsou součástí modulu MSOnline PowerShellu.

Modul Azure AD PowerShellu pro Graph má dvě verze: verzi Public Preview a verzi pro obecnou dostupnost. Nedoporučujeme používat verzi Public Preview pro produkční scénáře.

Modul Azure AD PowerShell pro Graph Preview si můžete stáhnout z Galerie prostředí PowerShell na stránce AzureADPreview.

Modul obecné dostupnosti Azure AD PowerShellu pro Graph si můžete stáhnout z Galerie prostředí PowerShell na stránce AzureAD.

Instalace modulu Azure AD

Modul Azure AD PowerShell pro Graph se podporuje 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 nebo Windows Server 2008 R2.

Pokud počítač splňuje všechny požadavky pro instalaci, dá se verze General Availability do počítače nainstalovat spuštěním tohoto příkazu:

Install-Module AzureAD

K instalaci verze Public Preview použijte tento příkaz:

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 této galerie vyžaduje nejnovější verzi modulu PowerShellGet, která je dostupná ve Windows 10, ve Windows Management Frameworku (WMF) 5.0 nebo v instalačním programu využívajícím 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

Verzi modulu, kterou máte nainstalovanou ve vašem počítači, můžete ověřit spuštěním tohoto příkazu:

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

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

Tento příkaz zkontroluje Galerii prostředí PowerShell, jestli je dostupná novější verze. Pokud verze v Galerii prostředí PowerShell je novější než verze nainstalovaná v počítači, nainstaluje ji do vašeho počítače.

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ě.

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.

Máte nějaké návrhy?

Pokud máte nějaké návrhy na vylepšení Azure Active Directory PowerShellu, neváhejte nám dát vědět.

Další informace o Windows Powershellu

Windows PowerShell je prostředí příkazového řádku založené na úlohách a skriptovací jazyk určený pro správu systému. Na rozdíl od většiny prostředí, které přijímají a vrací text, je Windows PowerShell postavený na rozhraní .NET Framework a přijímá a vrací objekty rozhraní .NET Framework.

Windows PowerShell zavádí koncepci rutin (anglicky cmdlet). Je to jednoduchý nástroj příkazového řádku s jedinou funkcí, který je do prostředí integrovaný. Rutiny mají následující zásady vytváření názvů: sloveso a podstatné jméno oddělené pomlčkou (-), například Get-Help, Get-Process a Start-Service. Windows PowerShell zahrnuje víc než stovku základních rutin jádra.

Další informace o rutinách nebo jejich syntaxi zobrazíte pomocí příkazu Get-Help <cmdlet name>, kde <cmdlet name> je název rutiny, kterou chcete prozkoumat. K získání podrobnějších informací můžete spustit některý z následujících příkazů:

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

Další informace o Windows PowerShellu najdete v tématu Začínáme s Windows PowerShellem.