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.
Informacje o galerii programu PowerShell
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:
- Przeszukiwanie elementów galerii przy użyciu poleceń Find-Module i Find-Script
- Zapisywanie elementów w systemie z galerii przy użyciu polecenia Save-Module i Save-Script
- Instalowanie elementów z galerii przy użyciu poleceń Install-Module i Install-Script
- Przekazywanie elementów do galerii przy użyciu poleceń Publish-Module i Publish-Script
- Dodawanie własnego repozytorium niestandardowego przy użyciu polecenia Register-PSRepository
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
- Zobacz Nowe funkcje i ulepszenia.