Azure Active Directory (MSOnline)

Ważne

moduły Azure AD i MSOnline programu PowerShell są przestarzałe od 30 marca 2024 r. Aby dowiedzieć się więcej, przeczytaj aktualizację o wycofaniu. Po tej dacie obsługa tych modułów jest ograniczona do pomocy w zakresie migracji do zestawu MICROSOFT Graph PowerShell SDK i poprawek zabezpieczeń. Przestarzałe moduły będą nadal działać do 30 marca 2025 r.

Zalecamy migrację do programu Microsoft Graph PowerShell w celu interakcji z Tożsamość Microsoft Entra (wcześniej Azure AD). Aby uzyskać odpowiedzi na typowe pytania dotyczące migracji, zapoznaj się z często zadawanymi pytaniami dotyczącymi migracji. Uwaga: Wersje 1.0.x usługi MSOnline mogą wystąpić zakłócenia po 30 czerwca 2024 r.

Polecenia cmdlet MSOnline służą do Azure AD zadań administracyjnych, takich jak zarządzanie użytkownikami, zarządzanie domenami i konfigurowanie logowania jednokrotnego. Ten temat zawiera informacje dotyczące sposobu instalowania tych poleceń cmdlet do użycia z katalogiem.

Instalowanie usługi MSOnline

Moduł MSOnline 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.

Ten moduł można zainstalować z poziomu Galeria programu PowerShell.

Łą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-MsolService 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:

$Msolcred = Get-credential
Connect-MsolService -Credential $MsolCred

Pierwsze polecenie powoduje wyświetlenie monitu o poświadczenia i przechowuje je w postaci elementu $Msolcred. Następne polecenie używa tych poświadczeń jako elementu $Msolcred 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-MsolService -AzureEnvironment "AzureGermanyCloud"

W tym przykładzie sesja programu PowerShell jest łączona z niemiecką wersją środowiska usługi AzureAD.

Zobacz Connect-MsolService, aby uzyskać więcej informacji.

Aby uzyskać więcej informacji o poleceniach cmdlet, możesz wykonać następujące czynności:

• Aby utworzyć folder na potrzeby pomocy, utwórz listę poleceń cmdlet, a następnie otwórz plik w programie Notatnik. W wierszu polecenia programu Windows PowerShell można uruchomić następujące polecenia:

New-Item c:\MsolHelp -Type directory
Get-command | Where-Object {$_.name -like "*msol*"} | Format-List | Out-File c:\MsolHelp\msolcmdlets.txt
Notepad c:\MsolHelp\msolcmdlets.txt

• Aby zapoznać się z przykładami polecenia cmdlet, uruchom następujące polecenie w wierszu polecenia programu Windows PowerShell: Get-Help <cmdlet-name> -Examples

• Aby wyświetlić nazwę, streszczenie, opis, opisy parametrów i przykłady związane z poleceniem cmdlet, uruchom następujące polecenie w wierszu polecenia programu Windows PowerShell: Get-Help <cmdlet-name> -Detailed

• Aby wyświetlić nazwę, streszczenie, opis, szczegóły parametrów i przykłady związane z poleceniem cmdlet, uruchom następujące polecenie w wierszu polecenia programu Windows PowerShell: Get-Help <cmdlet-name> -Full

Uwaga

Program MSOnline PowerShell może być używany tylko przez użytkowników będących członkami katalogu. Użytkownicy-goście nie mogą używać programu MSOnline PowerShell.

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 programu Windows PowerShell, zobacz Wprowadzenie do programu Windows PowerShell.