Connect to Microsoft 365 with PowerShell
On október 22, 2021 by admin- 07/17/2020
- 6 perc olvasás
-
- J
- D
- m
- d
Ez a cikk a Microsoft 365 Enterprise és az Office 365 Enterprise szolgáltatásokra egyaránt vonatkozik.
A PowerShell for Microsoft 365 lehetővé teszi a Microsoft 365 beállításainak kezelését a parancssorból. A PowerShellhez való csatlakozáshoz csak telepítse a szükséges szoftvert, majd csatlakozzon a Microsoft 365 szervezetéhez.
A PowerShell modulnak két változata létezik, amelyekkel csatlakozhat a Microsoft 365-höz, és kezelheti a felhasználói fiókokat, csoportokat és licenceket:
- Azure Active Directory PowerShell for Graph, amelynek parancssorai nevében szerepel az AzureAD
- Microsoft Azure Active Directory Module for Windows PowerShell, amelynek parancssorai nevében szerepel az Msol
Az Azure Active Directory PowerShell for Graph modul jelenleg nem helyettesíti teljesen a Microsoft Azure Active Directory Module for Windows PowerShell modul felhasználói, csoport- és licenckezelési funkcióit. Bizonyos esetekben mindkét verziót használni kell. Nyugodtan telepítheti mindkét verziót ugyanarra a számítógépre.
Mit kell tudnia, mielőtt elkezdi?
Működő rendszer
A Windows 64 bites verzióját kell használnia. A Microsoft Azure Active Directory Module for Windows PowerShell 32 bites verziójának támogatása 2014-ben megszűnt.
A Windows következő verzióit használhatja:
-
Windows 10, Windows 8.1, Windows 8 vagy Windows 7 Service Pack 1 (SP1)
-
Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012 vagy Windows Server 2008 R2 SP1
Figyelem
A Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012 és Windows Server 2008 R2 SP1 esetén töltse le és telepítse a Windows Management Framework 5.1.
PowerShell
-
Az Azure Active Directory PowerShell for Graph modulhoz a PowerShell 5. verzióját kell használni.1 vagy újabb.
-
A Microsoft Azure Active Directory modul Windows PowerShell modulhoz a PowerShell 5.1 vagy újabb verzióját kell használnia, legfeljebb a PowerShell 6. verziójáig. A PowerShell 7-es verziója nem használható.
Figyelem
Az eljárások olyan felhasználóknak szólnak, akik a Microsoft 365 rendszergazdai szerepkörének tagjai. További információért lásd: Az admin szerepkörökről.
Kapcsolódás az Azure Active Directory PowerShell for Graph modullal
Az Azure Active Directory PowerShell for Graph modulban található parancsok cmdletnevében AzureAD szerepel. Telepítheti az Azure Active Directory PowerShell for Graph modult vagy az Azure PowerShell-t.
Az Azure Active Directory PowerShell for Graph modulban található új parancsikákat igénylő eljárásokhoz kövesse az alábbi lépéseket a modul telepítéséhez és a Microsoft 365 előfizetéshez való csatlakozáshoz.
Figyelem
A Windows különböző verzióinak támogatásával kapcsolatos információkért lásd: Azure Active Directory PowerShell for Graph modul.
1. lépés: A szükséges szoftverek telepítése
Ezek a lépések csak egyszer szükségesek a számítógépen. A szoftvert azonban valószínűleg rendszeresen frissítenie kell.
-
Nyisson meg egy emelt szintű Windows PowerShell parancssor ablakot (futtassa a Windows PowerShellt rendszergazdaként).
-
Futtassa ezt a parancsot:
Install-Module -Name AzureAD
Ha egy nem megbízható tárolóból származó modul telepítését kéri a rendszer, írjon be Y-t, és nyomja le az Entert.
2. lépés: Csatlakozás az Azure AD-hez a Microsoft 365 előfizetéshez
Az Azure Active Directoryhoz (Azure AD) való csatlakozáshoz a Microsoft 365 előfizetéshez fióknévvel és jelszóval vagy többfaktoros hitelesítéssel futtassa az alábbi parancsok egyikét a Windows PowerShell parancssorból. (Nem kell, hogy emelt szintű legyen.)
Office 365 felhő | Parancs | |
---|---|---|
Office 365 Worldwide (+GCC) | Connect-AzureAD |
|
Office 365 által üzemeltetett 21 Vianet | Connect-AzureAD -AzureEnvironmentName AzureChinaCloud |
|
Office 365 Németország | Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud |
|
Office 365 U.S. Government DoD és Office 365 U. S. Government GCC High | Connect-AzureAD -AzureEnvironmentName AzureUSGovernment |
|
A Sign into your account párbeszédpanelen írja be a Microsoft 365 munkahelyi vagy iskolai fiókjának felhasználónevét és jelszavát, majd válassza az OK lehetőséget.
Ha többfaktoros hitelesítést használ, kövesse az utasításokat további hitelesítési információk, például egy ellenőrző kód megadásához.
A csatlakozás után használhatja az Azure Active Directory PowerShell for Graph modulhoz tartozó parancsikonokat.
Kapcsolódás a Microsoft Azure Active Directory modul a Windows PowerShellhez
Figyelem
A Microsoft Azure Active Directory modul a Windows PowerShellhez parancsikonok nevében szerepel az Msol.
A PowerShell 7-es és újabb verziója nem támogatja a Microsoft Azure Active Directory modul a Windows PowerShellhez modult és az Msol nevű parancsikonokat. A PowerShell 7-es és újabb verziója esetén az Azure Active Directory PowerShell for Graph modult vagy az Azure PowerShell.
A PowerShell Core nem támogatja a Microsoft Azure Active Directory Module for Windows PowerShell modult és az Msol nevű cmdleteket. Futtassa ezeket a cmdleteket Windows PowerShellből.
1. lépés: A szükséges szoftverek telepítése
Ezek a lépések csak egyszer szükségesek a számítógépen. A szoftvert azonban valószínűleg rendszeresen frissítenie kell.
-
Ha nem Windows 10 rendszert használ, telepítse a Microsoft Online Services Sign-in Assistant 64 bites verzióját: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.
-
A Microsoft Azure Active Directory Module for Windows PowerShell telepítéséhez kövesse az alábbi lépéseket:
- Nyisson meg egy emelt szintű Windows PowerShell parancssort (futtassa a Windows PowerShellt rendszergazdaként).
- Futtassa az Install-Module MSOnline parancsot.
- Ha a rendszer a NuGet szolgáltató telepítését kéri, írja be az Y billentyűt, és nyomja meg az Entert.
- Ha a rendszer a modul PSGallery-ből történő telepítését kéri, írja be az Y billentyűt, és nyomja meg az Entert.
2. lépés: Csatlakozás az Azure AD-hez a Microsoft 365 előfizetéshez
Az Azure AD-hez való csatlakozáshoz a Microsoft 365 előfizetéshez fióknévvel és jelszóval vagy többfaktoros hitelesítéssel futtassa az alábbi parancsok egyikét a Windows PowerShell parancssorból. (Nem kell, hogy emelt szintű legyen.)
Office 365 felhő | Parancs | |
---|---|---|
Office 365 Worldwide (+GCC) | Connect-MsolService |
|
Office 365 által üzemeltetett 21 Vianet | Connect-MsolService -AzureEnvironment AzureChinaCloud |
|
Office 365 Németország | Connect-MsolService -AzureEnvironment AzureGermanyCloud |
|
Office 365 U.S. Government DoD és Office 365 U.S. Government GCC High | Connect-MsolService -AzureEnvironment USGovernment |
|
A Sign into your account párbeszédpanelen írja be a Microsoft 365 munkahelyi vagy iskolai fiókjának felhasználónevét és jelszavát, majd válassza az OK lehetőséget.
Ha többfaktoros hitelesítést használ, kövesse az utasításokat további hitelesítési információk, például egy ellenőrző kód megadásához.
Honnan tudja, hogy működött?
Ha nem kap hibaüzenetet, akkor sikeresen csatlakozott. Gyors teszteléshez futtasson egy Microsoft 365 cmdletet, például a Get-MsolUser parancsot, és nézze meg az eredményeket.
Ha hibaüzenetet kap, ellenőrizze a következő problémákat:
-
Egy gyakori probléma a helytelen jelszó. Futtassa újra a 2. lépést, és fordítson nagy figyelmet a beírt felhasználónévre és jelszóra.
-
A Microsoft Azure Active Directory modul a Windows PowerShellhez megköveteli, hogy a Microsoft .NET Framework 3.5.x legyen engedélyezve a számítógépen. Valószínű, hogy a számítógépén egy újabb verzió van telepítve (például 4 vagy 4.5.x). A .NET Framework régebbi verzióival való visszafelé kompatibilitás azonban engedélyezhető vagy letiltható. További információért lásd a következő cikkeket:
-
Windows Server 2012 vagy Windows Server 2012 R2 esetén lásd: A .NET Framework 3.5 engedélyezése a Szerepkörök és funkciók hozzáadása varázsló használatával.
-
Windows 7 vagy Windows Server 2008 R2 esetén lásd: Nem tudja megnyitni az Azure Active Directory modulját a Windows PowerShell számára.
-
Windows 10, Windows 8.1 és Windows 8 esetén lásd: A .NET Framework 3.5 telepítése Windows 10, Windows 8.1 és Windows 8 rendszerre.
-
-
A Microsoft Azure Active Directory Module for Windows PowerShell verziója elavult lehet. Az ellenőrzéshez futtassa a következő parancsot a PowerShell for Microsoft 365 vagy a Microsoft Azure Active Directory Module for Windows PowerShell programban:
(Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion
Ha a visszakapott verziószám kisebb, mint az 1.0.8070.2, távolítsa el a Microsoft Azure Active Directory Module for Windows PowerShell programot, és telepítse a fenti 1. lépésből.
-
Ha kapcsolódási hibaüzenetet kap, lásd a “Connect-MsolService: Exception of type was thrown” hibaüzenetet kapott.
-
Ha a “Get-Item: Cannot find path” hibaüzenet, futtassa ezt a parancsot:
(dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name
Lásd még
- Manage Microsoft 365 with PowerShell
- Get started with PowerShell for Microsoft 365
- Connect to all Microsoft 365 services in a single Windows PowerShell window
.
Vélemény, hozzászólás?