Telepítse a Microsoft Graph PowerShell modult
A Microsoft Graph PowerShell lecseréli az Azure AD PowerShell és MSOnline modulokat, és az Azure AD-vel való interakcióhoz ajánlott. A Microsoft Graph PowerShell-modult kell használnia az Azure AD-hez való csatlakozáskor. Ebből a cikkből megtudhatja, hogyan telepítheti a Microsoft Graph PowerShell modult.
Microsoft Graph PowerShell modul
A Microsoft Graph PowerShell SDK egy sor modulból áll, amelyek lehetővé teszik a Microsoft Graph API-val való interakciót PowerShell-parancsok használatával. A modulok olyan parancsokból állnak, amelyek az API burkolóiként működnek, lehetővé téve az API összes szolgáltatásának és funkciójának elérését a PowerShell-en keresztül.
A Microsoft Graph PowerShell modulok a következők:
Microsoft Graph
Microsoft Graph béta
A Microsoft Graph PowerShell SDK a következő előnyöket nyújtja:
Hozzáférés az összes Microsoft Graph API-hoz: A Microsoft Graph PowerShell a Microsoft Graph API-n alapul. Az Azure AD mellett a Microsoft Graph API más Microsoft-szolgáltatásokból, például a SharePointból, az Exchange-ből és az Outlookból származó API-kat is tartalmaz, amelyek mindegyike egyetlen végponton keresztül érhető el, egyetlen hozzáférési jogkivonattal.
A PowerShell 7 támogatása: A Microsoft Graph PowerShell a PowerShell 7 és újabb verzióival működik. A Windows PowerShell 5.1-el is kompatibilis.
Platformok közötti támogatás: A Microsoft Graph PowerShell minden platformon működik, beleértve a Windowst, a macOS-t és a Linuxot is.
Támogatja a modern hitelesítést: A Microsoft Graph PowerShell támogatja a Microsoft Authentication Library-t (MSAL), amely nagyobb biztonságot nyújt. Használhat például jelszó nélküli bejelentkezési élményt.
Támogatja a külső identitásokat: Más Azure AD-bérlők felhasználói hitelesíthetik a bérlő szolgáltatásait a Microsoft Graph PowerShell segítségével.
A legkevesebb jogosultságot használja: A Microsoft Graph PowerShell-engedélyek nincsenek előzetesen engedélyezve, és a felhasználóknak egyszeri kérelmet kell végrehajtaniuk az alkalmazásengedélyekre, igényeiktől függően.
Speciális lekérdezések: A Microsoft Graph PowerShell az esetleges konzisztencia révén támogatja a gazdag, haladó lekérdezéseket. Például a speciális lekérdezések segítségével szinte azonnali számot kaphat az összes felhasználóról.
Nyílt forráskód: A kiemelt csapatok és a közösség nagyszerű PowerShell-élményeket hozhat létre, és megoszthatja azokat mindenkivel.
Rendszeres frissítéseket kap: A Microsoft Graph PowerShell-parancsok rendszeresen frissülnek, hogy támogassák a legújabb Graph API-frissítéseket.
Telepítse a Microsoft Graph PowerShell modult
Mielőtt telepíthetnénk a Microsoft Graph PowerShell modult, be kell állítani a rendszert.
A Microsoft Graph PowerShell modul előfeltételei
A Microsoft Graph PowerShell SDK Windows PowerShell rendszerrel való használatához a következő előfeltételek szükségesek:
Frissítsen PowerShell 5.1 vagy újabb verzióra
Telepítse a .NET-keretrendszer 4.7.2-es vagy újabb verzióját
Állítsa be a Windows PowerShell végrehajtási házirendjét
Alapértelmezés szerint nem tudunk szkripteket telepíteni. Ahhoz, hogy megkövetelje, hogy az internetről letöltött összes PowerShell-szkriptet megbízható kiadó írja alá, futtassa a PowerShellt rendszergazdaként, és futtassa a parancsmagot. Nyomja meg az Y, majd az Enter billentyűt.
PS C:\> Set-ExecutionPolicy RemoteSigned
Execution Policy Change
The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose
you to the security risks described in the about_Execution_Policies help topic at
http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): YFontos: Zárja be, majd nyissa meg újra a megemelt Windows PowerShell-ablakot a módosítások érvénybe léptetéséhez.
Telepítse a PowerShellGet modult
Futtassa a PowerShellt rendszergazdaként. Futtassa az Install-Module PowershellGet -Force parancsot. Amikor a rendszer a NuGet szolgáltató telepítését kéri, nyomja meg az Y billentyűt, és kövesse az Enter billentyűt.
PS C:\> Install-Module PowershellGet -Force
NuGet provider is required to continue
PowerShellGet requires NuGet provider version '2.8.5.201' or newer to interact with NuGet-based repositories. The NuGet provider must be available in 'C:\Program Files\PackageManagement\ProviderAssemblies' or
'C:\Users\administrator.EXOIP\AppData\Local\PackageManagement\ProviderAssemblies'. You can also install the NuGet provider by running 'Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force'. Do you want PowerShellGet to install
and import the NuGet provider now?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): YHa olyan hibaüzenetet kap, hogy nem tudja telepíteni, olvassa el a NuGet szolgáltató nem telepíthető a PowerShellhez című cikket.
Telepítse a Microsoft Graph modult
Telepítse a Microsoft Graph modult. Nyomja meg az Y és az Enter billentyűt.
PS C:\> Install-Module Microsoft.Graph -ForceA Microsoft Graph PowerShell modul letöltése és telepítése eltarthat egy ideig. Szóval adj neki pár percet.
Megjegyzés: Javasoljuk, hogy a következő lépésben telepítse a Microsoft Graph Beta modult is. Ennek az az oka, hogy néhány parancsmag még nem érhető el a v2.x final verzióban, és nem fog működni.
Telepítse a Microsoft Graph Beta modult
Telepítse a Microsoft Graph Beta modult. Nyomja meg az Y és az Enter billentyűt.
Futtassa az Install-Module parancsot az -AllowClobber és a -Force paraméterekkel, hogy elkerülje az ütközéseket a többi modulverzióról való frissítéskor. Ez akkor fordulhat elő, ha v1.x-ről v2.x-re frissít.
PS C:\> Install-Module Microsoft.Graph.Beta -AllowClobber -ForceA Microsoft Graph PowerShell modul letöltése és telepítése eltarthat egy ideig. Szóval adj neki pár percet.
Csatlakozzon a Microsoft Graph PowerShellhez
Csatlakozzon a Microsoft Graph PowerShellhez a modul használatával MFA-val vagy anélkül.
Megjegyzés: Javasoljuk, hogy engedélyezze az MFA-t (többtényezős hitelesítést) a fiókokban.
Csatlakozzon rendszergazdai fiókjához a Microsoft Graphhoz, hogy hozzáférhessen az Azure Active Directory (Azure AD) erőforrásokhoz. Futtassa a Connect-MgGraph parancsmagot.
PS C:\> Connect-MgGraph -Scopes 'User.Read.All'A megnyíló bejelentkezési ablakban adja meg jelszavát, majd kattintson a Bejelentkezés gombra.
Ha az MFA engedélyezve van, a rendszer a fiókjához beállított ellenőrző válaszopció alapján ellenőrző kódot generál és kézbesít. Például egy szöveges üzenet vagy az Azure Authenticator alkalmazás a mobiltelefonján.
Jelölje be a Hozzájárulás a szervezete nevében jelölőnégyzetet. Kattintson az Elfogadás lehetőségre.
Miután az ellenőrzés sikeres, visszatér a PowerShell ablakba.
Bővebben: Hogyan csatlakozhat a Microsoft Graph PowerShellhez különböző módszerekkel »
A Microsoft Graph aktuális munkamenet részleteinek megtekintése
Töltse le a Get-MgInfo.ps1 PowerShell-szkriptet, és mentse el a C:\scripts mappába.
Győződjön meg arról, hogy a fájl blokkolása fel van oldva, hogy elkerülje a hibákat a szkript futtatásakor. További információ a cikkben: Nem digitálisan aláírt hiba a PowerShell-szkript futtatásakor.
Egy másik lehetőség az alábbi kód másolása és beillesztése a Jegyzettömbbe. Adja meg a Get-MgInfo.ps1 nevet, és helyezze a C:\scripts mappába.
Connect-MgGraph
$Details = Get-MgContext
$Scopes = $Details | Select-Object -ExpandProperty Scopes
$Scopes = $Scopes -join ","
$OrgName = (Get-MgOrganization).DisplayName
"Microsoft Graph current session details:"
"---------------------------------------"
"Tenant Id = $($Details.TenantId)"
"Client Id = $($Details.ClientId)"
"Org name = $OrgName"
"App Name = $($Details.AppName)"
"Account = $($Details.Account)"
"Scopes = $Scopes"Nézzük meg az aktuális ülésünk részleteit. Állítsa be a C:\scripts mappa elérési útját, és futtassa a Get-MgInfo.ps1 PowerShell-szkriptet.
PS C:\> cd C:\scripts\
PS C:\scripts> .\Get-MgInfo.ps1
Microsoft Graph current session details:
---------------------------------------
Tenant Id = 1d845768-c027-4321-abe5-02f619863465
Client Id = 16d83eec-204b-4c2f-b7e8-234a70dab27e
Org name = exoip365
App Name = Microsoft Graph Command Line Tools
Account = admin@exoip.com
Scopes = openid,profile,User.Read,email,User.Read.AllHa szeretné ellenőrizni, hogy csatlakozott-e a Felhasználók olvassa el az összes engedélyt, kiváló módja annak, ha futtatja a Get-MgUser parancsmagot, és lekéri az összes felhasználó listáját.
PS C:\> Get-MgUser -All
Id DisplayName Mail UserPrincipalName UserType
-- ----------- ---- ----------------- --------
27e679fe-d17e-4786-adc1-1234bc87a847 Aaik Makisako aaik.makisako@exoip.com aaik.makisako@exoip.com
35498693-bf7a-4f84-bc66-3219a42effef Aalap Bilimoria aalap.bilimoria@exoip.com aalap.bilimoria@exoip.com
3d6152e6-dc9b-4239-9ebd-153008cd4927 Aalyah Marinelarena aalyah.marinelarena@exoip.com aalyah.marinelarena@exoip.com
8ecd0481-2e15-4e91-9755-c88d791c2945 Aanisah Serraino aanisah.serraino@exoip.com aanisah.serraino@exoip.com
3fad5d32-fcdd-455e-b576-083da0634967 Aarshee Hego aarshee.hego@exoip.com aarshee.hego@exoip.com
92918266-5da1-4da5-8cd5-78befeb0d37f Aarun Vesc aarun.vesc@exoip.com aarun.vesc@exoip.com
ae442be1-f7fe-499b-9312-e96ca547ded7 Aarzu Venaski aarzu.venaski@exoip.com aarzu.venaski@exoip.comHa a Microsoft Graph Beta verzióját szeretné használni, a parancsmag a Get-MgBetaUser.
PS C:\> Get-MgBetaUser -AllA Microsoft Graph leválasztása
Ha végzett, válassza le a távoli PowerShell-munkamenetet. Ha bezárja a Microsoft Graph PowerShell-modul ablakát a munkamenet leválasztása nélkül, akkor felhasználhatja az összes rendelkezésére álló távoli PowerShell-munkamenetet, és meg kell várnia, amíg a munkamenetek lejárnak.
PS C:\> Disconnect-MgGraph
ClientId : 16d83eec-204b-4c2f-b7e8-234a70dab27e
TenantId : 1d845768-c027-4321-abe5-02f619863465
CertificateThumbprint :
Scopes : {openid, profile, User.Read, email...}
AuthType : Delegated
AuthProviderType : InteractiveBrowser
CertificateName :
Account : admin@exoip.com
AppName : Microsoft Graph Command Line Tools
ContextScope : CurrentUser
Certificate :
PSHostVersion : 5.1.17763.3770Tegyük fel, hogy újrafuttatja a Disconnect-MgGraph parancsmagot, és az alábbi kimenetet kapja, mert már ki van jelentkezve.
PS C:\> Disconnect-MgGraph
Disconnect-MgGraph : No application to sign out from.
At line:1 char:1
+ Disconnect-MgGraph
+ ~~~~~~~~~~~~~~~~
+ CategoryInfo : CloseError: (:) [Disconnect-MgGraph], ArgumentException
+ FullyQualifiedErrorId : Microsoft.Graph.PowerShell.Authentication.Cmdlets.DisconnectMgGraphEllenőrizze a Microsoft Graph PowerShell modul verzióját
Ellenőrizze, hogy a Microsoft Graph modul telepítve van-e, és hogy melyik verzió fut.
PS C:\> Get-InstalledModule Microsoft.Graph | ft -AutoSize
Version Name Repository Description
------- ---- ---------- -----------
2.0.0 Microsoft.Graph PSGallery Microsoft Graph PowerShell moduleEllenőrizze, hogy a Microsoft Graph Beta modul telepítve van-e, és hogy melyik verzió fut.
PS C:\> Get-InstalledModule Microsoft.Graph.Beta | ft -AutoSize
Version Name Repository Description
------- ---- ---------- -----------
2.0.0 Microsoft.Graph.Beta PSGallery Microsoft Graph PowerShell moduleFrissítse a Microsoft Graph Powershell modult
A Microsoft frissítéseket biztosít a Microsoft Graph PowerShell modulhoz, ezért érdemes azt naprakészen tartani.
Megjegyzés: Ha a frissítés nem működik, távolítsa el a Microsoft Graph modult, és lépjen ki az összes PowerShell-munkamenetből. Ezután indítsa el a PowerShellt, és telepítse a Microsoft Graph-ot.
Frissítse a Microsoft Graph PowerShell SDK modult.
PS C:\> Update-Module Microsoft.GraphFrissítse a Microsoft Graph Beta PowerShell SDK modult.
PS C:\> Update-Module Microsoft.Graph.BetaTávolítsa el a Microsoft Graph PowerShell modult
Az összes Microsoft Graph PowerShell modul eltávolításához, beleértve a béta verziót is, futtassa az alábbi parancsokat lépésről lépésre.
Megjegyzés: A Microsoft Graph teljes eltávolításához a rendszerből mind a 4 parancsot le kell futtatnia.
Megjegyzés: Az eltávolítás akár 15 percig is eltarthat, mire befejeződik. Hagyja futni, és ne zárja be a PowerShell-munkamenetet.
Uninstall-Module Microsoft.Graph -AllowPrerelease -AllVersions
Uninstall-Module Microsoft.Graph.Beta -AllowPrerelease -AllVersions # Assuming you have beta modules installed.
Get-InstalledModule Microsoft.Graph.* | %{ if($_.Name -ne "Microsoft.Graph.Authentication"){ Uninstall-Module $_.Name -AllowPrerelease -AllVersions } }
Uninstall-Module Microsoft.Graph.Authentication -AllowPrerelease -AllVersionsTegyük fel, hogy az alább látható Nem található egyezés hibaüzenet, ez azt jelenti, hogy a Microsoft Graph modult már eltávolították. Ez nem probléma, és folytatnia kell az összes fenti parancsot.
PackageManagement\Uninstall-Package : No match was found for the specified search criteria and module names 'Microsoft.Graph'.
At C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\2.2.5\PSModule.psm1:12733 char:21
+ ... $null = PackageManagement\Uninstall-Package @PSBoundParameters
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : ObjectNotFound: (Microsoft.Power...ninstallPackage:UninstallPackage) [Uninstall-Package], Exception
+ FullyQualifiedErrorId : NoMatchFound,Microsoft.PowerShell.PackageManagement.Cmdlets.UninstallPackageEz az!
Olvass tovább: A tétlen munkamenet időtúllépésének engedélyezése a Microsoft 365-ben »
Következtetés
Megtanulta a Microsoft Graph PowerShell telepítését. Csatlakozzon az Azure AD-hez a Microsoft Graph PowerShell-modul használatával MFA-val vagy anélkül. Miután csatlakozott a Microsoft Graph PowerShellhez, használhatja a parancsmagokat. Ne felejtse el leválasztani a kapcsolatot, amikor végzett.
Tetszett ez a cikk? A távoli PowerShell letiltása nem rendszergazdák számára is tetszhet. Ne felejtsen el követni minket és megosztani ezt a cikket.