Instalowanie programu Azure Active Directory PowerShell dla programu Graph

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

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

Aby pobrać moduły z Galeria programu PowerShell, użyj następującego polecenia:

Historia wersji programu PowerShell dla programu Graph w usłudze Azure Active Directory

Historia wersji modułu Azure AD i moduł Azure AD w wersji zapoznawczej to tutaj: program PowerShell usługi Azure Active Directory dla programu Graph: historia wersji.

Instalowanie modułu usługi Azure AD

Wymagania wstępne

Moduł Azure AD jest obsługiwany w następujących systemach operacyjnych Windows z domyślną wersją platformy Microsoft .NET Framework i Windows PowerShell:

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

Uwaga

Moduł Azure AD PowerShell nie jest zgodny z programem PowerShell 7. Jest on obsługiwany tylko w programie PowerShell 5.1.

Aby zainstalować wersję ogólnego dostępności modułu, uruchom polecenie:

Install-Module AzureAD

Aby zainstalować publiczną wersję zapoznawcza, uruchom polecenie:

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ł Azure AD jest dystrybuowany przy użyciu Galeria programu PowerShell. Instalowanie elementów z galerii wymaga najnowszej wersji modułu PowerShellGet, który jest dostępny w Windows 10, w Windows Management Framework (WMF) 5.0 lub w instalatorze opartym na msi (dla programu PowerShell 3 i 4).

Najnowsza wersja modułu PowerShellGet umożliwia:

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

Moduł PowerShellGet wymaga również .NET Framework wersji 4.5 lub nowszej. 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, uruchom następujące polecenie:

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:

Install-Module AzureADPreview

To polecenie sprawdza galerię programu PowerShell, aby sprawdzić, czy jest dostępna nowsza wersja. Jeśli tak, nowsze niż zainstalowane 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ą.

Uwaga

Moduły Azure AD i Azure AD Preview składają się z poleceń cmdlet z różnymi konwencjami nazewnictwa, np. -AzureAD i -AzureADMS. Polecenia -AzureAD cmdlet łączą się z punktem końcowym https://graph.windows.net programu Azure AD Graph, podczas gdy -AzureADMS polecenia cmdlet tworzą wywołania punktu końcowego programu graph.microsoft.comMicrosoft Graph. Uwierzytelnianie jest obsługiwane w trybie dyskretnym po zmianie wywołań z jednego punktu końcowego na inny i nie zostanie ponownie wyświetlony monit o podanie poświadczeń.

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.

Następne kroki