Instalowanie programu Azure Active Directory PowerShell dla programu Graph

  • Artykuł

Ważne

Azure AD program PowerShell ma zostać wycofany 30 marca 2024 r. Aby uzyskać więcej informacji na temat planów wycofywania, zobacz aktualizację o wycofaniu. Zachęcamy do kontynuowania migracji do programu Microsoft Graph PowerShell, który jest zalecanym modułem do interakcji z Azure AD. Ponadto program Microsoft Graph PowerShell umożliwia dostęp do wszystkich interfejsów API programu Microsoft Graph i jest dostępny w programie PowerShell 7. Aby uzyskać odpowiedzi na często zadawane pytania dotyczące migracji, zobacz Często zadawane pytania dotyczące migracji.

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 zaleca się używania publicznej wersji zapoznawczej w scenariuszach produkcyjnych.

Pobierz 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łu 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ą programu 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

Nie można jednocześnie zainstalować wersji zapoznawczej i wersji ogólnie dostępnej na tym samym komputerze.

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. Następnie zostanie wyświetlony monit 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