Rychlý start: Spuštění prvního dotazu Resource Graphu pomocí Azure PowerShellu

Prvním krokem k použití služby Azure Resource Graph je zkontrolovat, že je nainstalovaný modul pro Azure PowerShell. Tento rychlý start vás provede procesem přidání modulu do instalace Azure PowerShell.

Na konci tohoto procesu budete mít za sebou přidání modulu k vybrané instalaci Azure PowerShellu a spuštění prvního dotazu na službu Resource Graph.

Požadavky

Pokud ještě nemáte předplatné Azure, vytvořte si napřed bezplatný účet.

Azure Cloud Shell

Azure hostí interaktivní prostředí Azure Cloud Shell, které můžete používat v prohlížeči. Pro práci se službami Azure můžete v prostředí Cloud Shell použít buď Bash, nebo PowerShell. Předinstalované příkazy Cloud Shellu můžete použít ke spuštění kódu v tomto článku, aniž byste museli instalovat cokoli do místního prostředí.

Spuštění služby Azure Cloud Shell:

Možnost Příklad nebo odkaz
Vyberte Vyzkoušet v pravém horním rohu bloku kódu nebo příkazu. Výběrem možnosti Vyzkoušet se kód ani příkaz automaticky nekopíruje do Cloud Shellu. Screenshot that shows an example of Try It for Azure Cloud Shell.
Přejděte na adresu https://shell.azure.com nebo výběrem tlačítka Spustit Cloud Shell otevřete Cloud Shell v prohlížeči. Button to launch Azure Cloud Shell.
Zvolte tlačítko Cloud Shell v pruhu nabídky v pravém horním rohu webu Azure Portal. Screenshot that shows the Cloud Shell button in the Azure portal

Použití Azure Cloud Shellu:

  1. Spusťte Cloud Shell.

  2. Výběrem tlačítka Kopírovat v bloku kódu (nebo bloku příkazů) zkopírujte kód nebo příkaz.

  3. Vložte kód nebo příkaz do relace Cloud Shellu tak, že ve Windows a Linuxu vyberete ctrl+Shift+V nebo vyberete Cmd+Shift+V v macOS.

  4. Stisknutím klávesy Enter spusťte kód nebo příkaz.

Přidat modul k Resource Graph

Chcete-li pro Azure PowerShell povolit dotaz na Azure Resource Graph, musí být modul přidán. Tento modul je možné použít s místně nainstalovaným PowerShellem, s Azure Cloud Shellem nebo s imagí Dockeru PowerShellu.

Základní požadavky

Modul Azure Resource Graph vyžaduje následující software:

  • Azure PowerShell 1.0.0 nebo vyšší. Pokud ještě není nainstalovaný, postupujte podle těchto pokynů.

  • PowerShellGet 2.0.1 nebo novější. Pokud není nainstalovaný nebo aktualizovaný, postupujte podle těchto pokynů.

Instalace modulu

Modul Resource Graph pro PowerShell je Az.ResourceGraph.

  1. Z příkazového řádku PowerShellu pro správu spusťte následující příkaz:

    # Install the Resource Graph module from PowerShell Gallery
    Install-Module -Name Az.ResourceGraph
    
  2. Ověřte, že se modul naimportoval a má alespoň verzi 0.11.0:

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

Spusťte nejdříve dotaz na Resource Graph použitím Azure CLI

S modulem Azure PowerShellu přidaným do zvoleného prostředí je čas vyzkoušet jednoduchý dotaz Resource Graph založený na tenantovi. Dotaz vrátí prvních pět prostředků Azure s názvem a typem prostředku každého prostředku. K dotazování podle skupiny pro správu nebo předplatného použijte -ManagementGroup parametry.-Subscription

  1. Spusťte první dotaz Azure Resource Graph použitím 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'
    

    Poznámka:

    Protože tento příklad dotazu neposkytuje modifikátor řazení, například order by, spuštění tohoto dotazu několikrát pravděpodobně přinese jinou sadu prostředků na požadavek.

  2. Aktualizuje dotaz pro order byNázev vlastnosti:

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

    Poznámka:

    Stejně jako u prvního dotazu opakované spouštění tohoto dotazu pravděpodobně poskytne jinou sadu zdrojů na jednu žádost. Pořadí příkazů dotazů je důležité. V tomto příkladu order by přichází po limit. Toto pořadí příkazů nejprve omezuje výsledky dotazu a pak je objednává.

  3. Aktualizujte dotaz tak, aby se nejprve výsledky seřadily podle názvu (nastavte order by na Name) a pak nastavte omezení (limit) na prvních pět výsledků:

    # 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
    

Když se konečný dotaz spustí několikrát, za předpokladu, že se ve vašem prostředí nic nezmění, vrácené výsledky jsou konzistentní a seřazené podle vlastnosti Name , ale stále jsou omezené na prvních pět výsledků.

Poznámka:

Pokud dotaz nevrací výsledky z předplatného, ke kterému už máte přístup, mějte na paměti, že Search-AzGraph rutina se ve výchozím kontextu standardně používá k předplatným. Pokud chcete zobrazit seznam ID předplatného, které jsou součástí výchozího kontextu, spusťte spuštěním (Get-AzContext).Account.ExtendedProperties.Subscriptions příkazu . Pokud chcete hledat ve všech předplatných, ke kterým máte přístup, můžete nastavit PSDefaultParameterValues pro Search-AzGraph rutinu. $PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}

Vyčištění prostředků

Pokud chcete odebrat modul Resource Graph z prostředí Azure PowerShell, můžete tak provést pomocí následujícího příkazu:

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

Poznámka:

Tím se neodstraní dříve stažený soubor modulu. Pouze ho odebere ze spuštěného relace PowerShell.

Další kroky

V tomto rychlém startu jste do prostředí Azure PowerShellu přidali modul Resource Graph a spustili svůj první dotaz. Další informace o jazyce Resource Graph najdete na stránce podrobností dotazovacího jazyka.