Rövid útmutató: az első Resource Graph-lekérdezés futtatása a Azure PowerShell használatávalQuickstart: Run your first Resource Graph query using Azure PowerShell

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.The first step to using Azure Resource Graph is to check that the module for Azure PowerShell is installed. E rövid útmutató segítségével hozzáadhatja a modult a telepített Azure PowerShellhez.This quickstart walks you through the process of adding the module to your Azure PowerShell installation.

Ezen folyamatban a modult hozzáadja az Azure PowerShell-telepítéshez, és futtatja az első Resource Graph-lekérdezést.At the end of this process, you'll have added the module to your Azure PowerShell installation of choice and run your first Resource Graph query.

ElőfeltételekPrerequisites

Ha nem rendelkezik Azure-előfizetéssel, első lépésként mindössze néhány perc alatt létrehozhat egy ingyenes fiókot.If you don't have an Azure subscription, create a free account before you begin.

Az Azure Cloud Shell használataUse Azure Cloud Shell

Az Azure által üzemeltetett Azure Cloud Shell egy interaktív felület, amelyet a böngészőből használhat.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. A Bash vagy a PowerShell segítségével is használhatja a Cloud Shellt az Azure-szolgáltatásokhoz.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. Az ebben a cikkben található kódot a Cloud Shell előtelepített parancsaival is futtathatja, így semmit nem kell a helyi környezetben telepítenie.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Az Azure Cloud Shell indítása:To start Azure Cloud Shell:

BeállításOption Példa/hivatkozásExample/Link
Kattintson a Kipróbálás elemre egy kódblokk jobb felső sarkában.Select Try It in the upper-right corner of a code block. A Kipróbálás lehetőségre kattintással nem másolja a kódot automatikusan a Cloud Shellbe.Selecting Try It doesn't automatically copy the code to Cloud Shell. Példa az Azure Cloud Shell Kipróbálás lehetőségére
Látogasson el a https://shell.azure.com webhelyre, vagy kattintson a Cloud Shell indítása gombra a böngészőben.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. A Cloud Shell indítása új ablakbanLaunch Cloud Shell in a new window
Az Azure Portal jobb felső sarkában található menüben kattintson a Cloud Shell gombra.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Cloud Shell gomb a Microsoft Azure Portal-on

Az ebben a cikkben szereplő kód Azure Cloud Shellben való futtatásához:To run the code in this article in Azure Cloud Shell:

  1. Indítsa el a Cloud Shellt.Start Cloud Shell.

  2. A kód másolásához válassza az adott kódblokkhoz tartozó Másolás gombot.Select the Copy button on a code block to copy the code.

  3. Illessze be a kódot a Cloud Shell-munkamenetbe a Ctrl+Shift+V billentyűkombinációval Windows és Linux rendszeren, vagy a Cmd+Shift+V billentyűkombinációval macOS rendszeren.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. A kód futtatásához nyomja le az Enter billentyűt.Select Enter to run the code.

A Resource Graph modul hozzáadásaAdd the Resource Graph module

Ahhoz, hogy az Azure PowerShell lekérdezhesse az Azure Resource Graphot, el kell végezni a modul hozzáadását.To enable Azure PowerShell to query Azure Resource Graph, the module must be added. Ez a modul helyileg telepített PowerShell-lel, Azure Cloud Shellvagy a PowerShell Docker-lemezképpelis használható.This module can be used with locally installed PowerShell, with Azure Cloud Shell, or with the PowerShell Docker image.

Alapszintű követelményekBase requirements

Az Azure Resource Graph modulhoz az alábbi szoftverek szükségesek:The Azure Resource Graph module requires the following software:

A modul telepítéseInstall the module

A PowerShellhez készült Resource Graph-modul az az. ResourceGraph.The Resource Graph module for PowerShell is Az.ResourceGraph.

  1. Rendszergazdai PowerShell-parancssorból futtassa a következő parancsot:From an administrative PowerShell prompt, run the following command:

    # 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 a legújabb verzió-e (0.7.5):Validate that the module has been imported and is the latest version (0.7.5):

    # 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ásaRun your first Resource Graph query

Miután az Azure PowerShell modul hozzá lett adva a választott környezethez, ideje futtatni egy egyszerű Resource Graph-lekérdezést.With the Azure PowerShell module added to your environment of choice, it's time to try out a simple Resource Graph query. A lekérdezés az első öt Azure-erőforrást adja vissza az egyes erőforrások nevével és erőforrás-típusával .The query returns the first five Azure resources with the Name and Resource Type of each resource.

  1. Futtassa az első Azure Resource Graph-lekérdezését a Search-AzGraph parancsmag használatával:Run your first Azure Resource Graph query using the Search-AzGraph cmdlet:

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

    Megjegyzés

    Ez a lekérdezési példa nem biztosít olyan rendezési módosítót, mint az order by, tehát ha többször is futtatja, valószínűleg minden kéréssel eltérő erőforráslistát fog kapni.As this query example does not provide a sort modifier such as order by, running this query multiple times is likely to yield a different set of resources per request.

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

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

    Megjegyzé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.Just as with the first query, running this query multiple times is likely to yield a different set of resources per request. Fontos a lekérdezési parancsok sorrendje.The order of the query commands is important. Ebben a példában az order by a limit után következik.In this example, the order by comes after the limit. Ez a parancs először a lekérdezés eredményeit korlátozza, majd megrendeli azokat.This command order first limits the query results and then orders them.

  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:Update the query to first order by the Name property and then limit to the top five results:

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

Ha a végső lekérdezés többször is fut, feltételezve, hogy a környezetében semmi sem változik, a visszaadott eredmények konzisztensek és a Name tulajdonság szerint vannak rendezve, de továbbra is az első öt találatra korlátozódnak.When the final query is run several times, assuming that nothing in your environment is changing, the results returned are consistent and ordered by the Name property, but still limited to the top five results.

Megjegyzés

Ha a lekérdezés nem ad vissza olyan előfizetésből származó eredményeket, amelyhez már van hozzáférése, akkor vegye figyelembe, hogy Search-AzGraph a parancsmag alapértelmezett környezetében az előfizetések alapértelmezés szerint szerepelnek.If the query does not return results from a subscription you already have access to, then note that Search-AzGraph cmdlet defaults to subscriptions in the default context. Ha szeretné megtekinteni az alapértelmezett környezet részét képező előfizetési azonosítók listáját (Get-AzContext).Account.ExtendedProperties.Subscriptions , akkor az összes Ön által elérhető előfizetésben megadhatja a PSDefaultParameterValues a Search-AzGraph parancsmag futtatásával. $PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}To see the list of subscription IDs which are part of the default context run this (Get-AzContext).Account.ExtendedProperties.Subscriptions If you wish to search across all the subscriptions you have access to, one can set the PSDefaultParameterValues for Search-AzGraph cmdlet by running $PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}

Az erőforrások eltávolításaClean up resources

Ha el szeretné távolítani a Resource Graph modult az Azure PowerShell-környezetből, ezt a következő paranccsal teheti meg:If you wish to remove the Resource Graph module from your Azure PowerShell environment, you can do so by using the following command:

# 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'

Megjegyzés

Ez nem törli a korábban letöltött Module-fájlt.This doesn't delete the module file downloaded earlier. Csak eltávolítja azt a futó PowerShell-munkamenetből.It only removes it from the running PowerShell session.

Következő lépésekNext steps

Ebben a rövid útmutatóban felvette az erőforrás-gráf modult a Azure PowerShell környezetbe, és futtatta az első lekérdezést.In this quickstart, you've added the Resource Graph module to your Azure PowerShell environment and run your first query. Ha többet szeretne megtudni az erőforrás-gráf nyelvéről, folytassa a lekérdezés nyelvének részletei lapon.To learn more about the Resource Graph language, continue to the query language details page.