Snabbstart: Kör din första Resource Graph med hjälp av Azure PowerShell

Det första steget till att använda Azure Resource Graph är att kontrollera att modulen för Azure PowerShell är installerad. Denna snabbstart vägleder dig genom processen för att lägga till modulen i Azure PowerShell-installationen.

I slutet av den här processen kommer du att ha lagt till modulen till valfri Azure PowerShell-installation och kört din första Resource Graph-fråga.

Förutsättningar

Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

Använda Azure Cloud Shell

Azure är värd för Azure Cloud Shell, en interaktiv gränssnittsmiljö som du kan använda via webbläsaren. Du kan använda antingen Bash eller PowerShell med Cloud Shell för att arbeta med Azure-tjänster. Du kan använda förinstallerade Cloud Shell-kommandon för att köra koden i den här artikeln utan att behöva installera något i din lokala miljö.

Så här startar du Azure Cloud Shell:

Alternativ Exempel/länk
Välj Prova i det övre högra hörnet av ett kodblock. Om du väljer Prova kopieras koden inte automatiskt till Cloud Shell. Exempel på Prova för Azure Cloud Shell
Gå till https://shell.azure.com eller Välj knappen Starta Cloud Shell för att öppna Cloud Shell i webbläsaren. Starta Cloud Shell i ett nytt fönster
Välj knappen Cloud Shell på menyn längst upp till höger i Azure-portalen. Cloud Shell-knappen i Azure Portal

Så här kör du koden i den här artikeln i Azure Cloud Shell:

  1. Starta Cloud Shell.

  2. Kopiera koden genom att klicka på knappen Kopiera på ett kodblock.

  3. Klistra in koden i Cloud Shell-sessionen genom att välja Ctrl+Skift+V på Windows och Linux eller genom att välja Cmd+Skift+V på macOS.

  4. Välj Retur för att köra koden.

Lägga till Resource Graph-modulen

Om du vill aktivera Azure PowerShell för att skicka frågor till Azure Resource Graph, måste du lägga till modulen. Den här modulen kan användas med lokalt installerade PowerShell, med Azure Cloud Shell, eller med PowerShell Docker-avbildningen.

Grundläggande krav

Azure Resource Graph-modulen måste ha följande programvara:

Installera modulen

Resource Graph-modulen för PowerShell är Az.ResourceGraph.

  1. Från en administrativ PowerShell-prompt kör du följande kommando:

    # Install the Resource Graph module from PowerShell Gallery
    Install-Module -Name Az.ResourceGraph
    
  2. Kontrollera att modulen har importerats och har minst version 0.10.0 :

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

Köra din första Resource Graph-fråga

Nu när Azure PowerShell-modulen har lagts till i din valda miljö är det dags att testa en enkel Resource Graph-fråga. Frågan returnerar de första fem Azure-resurserna med namn och resurstyp för varje resurs.

  1. Kör din första Azure Resource Graph-fråga med hjälp av cmdlet:et Search-AzGraph:

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

    Anteckning

    Eftersom det här frågeexempel inte ger någon sorteringsmodifierare som , kommer körning av frågan flera gånger troligen att ge en annan order by uppsättning resurser per begäran.

  2. Uppdatera frågan till order by egenskapen namn:

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

    Anteckning

    Om du kör den här frågan flera kommer den, precis som den första frågan, sannolikt att resultera i olika resurser vid varje begäran. Ordningen på frågekommandona är viktig. I det här exemplet kommer order by efter limit. Den här kommandoordningen begränsar först frågeresultatet och beställer dem sedan.

  3. Uppdatera frågan till att först order byNamn-egenskapen och sedan sätta en limit för de fem främsta resultaten:

    # 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').Data
    

När den sista frågan körs flera gånger, förutsatt att ingenting i din miljö ändras, är resultatet som returneras konsekventa och sorterade efter egenskapen Name, men fortfarande begränsade till de fem främsta resultaten.

Anteckning

Observera att cmdleten som standard är prenumerationer i standardkontexten om frågan inte returnerar resultat från en prenumeration som du Search-AzGraph redan har åtkomst till. Om du vill se en lista över prenumerations-ID:n som ingår i standardkontexten kör du det här Om du vill söka efter alla prenumerationer som du har åtkomst till kan du ange (Get-AzContext).Account.ExtendedProperties.Subscriptions PSDefaultParameterValues för cmdleten genom att köra Search-AzGraph``$PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}

Rensa resurser

Om du vill ta bort Resource Graph-modulen från din Azure PowerShell-miljö, kan du göra det med hjälp av följande kommando:

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

Anteckning

Modulfilen som laddades ned tidigare tas inte bort. Det tar bara bort den från den körda PowerShell-sessionen.

Nästa steg

I den här snabbstarten har du lagt till modulen Resource Graph i din Azure PowerShell miljö och kört din första fråga. Om du vill veta mer Resource Graph språk fortsätter du till sidan med information om frågespråk.