Csatlakozás a Microsoft 365-höz a Microsoft Graph PowerShell használatával

  • Cikk

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.

  1. 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.

  2. 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 CurrentUser

  3. Futtassa 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.

Lásd még