Weboldal keresés

Hogyan csatlakozhatunk a Microsoft Graph PowerShellhez

Különféle módszerekkel csatlakozhat a Microsoft Graph PowerShellhez a Microsoft 365 és az Azure-bérlő kezeléséhez. Az, hogy melyik módszer felel meg Önnek, attól függ, hogy mit szeretne. Egy jó példa a Microsoft Graph PowerShellhez való csatlakozás a Microsoft Graph PowerShell-parancsfájlok felhasználói beavatkozás nélkül történő automatizálásához. Ebből a cikkből megtudhatja, hogyan csatlakozhat a Microsoft Graph PowerShellhez három különböző módszerrel.

Előfeltételek

Telepítenie kell a Microsoft Graph PowerShell modulokat a rendszerére.

Indítsa el a Windows PowerShellt rendszergazdaként, és futtassa az alábbi parancsokat.

Install-Module Microsoft.Graph -Force
Install-Module Microsoft.Graph.Beta -AllowClobber -Force

Fontos: Mindig telepítse a Microsoft Graph PowerShell és a Microsoft Graph Beta PowerShell modulokat. Ennek az az oka, hogy néhány parancsmag még nem érhető el a végleges verzióban, és nem fog működni. Frissítse mindkét modult a legújabb verzióra, mielőtt parancsmagot vagy parancsfájlt futtatna, hogy elkerülje a hibákat és a helytelen eredményeket.

1. módszer - Hogyan csatlakozhatunk a Microsoft Graphhoz felhasználói beavatkozással

Az első módszer az a módszer, amelyet a legtöbbször fog használni, mert csatlakozni szeretne a Microsoft Graphhoz a fiókjával, és használni szeretné a parancsokat.

Connect-MgGraph -Scopes "User.Read.All"

Ellenőrizze a hitelesítő adatait, és visszatér a PowerShell ablakba.

2. módszer - Csatlakozás a Microsoft Graphhoz tanúsítvány alapú hitelesítési CBA segítségével

A második módszer egy alkalmazás regisztrálása az Azure-ban az engedélyekkel. Végezzük el az alábbi lépéseket, és állítsuk be a Microsoft Graph Certificate Based Authentication funkciót a felügyelet nélküli szkriptekhez.

1. Regisztráljon alkalmazást az Azure-ban

Egy alkalmazás Azure AD-ben való regisztrálásához kövesse az alábbi lépéseket:

  1. Jelentkezzen be a Microsoft Entra felügyeleti központba
  2. Bontsa ki az Azure Active Directory elemet
  3. Kattintson az Alkalmazások > Alkalmazásregisztrációk lehetőségre
  4. Válassza az Új regisztráció lehetőséget

  1. Írja be az MSGraph-Automation nevet
  2. Válassza a Fiókok bármely szervezeti címtárban (Bármely Azure AD-címtár - többbérlős) és a személyes Microsoft-fiókok lehetőséget.
  3. Kattintson a Regisztráció lehetőségre

  1. Megjelenik az MSGraph-Automation alkalmazás, az Áttekintés
  2. Másolja ki az Alkalmazás (ügyfélazonosító) és a Directory (bérlő) azonosítót, és illessze be a Jegyzettömbbe, mert később szüksége lesz rá, amikor csatlakozik a Microsoft Graphhoz.

2. Konfigurálja az Azure-alkalmazás API-engedélyeit

Az alábbi lépések végrehajtásával API-engedélyeket kell hozzáadnia az Ön által létrehozott MSGraph-Automation alkalmazáshoz:

  1. Kattintson az API-engedélyek > Engedély hozzáadása lehetőségre

  1. Válassza a Microsoft API-k > Microsoft Graph lehetőséget

  1. Válassza az Alkalmazásengedélyek lehetőséget
  2. Keresse meg a user.read.all kifejezést
  3. Bontsa ki a Felhasználó elemet, és válassza a User.Read.All lehetőséget
  4. Kattintson az Engedélyek hozzáadása lehetőségre

  1. Kattintson a Rendszergazdai hozzájárulás megadása lehetőségre
  2. Kattintson az Igen lehetőségre

  1. Az állapot egy zöld pipát mutat

Most, hogy az alkalmazás regisztrálva van, és az API-engedélyek be vannak állítva, két módszert konfigurálhatunk a hitelesítéshez; Tanúsítvány vagy ügyféltitkos.

3. Önaláírt tanúsítvány létrehozása

Önaláírt tanúsítvány létrehozásához jelentkezzen be bármely Windows Serverre vagy asztali számítógépre a Windows PowerShell segítségével. A legjobb, ha a tanúsítványt azon a gépen állítja elő, amelyen futtatni szeretné a felügyelet nélküli PowerShell-szkriptet.

Szüksége lesz az önaláírt tanúsítványra a későbbi lépésekben, amikor feltölti az alkalmazásba az Azure-ban, és ha más rendszereken is szeretné használni a tanúsítványt.

Megjegyzés: Alapértelmezés szerint az önaláírt tanúsítványok egy évig érvényesek.

Ebben az esetben az önaláírt tanúsítványhoz 5 évet adtunk, így nem kell évente megújítani.

$mycert = New-SelfSignedCertificate -DnsName "exoip.com" -CertStoreLocation "cert:\LocalMachine\My" -NotAfter (Get-Date).AddYears(5) -KeySpec KeyExchange -FriendlyName "MSGraph Automation"

Erősítse meg a tanúsítványt, és másolja ki a ThumbPrint fájlt, és illessze be a Jegyzettömbbe. Később szüksége lesz rá, amikor csatlakozik a Microsoft Graphhoz.

$mycert | Select-Object -Property Subject,Thumbprint,NotBefore,NotAfter

Így néz ki a kimenet.

Subject      Thumbprint                               NotBefore           NotAfter           
-------      ----------                               ---------           --------           
CN=exoip.com 384010504F6B495B6D53B1C55DC6C1A7273081AC 7/7/2023 6:14:36 PM 7/7/2028 6:24:36 PM

Tanúsítvány exportálása .cer fájlba.

Szüksége lesz erre a .cer fájlra, amikor feltölti az Azure-alkalmazásba, amelyet a következő lépésekben hoz létre.

$mycert | Export-Certificate -FilePath "C:\temp\MSGraphAutomationCert.cer"

Megjelenik a kimenet.

    Directory: C:\temp


Mode                LastWriteTime         Length Name                     
----                -------------         ------ ----                     
-a----         7/7/2023   6:25 PM            796 MSGraphAutomationCert.cer

Tanúsítvány exportálása .pfx fájlba.

Szüksége lesz erre a .pfx fájlra, ha másik gépet használ a tanúsítvány alapú hitelesítéshez való csatlakozáshoz. Másolja vagy küldje el a .pfx fájlt, és telepítse más gépekre.

$mycert | Export-PfxCertificate -FilePath "C:\temp\MSGraphAutomationCert.pfx" -Password $(ConvertTo-SecureString -String "P@ssw0Rd1234" -AsPlainText -Force)

Megjelenik a kimenet.

    Directory: C:\temp


Mode                LastWriteTime         Length Name                     
----                -------------         ------ ----                     
-a----         7/7/2023   6:26 PM           2717 MSGraphAutomationCert.pfx

4. Töltse fel a tanúsítványt az alkalmazásba

Fel kell töltenie az előző lépésben létrehozott önaláírt tanúsítványt:

  1. Kattintson a Tanúsítványok és titkok lehetőségre
  2. Kattintson a Tanúsítványok > Tanúsítvány feltöltése lehetőségre
  3. Kattintson a böngészés ikonra, és válassza ki az önaláírt MSGraphAutomationCert.cer fájlt a C:\temp mappában.
  4. Adja hozzá az MS Graph Automation Cert leírást
  5. Kattintson a Hozzáadás lehetőségre

  1. A tanúsítvány megjelenik a listában

Megjegyzés: Győződjön meg arról, hogy ugyanazzal a tanúsítvány ujjlenyomatával rendelkezik, mint amelyet az előző lépésben exportált.

5. Csatlakozzon a Microsoft Graphhoz tanúsítvány alapú hitelesítéssel

Indítsa el a Windows PowerShell ISE-t vagy a Visual Studio Code-ot, és töltse ki az alábbi három változót a Microsoft Graph PowerShellhez tanúsítvány alapú hitelesítéssel történő csatlakozáshoz:

  1. $ClientId
  2. $BérlőId
  3. $CertificateThumbPrint
# Configuration
$ClientId = "0a613e88-a189-4eac-b8c3-055196fd04d6"
$TenantId = "eb403171-a4ec-4d98-a08f-1876318c9deb"
$CertificateThumbprint = "384010504F6B495B6D53B1C55DC6C1A7273081AC"

# Connect to Microsoft Graph with CBA
Connect-MgGraph -ClientId $ClientId -TenantId $TenantId -CertificateThumbprint $CertificateThumbprint

Most, hogy csatlakozott a Microsoft Graph PowerShellhez, futtassa a Get-MgUser parancsmagot a felhasználók lekéréséhez.

Get-MgUser

3. módszer - Csatlakozás a Microsoft Graphhoz a Client Secret segítségével

A harmadik módszer egy alkalmazás regisztrálása az Azure-ban az engedélyekkel. Végezzük el az alábbi lépéseket, és állítsuk be a Microsoft Graph Client Secret szolgáltatást a felügyelet nélküli szkriptekhez.

1. Regisztráljon egy alkalmazást az Azure-ban

Hajtsa végre a fenti lépést egy alkalmazás Azure-ban való regisztrálásához, ha ezt nem tette meg.

2. Konfigurálja az Azure-alkalmazás API-engedélyeit

Hajtsa végre a fenti lépést az Azure-alkalmazás API-engedélyeinek konfigurálásához, ha ezt nem tette meg.

3. Adjon hozzá egy ügyféltitkot

Hozzá kell adnia egy titkos ügyfélkódot, amelyet az alkalmazás a token kérésekor a személyazonosságának bizonyítására használ.

  1. Kattintson a Tanúsítványok és titkok lehetőségre
  2. Kattintson az Ügyféltitkok > Új titkos ügyfél titkossága lehetőségre
  3. Adja meg az MS Graph Automation Secret leírását
  4. Válassza ki a lejárati dátumot 730 nap (24 hónap)
  5. Kattintson a Hozzáadás lehetőségre

  1. Másolja ki a Client Secret Value értéket, és illessze be a Jegyzettömbbe, mert szüksége lesz rá a következő lépésben, amikor csatlakozik a Microsoft Graphhoz.

4. Csatlakozzon a Microsoft Graphhoz a Client Secret segítségével

Indítsa el a Windows PowerShell ISE-t vagy a Visual Studio Code-ot, és töltse ki az alábbi három változót, hogy csatlakozzon a Microsoft Graph PowerShellhez a Client Secret segítségével:

  1. $ClientId
  2. $BérlőId
  3. $ClientSecret
# Configuration
$ClientId = "0a613e88-a189-4eac-b8c3-055196fd04d6"
$TenantId = "eb403171-a4ec-4d98-a08f-1876318c9deb"
$ClientSecret = "Kos8Q~nVLcjmmyGSY68qDg4zbdF8f51L2EM50ac5"

# Convert the client secret to a secure string
$ClientSecretPass = ConvertTo-SecureString -String $ClientSecret -AsPlainText -Force

# Create a credential object using the client ID and secure string
$ClientSecretCredential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $ClientId, $ClientSecretPass

# Connect to Microsoft Graph with Client Secret
Connect-MgGraph -TenantId $tenantId -ClientSecretCredential $ClientSecretCredential

Most, hogy csatlakozott a Microsoft Graph PowerShellhez, futtassa a Get-MgUser parancsmagot a felhasználók lekéréséhez.

Get-MgUser

Ennyi!

Bővebben: Az ügyféltitkos megújítása a Microsoft Entra ID-ben »

Következtetés

Megtanulta, hogyan csatlakozhat a Microsoft Graph PowerShellhez három módszerrel. Végezze el a lépésenkénti útmutatót, és a Microsoft Graph PowerShell segítségével hitelesíthet felhasználói interakcióval (1. módszer) vagy felhasználói beavatkozás nélkül a felügyelet nélküli szkriptekhez (2/3. módszer). Mindezek a módszerek kiválóan használhatók.

Tetszett ez a cikk? Lehet, hogy tetszeni fog Microsoft Entra ID felhasználók létrehozása CSV-ből a PowerShell segítségével. Ne felejtsen el követni minket és megosztani ezt a cikket.

Kapcsolódó cikkek