Azure Active Directory PowerShell dla programu Graph

  • Artykuł

Możesz użyć wersji modułu Programu PowerShell usługi Azure Active Directory dla programu Graph w celu Azure AD zadań administracyjnych, takich jak zarządzanie użytkownikami, zarządzanie domeną i konfigurowanie logowania jednokrotnego. Wymienione tutaj polecenia cmdlet różnią się od poleceń cmdlet MSOL, które są częścią modułu MSOnline programu PowerShell.

Moduł Azure AD Programu PowerShell dla programu Graph ma dwie wersje: publiczną wersję zapoznawcza i wersję ogólnie dostępnej. Nie zaleca się używania wersji publicznej w wersji zapoznawczej dla scenariuszy produkcyjnych.

Moduł Azure AD PowerShell for Graph w wersji zapoznawczej można pobrać z Galeria programu PowerShell na stronie AzureADPreview.

Moduł Azure AD PowerShell for Graph General Availability (Ogólna dostępność programu PowerShell dla programu Graph) można pobrać z Galeria programu PowerShell na stronie AzureAD.

Instalowanie modułu usługi Azure AD

Moduł Azure AD PowerShell for Graph jest obsługiwany w następujących systemach operacyjnych Windows z domyślną wersją microsoft .NET Framework i Windows PowerShell: Windows 8.1, Windows 8, Windows 7, Windows Server 2012 R2, Windows Server 2012 lub Windows Server 2008 R2.

Jeśli komputer spełnia wszystkie wymagania wstępne dotyczące instalacji, aby zainstalować na komputerze ogólnodostępną wersję modułu, można uruchomić polecenie

Install-Module AzureAD

Aby zainstalować publiczną wersję zapoznawczą, użyj polecenia

Install-module AzureADPreview

Należy pamiętać, że na tym samym komputerze w tym samym czasie nie można zainstalować wersji zapoznawczej i wersji ogólnodostępnej.

Moduł usługi Azure AD jest rozpowszechniany za pośrednictwem galerii programu PowerShell. Instalowanie elementów z galerii wymaga najnowszej wersji modułu PowerShellGet, która jest dostępna w systemie Windows 10, w programie Windows Management Framework (WMF) w wersji 5.0 lub w instalatorze opartym na MSI (dla programu PowerShell 3 i 4).

Za pomocą najnowszego modułu PowerShellGet można wykonywać następujące czynności:

Zapoznaj się ze stroną Wprowadzenie, aby uzyskać więcej informacji na temat korzystania z poleceń modułu PowerShellGet w galerii. Możesz również uruchomić polecenie Update-Help -Module PowerShellGet, aby zainstalować lokalną pomoc dotyczącą tych poleceń.

Obsługiwane systemy operacyjne

Moduł PowerShellGet wymaga programu PowerShell 3.0 lub nowszego. W związku z tym moduł PowerShellGet wymaga jednego z następujących systemów operacyjnych:

  • Windows 10
  • Windows 8.1 Pro
  • Windows 8.1 Enterprise
  • Windows 7 z dodatkiem SP1
  • Windows Server 2016 TP5
  • Windows Server 2012 z dodatkiem R2
  • Windows Server 2008 R2 SP1

Program PowerShellGet wymaga również .NET Framework 4.5 lub nowszej wersji. Program .NET Framework 4.5 lub nowszy można zainstalować stąd.

Aktualizowanie modułu usługi Azure AD

Aby sprawdzić wersję modułu zainstalowanego na komputerze, możesz uruchomić to polecenie:

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

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

Aby zaktualizować wersję modułu Azure AD PowerShell na komputerze, uruchom ponownie polecenie cmdlet Install-Module:

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

To polecenie sprawdza, czy w galerii programu PowerShell jest dostępna nowsza wersja, i instaluje ją na komputerze, jeśli wersja w galerii programu PowerShell jest nowsza niż zainstalowana na komputerze.

Łączenie z usługą Azure AD

Przed uruchomieniem dowolnych poleceń cmdlet omówionych w tym artykule musisz najpierw połączyć się z usługą online. W tym celu uruchom polecenie cmdlet Connect-AzureAD w wierszu polecenia programu Windows PowerShell. Spowoduje to wyświetlenie monitu o podanie poświadczeń. Jeśli chcesz, możesz podać poświadczenia z wyprzedzeniem, na przykład:

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

Pierwsze polecenie powoduje wyświetlenie monitu o poświadczenia i przechowuje je w postaci elementu $AzureAdCred. Następne polecenie używa tych poświadczeń jako elementu $azureadcred w celu nawiązania połączenia z usługą.

Aby połączyć się z określonym środowiskiem usługi Azure Active Directory, użyj parametru AzureEnvironment w następujący sposób:

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

W tym przykładzie sesja programu PowerShell jest łączona z niemiecką wersją środowiska usługi AzureAD. Zobacz Connect-AzureAD, aby uzyskać więcej informacji.

Masz jakieś sugestie?

Jeśli masz sugestie dotyczące ulepszania programu Azure Active Directory PowerShell, nie wahaj się poinformować nas o tym!

Więcej informacji o programie Windows PowerShell

Windows PowerShell to język skryptów i powłoka wiersza polecenia oparta na zadaniach i zaprojektowana pod kątem administrowania systemem. W przeciwieństwie do większości powłok, które akceptują i zwracają tekst, program Windows PowerShell został utworzony na bazie programu .NET Framework i akceptuje i zwraca obiekty programu .NET Framework.

W programie Windows PowerShell wprowadzono pojęcie polecenia cmdlet (wymawiane jako „command-let”), czyli prostego, wbudowanego w powłoce narzędzia wiersza polecenia, które oferuje pojedynczą funkcję. Polecenia cmdlet mają następującą konwencję nazewnictwa: czasownik i rzeczownik oddzielone kreską (-), np. Get-Help, Get-Process i Start-Service. Program Windows PowerShell oferuje ponad 100 podstawowych poleceń cmdlet.

Aby uzyskać więcej informacji na temat dowolnych poleceń cmdlet lub ich składni, użyj polecenia Get-Help <cmdlet name>, gdzie <cmdlet name> to nazwa polecenia cmdlet, które chcesz poznać. Aby uzyskać bardziej szczegółowe informacje, możesz uruchomić dowolne z następujących poleceń:

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

Aby uzyskać więcej informacji na temat programu Windows PowerShell, zobacz Wprowadzenie do programu Windows PowerShell.