Connect to Microsoft 365 with PowerShell
On 22 października, 2021 by admin- 07/17/2020
- 6 minut na przeczytanie
-
- . J
- D
- m
- d
Ten artykuł dotyczy zarówno Microsoft 365 Enterprise, jak i Office 365 Enterprise.
PowerShell dla Microsoft 365 umożliwia zarządzanie ustawieniami usługi Microsoft 365 z poziomu wiersza poleceń. Aby połączyć się z PowerShell, wystarczy zainstalować wymagane oprogramowanie, a następnie połączyć się ze swoją organizacją Microsoft 365.
Istnieją dwie wersje modułu PowerShell, których można używać do łączenia się z Microsoft 365 i administrowania kontami użytkowników, grupami i licencjami:
- Azure Active Directory PowerShell for Graph, którego cmdlety zawierają w swojej nazwie słowo AzureAD
- Microsoft Azure Active Directory Module for Windows PowerShell, którego cmdlety zawierają w swojej nazwie słowo Msol
Obecnie moduł Azure Active Directory PowerShell for Graph nie zastępuje całkowicie funkcjonalności modułu Microsoft Azure Active Directory Module for Windows PowerShell do administrowania użytkownikami, grupami i licencjami. W niektórych przypadkach konieczne jest użycie obu wersji. Można bezpiecznie zainstalować obie wersje na tym samym komputerze.
Co musisz wiedzieć, zanim zaczniesz?
System operacyjny
Musisz używać 64-bitowej wersji systemu Windows. Wsparcie dla 32-bitowej wersji modułu Microsoft Azure Active Directory Module for Windows PowerShell zakończyło się w 2014 roku.
Możesz używać następujących wersji systemu Windows:
-
Windows 10, Windows 8.1, Windows 8, lub Windows 7 Service Pack 1 (SP1)
-
Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, lub Windows Server 2008 R2 SP1
Uwaga
W przypadku Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012 oraz Windows Server 2008 R2 SP1, należy pobrać i zainstalować Windows Management Framework 5.1.
PowerShell
-
Dla modułu Azure Active Directory PowerShell for Graph należy używać PowerShell w wersji 5.1 lub nowszej.
-
W przypadku modułu Microsoft Azure Active Directory Module for Windows PowerShell należy korzystać z PowerShell w wersji 5.1 lub nowszej, aż do wersji 6 PowerShell. Nie można używać PowerShell w wersji 7.
Uwaga
Te procedury są przeznaczone dla użytkowników, którzy są członkami roli administratora Microsoft 365. Aby uzyskać więcej informacji, zobacz O rolach administratora.
Połącz się z modułem Azure Active Directory PowerShell for Graph
Komendy w module Azure Active Directory PowerShell for Graph mają w nazwie cmdlet słowo AzureAD. Możesz zainstalować moduł Azure Active Directory PowerShell for Graph lub Azure PowerShell.
W przypadku procedur wymagających nowych cmdletów w module Azure Active Directory PowerShell for Graph wykonaj poniższe kroki, aby zainstalować moduł i połączyć się z subskrypcją Microsoft 365.
Uwaga
Informacje na temat obsługi różnych wersji systemu Windows można znaleźć w części Azure Active Directory PowerShell for Graph module .
Krok 1: Zainstaluj wymagane oprogramowanie
Te kroki są wymagane tylko jeden raz na komputerze. Jednak prawdopodobnie trzeba będzie okresowo aktualizować oprogramowanie.
-
Otwórz podwyższone okno Wiersza poleceń programu Windows PowerShell (uruchom program Windows PowerShell jako administrator).
-
Uruchom to polecenie:
Install-Module -Name AzureAD
Jeśli zostanie wyświetlony monit o zainstalowanie modułu z niezaufanego repozytorium, wpisz Y i naciśnij Enter.
Krok 2: Połącz się z usługą Azure AD dla subskrypcji Microsoft 365
Aby połączyć się z usługą Azure Active Directory (Azure AD) dla subskrypcji Microsoft 365 za pomocą nazwy konta i hasła lub uwierzytelniania wieloczynnikowego, uruchom jedno z tych poleceń w wierszu poleceń programu Windows PowerShell. (Nie musi być na podwyższonym poziomie.)
Office 365 cloud | Command |
---|---|
Office 365 Worldwide (+GCC) | Connect-AzureAD |
Office 365 obsługiwany przez 21 Vianet | Connect-AzureAD -AzureEnvironmentName AzureChinaCloud |
Office 365 Germany | Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud |
Office 365 U.S. Government DoD i Office 365 U.S. Government GCC High | Connect-AzureAD -AzureEnvironmentName AzureUSGovernment |
W oknie dialogowym Zaloguj się na swoje konto wpisz nazwę użytkownika i hasło konta Microsoft 365 work lub school, a następnie wybierz OK.
Jeśli korzystasz z uwierzytelniania wieloczynnikowego, postępuj zgodnie z instrukcjami, aby podać dodatkowe informacje uwierzytelniające, takie jak kod weryfikacyjny.
Po połączeniu możesz użyć poleceń cmdlet dla modułu Azure Active Directory PowerShell for Graph.
Połączenie z modułem Microsoft Azure Active Directory Module for Windows PowerShell
Uwaga
Cmdlety w module Microsoft Azure Active Directory Module for Windows PowerShell mają w nazwie Msol.
PowerShell w wersji 7 i nowszych nie obsługuje modułu Microsoft Azure Active Directory Module for Windows PowerShell i cmdletów z Msol w nazwie. W przypadku PowerShell w wersji 7 i nowszych należy użyć modułu Azure Active Directory PowerShell for Graph lub Azure PowerShell.
PowerShell Core nie obsługuje modułu Microsoft Azure Active Directory Module for Windows PowerShell oraz cmdletów z Msol w nazwie. Uruchom te cmdlety z Windows PowerShell.
Krok 1: Zainstaluj wymagane oprogramowanie
Te kroki są wymagane tylko jeden raz na twoim komputerze. Jednak prawdopodobnie będziesz musiał okresowo aktualizować oprogramowanie.
-
Jeśli nie korzystasz z systemu Windows 10, zainstaluj 64-bitową wersję programu Microsoft Online Services Sign-in Assistant: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.
-
Prześledź następujące kroki, aby zainstalować moduł Microsoft Azure Active Directory Module for Windows PowerShell:
- Otwórz podwyższony wiersz polecenia Windows PowerShell (uruchom Windows PowerShell jako administrator).
- Uruchom polecenie Install-Module MSOnline.
- Jeśli zostanie wyświetlony monit o zainstalowanie dostawcy NuGet, wpisz Y i naciśnij Enter.
- Jeśli zostanie wyświetlony monit o zainstalowanie modułu z PSGallery, wpisz Y i naciśnij Enter.
Krok 2: Połącz się z usługą Azure AD dla subskrypcji Microsoft 365
Aby połączyć się z usługą Azure AD dla subskrypcji Microsoft 365 za pomocą nazwy konta i hasła lub uwierzytelniania wieloczynnikowego, uruchom jedno z tych poleceń w wierszu poleceń programu Windows PowerShell. (Nie musi być ono podwyższone.)
Office 365 cloud | Command |
---|---|
Office 365 Worldwide (+GCC) | Connect-MsolService |
Office 365 obsługiwany przez 21 Vianet | Connect-MsolService -AzureEnvironment AzureChinaCloud |
Office 365 Germany | Connect-MsolService -AzureEnvironment AzureGermanyCloud |
Office 365 U.S. Government DoD i Office 365 U.S. Rząd GCC High | Connect-MsolService -AzureEnvironment USGovernment |
W oknie dialogowym Zaloguj się na swoje konto wpisz nazwę użytkownika i hasło konta roboczego lub szkolnego Microsoft 365, a następnie wybierz opcję OK.
Jeśli korzystasz z uwierzytelniania wieloczynnikowego, postępuj zgodnie z instrukcjami, aby podać dodatkowe informacje uwierzytelniające, takie jak kod weryfikacyjny.
Skąd wiesz, że się udało?
Jeśli nie pojawi się komunikat o błędzie, połączenie zostało nawiązane pomyślnie. Dla szybkiego testu uruchom cmdlet Microsoft 365, taki jak Get-MsolUser, i zobacz wyniki.
Jeśli otrzymasz komunikat o błędzie, sprawdź następujące kwestie:
-
Częstym problemem jest nieprawidłowe hasło. Uruchom ponownie krok 2 i zwróć szczególną uwagę na nazwę użytkownika i hasło, które wprowadzasz.
-
Moduł Microsoft Azure Active Directory Module for Windows PowerShell wymaga, aby na komputerze był włączony Microsoft .NET Framework 3.5.x. Prawdopodobnie na komputerze jest zainstalowana nowsza wersja (np. 4 lub 4.5.x). Zgodność wsteczna ze starszymi wersjami .NET Framework może być jednak włączona lub wyłączona. Aby uzyskać więcej informacji, zobacz następujące artykuły:
-
Dla systemu Windows Server 2012 lub Windows Server 2012 R2, zobacz Włącz .NET Framework 3.5 za pomocą kreatora dodawania ról i funkcji.
-
Dla systemu Windows 7 lub Windows Server 2008 R2, zobacz Nie można otworzyć modułu Azure Active Directory dla programu Windows PowerShell.
-
Dla systemów Windows 10, Windows 8.1 i Windows 8, zobacz Zainstaluj .NET Framework 3.5 w systemach Windows 10, Windows 8.1 i Windows 8.
-
-
Twoja wersja modułu Microsoft Azure Active Directory Module for Windows PowerShell może być nieaktualna. Aby sprawdzić, uruchom następujące polecenie w PowerShell dla Microsoft 365 lub Microsoft Azure Active Directory Module for Windows PowerShell:
(Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion
Jeśli zwrócony numer wersji jest niższy niż 1.0.8070.2, odinstaluj Microsoft Azure Active Directory Module for Windows PowerShell i zainstaluj od kroku 1, powyżej.
-
Jeśli pojawi się komunikat o błędzie połączenia, zobacz „Connect-MsolService: Exception of type was thrown” error.
-
Jeśli otrzymasz komunikat o błędzie „Get-Item: Cannot find path”, uruchom to polecenie:
(dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name
Zobacz także
- Zarządzaj usługą Microsoft 365 za pomocą programu PowerShell
- Rozpocznij pracę z programem PowerShell dla usługi Microsoft 365
- Połącz się ze wszystkimi usługami Microsoft 365 w jednym oknie programu Windows PowerShell
.
Dodaj komentarz