Megosztás a következőn keresztül:

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

  • Cikk

Ez a rövid útmutató bemutatja, hogyan futtathat Azure Resource Graph-lekérdezést az Az.ResourceGraph Azure PowerShell moduljával. A modul része az Azure PowerShell legújabb verziójának, és hozzáadja a Resource Graph parancsmagjait .

A cikk azt is bemutatja, hogyan rendezheti (rendezheti) és korlátozhatja a lekérdezés eredményeit. A bérlői, felügyeleti csoportokban vagy előfizetésekben lévő erőforrásokra vonatkozó lekérdezést futtathat.

Előfeltételek

A modul telepítése

Ha telepítette a PowerShell és az Azure PowerShell legújabb verzióit, már rendelkezik a Az.ResourceGraph PowerShellGet modullal és szükséges verziójával.

Választható modultelepítés

Az alábbi lépésekkel telepítheti a Az.ResourceGraph modult, hogy az Azure PowerShell használatával Azure Resource Graph-lekérdezéseket futtasson. Az Azure Resource Graph-modulhoz a PowerShellGet 2.0.1-es vagy újabb verziója szükséges.

  1. Ellenőrizze a PowerShellGet-verziót:

    Get-Module -Name PowerShellGet

    Ha frissítenie kell, nyissa meg a PowerShellGetet.

  2. Telepítse a modult:

    Install-Module -Name Az.ResourceGraph -Repository PSGallery -Scope CurrentUser

    A parancs telepíti a modult a CurrentUser hatókörben. Ha telepítenie kell a AllUsers hatókörben, futtassa a telepítést egy rendszergazdai PowerShell-munkamenetből.

  3. Ellenőrizze, hogy a modul telepítve van-e:

    Get-Command -Module Az.ResourceGraph -CommandType Cmdlet

    A parancs megjeleníti a Search-AzGraph parancsmag verzióját, és betölti a modult a PowerShell-munkamenetbe.

Csatlakozás az Azure szolgáltatáshoz

Egy Visual Studio Code-terminál munkamenetből csatlakozzon az Azure-hoz. Ha több előfizetéssel rendelkezik, futtassa a parancsokat az előfizetés környezetének beállításához. Cserélje le a <subscriptionID> értékét a saját Azure-előfizetése azonosítójára.

Connect-AzAccount

# Run these commands if you have multiple subscriptions
Get-AzSubScription
Set-AzContext -Subscription <subscriptionID>

Lekérdezés futtatása

Miután hozzáadta a modult a környezethez, futtathat egy bérlőalapú lekérdezést. A példában szereplő lekérdezés öt Azure-erőforrást ad vissza az name egyes erőforrásokkal együtt type . A felügyeleti csoport vagy előfizetés szerinti lekérdezéshez használja a paramétereket vagy -Subscription a -ManagementGroup paramétereket.

  1. Azure Resource Graph-lekérdezés futtatása a Search-AzGraph parancsmaggal:

    Search-AzGraph -Query 'Resources | project name, type | limit 5'

    Ez a lekérdezési példa nem használ olyan rendezési módosítót, mint a order by. Ha többször futtatja a lekérdezést, az az egyes kérésekhez eltérő erőforráskészletet eredményezhet.

  2. Frissítse a lekérdezést a name tulajdonságraorder by:

    Search-AzGraph -Query 'Resources | project name, type | limit 5 | order by name asc'

    Az előző lekérdezéshez hasonlóan, ha ezt a lekérdezést többször is futtatja, az egyes kérésekhez eltérő erőforráskészletet eredményezhet. Fontos a lekérdezési parancsok sorrendje. Ebben a példában az order by a limit után következik. A lekérdezés öt erőforrásra korlátozza az eredményeket, majd név szerint rendeli el az eredményeket.

  3. Frissítse a lekérdezést a name tulajdonságraorder by, majd limit a kimenetet öt találatra:

    Search-AzGraph -Query 'Resources | project name, type | order by name asc | limit 5'

    Ha ezt a lekérdezést többször futtatja a környezet módosítása nélkül, az eredmények konzisztensek és a tulajdonság szerint name vannak rendezve, de továbbra is öt találatra korlátozódnak. A lekérdezés név alapján rendeli meg az eredményeket, majd öt erőforrásra korlátozza a kimenetet.

Ha egy 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ésekhez tartozik. 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, állítsa be a parancsmagot Search-AzGraph a PSDefaultParameterValues futtatással$PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}

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

Kijelentkezés az Azure PowerShell-munkamenetből:

Disconnect-AzAccount

Választható tisztítási lépések

Ha az Azure PowerShell legújabb verzióját telepítette, a Az.ResourceGraph modult is tartalmazza, és nem szabad eltávolítani. Az alábbi lépések nem kötelezőek, ha manuálisan telepítette a Az.ResourceGraph modult, és el szeretné távolítani a modult.

A modul PowerShell-munkamenetből való eltávolításához Az.ResourceGraph futtassa a következő parancsot:

Remove-Module -Name Az.ResourceGraph

A modul számítógépről való eltávolításához Az.ResourceGraph futtassa a következő parancsot:

Uninstall-Module -Name Az.ResourceGraph

Előfordulhat, hogy megjelenik egy üzenet, amely szerint az Az.ResourceGraph modul jelenleg használatban van. Ha igen, le kell állítania a PowerShell-munkamenetet, és el kell indítania egy új munkamenetet. Ezután futtassa a parancsot a modul számítógépről való eltávolításához.

Következő lépések

Ebben a rövid útmutatóban hozzáadta a Resource Graph modult az Azure PowerShell-környezethez, és lefuttatott egy lekérdezést. További információért lépjen a lekérdezési nyelv részleteinek lapjára.

Az Azure Resource Graph lekérdezési nyelvének ismertetése