Rövid útmutató: Az első Resource Graph-lekérdezés futtatása az Azure PowerShell használatával

Az Azure Resource Graph használatához először meg kell győződnie arról, hogy az Azure PowerShellhez szükséges modul telepítve van. E rövid útmutató segítségével hozzáadhatja a modult a telepített Azure PowerShellhez.

Ezen folyamatban a modult hozzáadja az Azure PowerShell-telepítéshez, és futtatja az első Resource Graph-lekérdezést.

Előfeltételek

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

Azure Cloud Shell

Az Azure által üzemeltetett Azure Cloud Shell egy interaktív felület, amelyet a böngészőből használhat. A Bash vagy a PowerShell segítségével is használhatja a Cloud Shellt az Azure-szolgáltatásokhoz. A Cloud Shell előre telepített parancsaival futtathatja a jelen cikkben szereplő kódot anélkül, hogy bármit telepítenie kellene a helyi környezetben.

Az Azure Cloud Shell indítása:

Lehetőség	Példa/hivatkozás
Válassza a Kipróbálás lehetőséget egy kód vagy parancsblokk jobb felső sarkában. A Kipróbálás lehetőség választása nem másolja automatikusan a kódot vagy a parancsot a Cloud Shellbe.
Látogasson el a https://shell.azure.com webhelyre, vagy kattintson a Cloud Shell indítása gombra a böngészőben.
Az Azure Portal jobb felső sarkában található menüben kattintson a Cloud Shell gombra.

Az Azure Cloud Shell használata:

1. Indítsa el a Cloud Shellt.

2. A kód vagy parancs másolásához kattintson a Másolás gombra egy kódblokkon (vagy parancsblokkon).

3. Illessze be a kódot vagy parancsot a Cloud Shell-munkamenetbe a Windows és Linux rendszeren a Ctrl Shift+V billentyűkombinációval+, vagy a Cmd+Shift+V macOS rendszeren való kiválasztásával.

4. A kód vagy parancs futtatásához válassza az Enter lehetőséget .

A Resource Graph modul hozzáadása

Ahhoz, hogy az Azure PowerShell lekérdezhesse az Azure Resource Graphot, el kell végezni a modul hozzáadását. Ez a modul használható helyileg telepített PowerShell-lel, az Azure Cloud Shellrel vagy a PowerShell Docker-rendszerképpel.

Alapszintű követelmények

Az Azure Resource Graph modulhoz az alábbi szoftverek szükségesek:

• Azure PowerShell 1.0.0 vagy újabb. Ha még nincs telepítve, kövesse ezeket az utasításokat.

• PowerShellGet 2.0.1-es vagy újabb verzió. Ha nincs telepítve vagy frissítve, kövesse ezeket az utasításokat.

A modul telepítése

A PowerShell Resource Graph-modulja az Az.ResourceGraph.

1. Egy rendszergazdai PowerShell-parancssorból futtassa a következő parancsot:

   # Install the Resource Graph module from PowerShell Gallery
   Install-Module -Name Az.ResourceGraph
   

2. Ellenőrizze, hogy a modul importálása megtörtént-e, és legalább verziójú-e 0.11.0:

   # Get a list of commands for the imported Az.ResourceGraph module
   Get-Command -Module 'Az.ResourceGraph' -CommandType 'Cmdlet'
   

Az első Resource Graph-lekérdezés futtatása

Ha az Azure PowerShell-modult hozzáadta a választott környezethez, ideje kipróbálni egy egyszerű bérlőalapú Resource Graph-lekérdezést. A lekérdezés az első öt Azure-erőforrást adja vissza az egyes erőforrások nevével és erőforrástípusával . A felügyeleti csoport vagy előfizetés szerinti lekérdezéshez használja a paramétereket vagy -Subscription a -ManagementGroup paramétereket.

1. Futtassa az első Azure Resource Graph-lekérdezését a Search-AzGraph parancsmag használatával:

   # Login first with Connect-AzAccount if not using Cloud Shell
   
   # Run Azure Resource Graph query
   Search-AzGraph -Query 'Resources | project name, type | limit 5'
   

   Feljegyzés

   Mivel ez a lekérdezési példa nem biztosít olyan rendezési módosító elemet, mint például order by, a lekérdezés többszöri futtatása valószínűleg kérésenként eltérő erőforráskészletet eredményez.

2. Frissítse a lekérdezést úgy, hogy a rendezési szempont (order by) a Name tulajdonság legyen:

   # Run Azure Resource Graph query with 'order by'
   Search-AzGraph -Query 'Resources | project name, type | limit 5 | order by name asc'
   

   Feljegyzés

   Csakúgy, mint az első lekérdezésnél, e lekérdezés többszöri futtatása esetén is valószínűleg minden kéréssel eltérő erőforráslistát fog kapni. Fontos a lekérdezési parancsok sorrendje. Ebben a példában az order by a limit után következik. Ez a parancsrend először korlátozza a lekérdezés eredményeit, majd megrendeli őket.

3. Először frissítse a lekérdezést, hogy a Name tulajdonság szerint legyen rendezve (order by), majd korlátozza (limit) az első öt találatra:

   # Store the query in a variable
   $query = 'Resources | project name, type | order by name asc | limit 5'
   
   # Run Azure Resource Graph query with `order by` first, then with `limit`
   Search-AzGraph -Query $query
   

Ha a végleges lekérdezés többször is lefut, feltételezve, hogy a környezetben semmi sem változik, a visszaadott eredmények konzisztensek és a Név tulajdonság szerint vannak rendezve, de továbbra is az első öt találatra korlátozódnak.

Feljegyzés

Ha a lekérdezés nem ad vissza eredményeket olyan előfizetésből, amelyhez már rendelkezik hozzáféréssel, vegye figyelembe, hogy Search-AzGraph a parancsmag alapértelmezés szerint az alapértelmezett környezetben lévő előfizetésekre vonatkozik. Az alapértelmezett környezet részét képező előfizetés-azonosítók listájának megtekintéséhez futtassa ezt (Get-AzContext).Account.ExtendedProperties.Subscriptions a parancsmagot, ha az összes olyan előfizetésben szeretne keresni, amelyhez hozzáférése van, beállíthatja a PSDefaultParameterValues parancsmagot Search-AzGraph a parancsmag futtatásával $PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}

Az erőforrások eltávolítása

Ha el szeretné távolítani a Resource Graph modult az Azure PowerShell-környezetből, ezt a következő paranccsal teheti meg:

# Remove the Resource Graph module from the current session
Remove-Module -Name 'Az.ResourceGraph'

# Uninstall the Resource Graph module from the environment
Uninstall-Module -Name 'Az.ResourceGraph'

Feljegyzés

Ez nem törli a korábban letöltött modulfájlt. Csak eltávolítja azt a futó PowerShell-munkamenetből.

Következő lépések

Ebben a rövid útmutatóban hozzáadta a Resource Graph modult az Azure PowerShell-környezethez, és futtatta az első lekérdezést. A Resource Graph nyelvével kapcsolatos további információkért lépjen a lekérdezés nyelvének részleteit tartalmazó oldalra.

További információ a lekérdezés nyelvéről