A Microsoft Graph PowerShell-szkriptek futtatása az Azure Automation segítségével

Az Azure Automation-fiókok segítségével felügyelet nélküli és ismétlődő feladatokat hajthat végre szkriptek használatával, például rendszeres jelentéskészítéssel, automatikus esemény-javítással és az adminisztrációs feladatok automatizálásával. Az Azure Automation és a Microsoft Graph PowerShell közötti integráció végtelen lehetőségeket tesz lehetővé a környezet kezeléséhez és karbantartásához a Graph API használatával.

Ebben az oktatóanyagban bemutatom, hogyan hozhat létre Azure Automation-fiókot, és hogyan integrálhatja a Microsoft Graph PowerShell-szkriptet, hogy rendszeres automatizált feladatokat hajtson végre felhasználói beavatkozás nélkül.

Előfeltételek

Az oktatóanyagban vázolt lépések végrehajtásához gondoskodnia kell a következőkről:

• Azure-előfizetés
• Globális rendszergazdai hozzáféréssel rendelkező fiók

Mivel az Automation Accounts az Azure-ban található szolgáltatás, számlázási célból előfizetéshez kell őket kapcsolni. Ezen túlmenően, ahhoz, hogy hozzájáruljon a szkript felügyelet nélküli futtatásához szükséges engedélyekhez, globális rendszergazdai fiókkal kell megtennie.

Hozzon létre egy Azure AD-alkalmazást, és rendeljen hozzá engedélyt

Ha felhasználói beavatkozás vagy hitelesítés nélkül szeretné futtatni a Microsoft Graph PowerShell-szkriptet, létre kell hoznia egy új alkalmazást az Azure Active Directoryban a szkriptben szereplő műveletek végrehajtásához szükséges engedélyekkel. Először jelentkezzen be a Microsoft Entra felügyeleti központba, és kövesse az alábbi lépéseket:

1. Válassza az Alkalmazások > Alkalmazásregisztráció lehetőséget.

2. Az oldal tetején válassza az Új regisztráció lehetőséget.

3. Adjon meg egy értelmes nevet az alkalmazásnak, válassza a Csak ebben a szervezeti címtárban található fiókok lehetőséget, majd kattintson a Regisztráció lehetőségre.

4. Most hozzá kell rendelnie alkalmazásaihoz a megfelelő engedélyeket. Válassza az API-engedélyek lehetőséget.

5. Válassza az Engedély hozzáadása lehetőséget, majd az új előugró ablakban válassza a Microsoft Graph lehetőséget.

6. Az engedély típusához válassza az Alkalmazásengedélyek lehetőséget.

7. Keresse meg és jelölje ki az egyes engedélyeket a listából, majd miután az összes engedélyt kiválasztotta, kattintson az Engedélyek hozzáadása lehetőségre.

8. Most adminisztrátori hozzájárulást kell adnia ahhoz, hogy az alkalmazás használja a kért engedélyeket. Kattintson a Rendszergazdai hozzájárulás megadása az alapértelmezett címtárhoz lehetőségre.

9. Miután megadta az adminisztrátor hozzájárulását, az állapot oszlopban zöld pipák jelennek meg.

10. Az utolsó lépés annak a metódusnak a konfigurálása, amelyet a szkriptünk hitelesít az alkalmazás számára. Ehhez egy ügyféltitkot fogunk használni, amely a Microsoft Graph PowerShell 2. verziójában érhető el. Az alkalmazás beállítási oldalán válassza a Tanúsítványok és titkok lehetőséget.

11. Válassza az Ügyféltitkok > Új ügyféltitkos lehetőséget.

12. Adja meg a titok leírását és a lejárati dátumot (a maximális élettartam 2 év vagy 730 nap).

13. Mentse el a titkos kulcs értékét a szkriptben való használatra.

Mivel ennek az útmutatónak a célja a Microsoft Graph PowerShell és az Azure Automation használatának bemutatása, kövesse a másik oktatóanyagomat, amelyből megtudhatja, hogyan használhatja az alkalmazásengedélyeket ügyféltitkokkal a szkriptekben: Hogyan csatlakozhat a Microsoft Graph PowerShellhez ügyféltitkos használatával.

Hozzon létre egy Azure Automation-fiókot

Mivel a PowerShell-run-bookok az Azure Automation Accounts „folyamatautomatizálási” funkcióinak részét képezik, a következő teendőnk egy új automatizálási fiók létrehozása. Automatizálási fiók létrehozásához kövesse az alábbi lépéseket:

1. Először jelentkezzen be a http://portal.azure.com webhelyre, majd keresse meg az Automatizálási fiókok elemet.

2. Az Automation Accounts oldalon válassza a Létrehozás lehetőséget az új Automation Account varázsló elindításához.

3. A varázsló első oldalán válassza ki azt az előfizetést, amelyhez ez az erőforrás fog tartozni (ez az előfizetés lesz kiszámlázva). Ezután adja meg az erőforrásfiók nevét, automatizálási fiók nevét és a régiót, ahol az erőforrás földrajzilag tárolva lesz.

Végül kattintson az Áttekintés és létrehozás, majd a Létrehozás lehetőségre, és várja meg, amíg az üzembe helyezés befejeződik.

Importálja a Microsoft Graph PowerShell modulokat

Alapértelmezés szerint az Azure Automation számos PowerShell-modult tartalmaz, amelyek segítenek az Azure-erőforrások kezelésében. Az alapértelmezett modulok listájának megtekintéséhez tekintse meg a Microsoft docs oldalát a teljes lista megtekintéséhez. Fontos, hogy a Microsoft Graph PowerShell modulokat manuálisan kell importálni. A folyamat némileg eltérő, ha importálnia kell a modulok előnézeti verzióit. Kövesse az alábbi lépéseket a Microsoft Graph PowerShell jelenlegi és előnézeti verzióinak Azure Automation-fiókjába történő importálásához.

Importálja a Microsoft Graph PowerShell aktuális verzióit

1. Válassza ki az új Automation Fiókját az Automation Accounts oldalon.

2. A Megosztott erőforrások fejléc alatt válassza a Modulok lehetőséget.

3. Az új modul varázsló elindításához válassza a Modul hozzáadása lehetőséget.

4. Válassza a Tallózás a galériából, majd a Kattintson ide a galériából való tallózáshoz gombot.

5. Kezdje azzal, hogy megkeresi a Microsoft.Graph.Authentication modult, válassza ki a találati listából, majd a következő oldalon kattintson a Kiválasztás gombra.

6. Ismételje meg a 3-5. lépéseket minden további szükséges modulnál.

Importálja a Microsoft Graph PowerShell előnézeti verzióit

A modulgaléria oldal nem tartalmaz olyan előnézeti modulokat, amelyeket az Automation-fiókon belül telepíthet. Az előnézeti modul telepítésének legkényelmesebb módja, ha azt közvetlenül a PowerShell Gallary webhelyről teszi. Az előnézeti modul Azure Automation-fiókba való telepítéséhez kövesse az alábbi lépéseket:

1. Nyissa meg a https://www.powershellgallery.com/packages/Microsoft.Graph/ webhelyet, és válassza ki a telepíteni kívánt előnézeti verziót a Verzióelőzmények részben. Ebben a példában a 2.0.09-rc3 verziót választom.

2. Mivel az Azure Automationon keresztül csak meghatározott modulokat telepíthet, és nem a teljes SDK-t, bontsa ki a Csomag részletei részt, és kattintson a telepíteni kívánt modulra.

Észreveheti, hogy az URL megváltozik a böngészőjében, hogy megfeleljen a kiválasztott modulnak. Ezt manuálisan is módosíthatja.

3. Az Azure Automation lap most megjelenik a Telepítési beállítások munkamenet alatt. Nyissa meg ezt a lapot, és kattintson a Deploy to Azure Automation lehetőségre.

4. Megnyílik egy új ablak a böngészőben az Azure Automation modul importáló varázslójához. Ha szükséges, hitelesítsen, és válassza ki az Automation-fiókját a listából.

5. A következő oldalon kattintson az OK gombra, és várja meg, amíg a telepítés befejeződik. Ezt az Azure Portal értesítési ikonján láthatja.

6. Végezze el az 1-5. lépéseket minden egyes importálandó modulnál.

Valósítson meg automatizálási szkriptet egy Runbook segítségével

A runbookok az Azure Automation-fiók automatizálási összetevőjét alkotják. A runbookok a Windows PowerShellre épülnek, és a verziót a Runbook létrehozásakor megadott futásidejű verzió határozza meg. A rendelkezésre álló futásidejű verziók a következők:

• 5.1-es verzió
• 7.1-es verzió
• 7.2-es verzió

Kövesse az alábbi lépéseket a Runbook létrehozásához és a PowerShell-szkript hozzáadásához:

1. Nyissa meg Automation-fiókját, és a Process Automation fejléc alatt válassza a Runbooks lehetőséget.

2. Válassza a Runbook létrehozása lehetőséget.

3. A Runbook létrehozása oldalon adja meg a runbook nevét, válassza ki a Runbook típust PowerShellként és a Runtime version 5.1-et, majd kattintson a Create lehetőségre. b>.

4. A létrehozás után megnyílik a PowerShell szerkesztése ablak. Ha nem nyílik meg, térjen vissza az Automation-fiók Runbook oldalára, válassza ki az új Runbookot, és kattintson a Szerkesztés lehetőségre.

5. A PowerShell szerkesztése ablakban adja hozzá a szkriptet a kódterülethez, majd kattintson a Mentés > Közzététel lehetőségre.

6. Most tesztelje le Runbookját, hogy megbizonyosodjon arról, hogy a várt módon fut. A Runbook áttekintő oldalán válassza a Start lehetőséget.

7. Az Áttekintés oldal alján található Legutóbbi munkák listából kattintva ellenőrizheti, hogy a feladat hibákkal vagy anélkül fejeződik-e be.

8. Válassza ki az egyes lapokat, hogy megtekinthesse azokat a figyelmeztetéseket vagy hibákat, amelyek segíthetnek megoldani a problémákat, ha a parancsfájl nem fejeződik be sikeresen.

Állítsa be az automatizálási ütemezést

Az ütemezés meghatározza azt az időt, amikor a runbook egy ismétlődő ütemezés szerint fut, ez kényelmes, ha a szkriptet napi, heti vagy akár havi rendszerességgel kell futtatnia. Ehhez az oktatóanyaghoz ütemezést fogok készíteni a szkript napi futtatásához. Kövesse az alábbi lépéseket a runbook ütemezésének meghatározásához:

1. Nyissa meg Automation-fiókját, és válassza az Ütemezések lehetőséget a Megosztott erőforrások fejléc alatt.

2. Az Ütemezések oldalon válassza az Ütemezés hozzáadása lehetőséget.

3. A felugró ablakokban adja meg az ütemezési beállításokat, majd kattintson a Létrehozás gombra.

• Név: írjon be egy értelmes nevet.
• Kezdések: Adja hozzá a kívánt kezdési dátumot és időpontot.
• Időzóna: Adja meg az időzónát.
• Ismétlődés: Adja meg, hogy a runbook milyen gyakran fut egy ütemezés szerint.
• Lejárat beállítása: Adja meg, hogy mikor áll le a runbook ütemezése.

Összegzés

Mostantól rendelkezik egy Microsoft Graph PowerShell-szkripttel, amely felügyelet nélkül, ütemezetten fut az Azure Automation használatával! Ebben az oktatóanyagban megtanulta, hogyan:

• Hozzon létre egy Azure-alkalmazást, amely támogatja a szkript alkalmazásengedélyekkel történő futtatását
• Hozzon létre egy Azure Automation-fiókot
• Importáljon modulokat az Azure Automation-fiókjába
• Valósítsa meg a szkriptet egy Runbook segítségével
• Határozzon meg ütemezést a Runbook számára