Csatlakozás a Microsoft 365-höz a Microsoft Graph PowerShell használatával
Ez a cikk Microsoft 365 Nagyvállalati verzió és Office 365 Nagyvállalati verzió egyaránt vonatkozik.
A Microsoft Graph PowerShell lehetővé teszi a Microsoft 365-beállítások parancssorból történő kezelését. Ez a cikk bemutatja, hogyan telepítheti a szükséges szoftvereket, majd hogyan csatlakozhat Microsoft 365-szervezetéhez a Microsoft Graph PowerShell SDK használatával.
Az Azure Active Directory PowerShell for Graph modul jelenleg nem helyettesíti teljesen a Microsoft Azure Active Directory modul funkcióit az alkalmazásproxy-felügyelet, a felhasználó és a kapcsolatkezelés Windows PowerShell esetében. Bizonyos esetekben mindkét verziót használnia kell. Mindkét verziót biztonságosan telepítheti ugyanarra a számítógépre.
Mit kell tudnia a kezdés előtt?
Megjegyzés:
Az Azure Active Directory (AzureAD) PowerShell-modul elavult, és a Microsoft Graph PowerShell SDK váltja fel. A Microsoft Graph PowerShell SDK-val elérheti az összes Microsoft Graph API-t. További információ: Ismerkedés a Microsoft Graph PowerShell SDK-val.
A Microsoft Graph PowerShell telepítésével és a Microsoft Graph PowerShellre való frissítéssel kapcsolatos információkért lásd: A Microsoft Graph PowerShell telepítése és frissítése Azure AD PowerShellről a Microsoft Graph PowerShellre.
Előfeltételek
A PowerShell 7-es vagy újabb verziója a Microsoft Graph PowerShell SDK-val való használathoz ajánlott powershell-verzió minden platformon. Az SDK PowerShell 7 vagy újabb verziójával való használatához nincs más előfeltétel.
A Microsoft Graph PowerShell SDK Windows PowerShell való használatához a következő előfeltételek szükségesek.
- Frissítés a PowerShell 5.1-re vagy újabb verziójára
- A .NET-keretrendszer 4.7.2-s vagy újabb verziójának telepítése
- A PowerShellGet frissítése a legújabb verzióra Install-Module PowerShellGet használatával
A PowerShell-szkript végrehajtási szabályzatát távoli aláírt vagy kevésbé korlátozó értékre kell állítani. Az aktuális végrehajtási szabályzat meghatározásához használja a Get-ExecutionPolicy. További információ: about_Execution_Policies. A végrehajtási szabályzat beállításához futtassa a következőt:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Operációs rendszer
A Windows 64 bites verzióját kell használnia. A Windows következő verzióit használhatja:
Windows 11, 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
Megjegyzés:
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 az Windows Management Framework 5.1-et.
A Microsoft Graph PowerShell használatához legalább a PowerShell 5.1-es verzióját kell használnia.
Megjegyzés:
Ezek az eljárások a Microsoft 365 rendszergazdai szerepkörrel rendelkező felhasználók számára készültek. További információt a Tudnivalók az adminisztrátori szerepkörökről című témakörben talál.
Csatlakozás a Microsoft Graph PowerShell-lel
Ebben a szakaszban megtudhatja, hogyan csatlakozhat Microsoft 365-szervezetéhez a Microsoft Graph PowerShell SDK használatával. További útmutatásért lásd : A Microsoft Graph PowerShell SDK telepítése .
1. lépés: A szükséges szoftver telepítése
A Microsoft Graph PowerShell SDK a PowerShell-galéria van közzétéve.
Ezek a lépések csak egyszer szükségesek a számítógépen. Azonban valószínűleg rendszeresen frissítenie kell a szoftvert.
A Microsoft Graph PowerShell SDK és a béta modul telepítése
A Microsoft Graph PowerShell SDK két modulban érhető el, a Microsoft.Graph és a Microsoft.Graph.Beta modulban, amelyeket külön fog telepíteni. Ezek a modulok a Microsoft Graph 1.0-s és Microsoft Graph bétaverziós végpontjait hívják meg. A két modult ugyanarra a PowerShell-verzióra telepítheti.
Nyisson meg egy Windows PowerShell parancssori ablakot. A bejelentkezett fiók engedélyétől függően előfordulhat, hogy rendszergazdai módban kell megnyitnia a PowerShell-ablakot.
Az SDK v1 moduljának PowerShell Core-ban vagy Windows PowerShell való telepítéséhez futtassa a következő parancsot:
Install-Module Microsoft.Graph -Scope CurrentUserFuttassa ezt a parancsot a bétamodul telepítéséhez:
Install-Module Microsoft.Graph.Beta
A telepítés befejezése után a következő paranccsal ellenőrizheti a telepített verziót:
Get-InstalledModule Microsoft.Graph
2. lépés: Csatlakozás a Microsoft 365-előfizetéshez
A PowerShell SDK kétféle hitelesítést támogat: delegált hozzáférést és csak alkalmazáshoz való hozzáférést. Ebben az útmutatóban delegált hozzáféréssel jelentkezik be felhasználóként, hozzájárulást ad az SDK-nak, hogy az Ön nevében járjon el, és meghívja a Microsoft Graphot.
A csak alkalmazásalapú hozzáférés felügyelet nélküli forgatókönyvekhez való használatáról további információt a Csak alkalmazásalapú hitelesítés használata a Microsoft Graph PowerShell SDK-val című témakörben talál.
A szükséges engedélyhatókörök meghatározása
A Microsoft Graph minden API-ját egy vagy több engedélyhatókör védi. A bejelentkező felhasználónak jóvá kell hagynia a használni kívánt API-khoz szükséges hatókörök egyikét. Ebben a példában a következő API-kat fogjuk használni.
- Listázhatja a felhasználókat a bejelentkezett felhasználó felhasználói azonosítójának megkereséséhez.
- List joinedTeams to get the Teams the user is member of.
- Csatornák listázása a csoportok csatornáinak lekéréséhez.
- Üzenet küldése egy csapat csatornájára való üzenetküldéshez.
A User.Read.All engedélyhatókör engedélyezi az első két hívást, a Group.ReadWrite.All hatókör pedig a többit. Ezekhez az engedélyekhez rendszergazdai fiók szükséges.
A szükséges engedélyhatókörök meghatározásával kapcsolatos további információkért lásd: A Find-MgGraphCommand használata.
A Microsoft 365-szervezethez való csatlakozáshoz futtassa a következő parancsot:
Connect-MgGraph -Scopes "User.Read.All","Group.ReadWrite.All"
A parancssor arra kéri, hogy nyissa meg a weblapot, és jelentkezzen be a hitelesítő adataival. Miután ezt megtette, a parancs a sikerességet jelzi a Welcome To Microsoft Graph! (Üdvözöljük a Microsoft Graphban! üzenettel). Munkamenetenként csak egyszer kell bejelentkeznie.
Tipp
Az engedélyek hozzáadásához ismételje meg a Connect-MgGraph parancsot az új engedélyhatókörökkel.