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

  • Článek

Tento rychlý start popisuje, jak spustit dotaz Azure Resource Graphu pomocí Az.ResourceGraph modulu pro Azure PowerShell. Článek také ukazuje, jak seřadit (seřadit) a omezit výsledky dotazu. Můžete spustit dotaz na prostředky ve vašem tenantovi, skupinách pro správu nebo předplatných. Až budete hotovi, můžete modul odebrat.

Požadavky

Instalace modulu

Az.ResourceGraph Nainstalujte modul, abyste mohli pomocí Azure PowerShellu spouštět dotazy Azure Resource Graphu. Modul Azure Resource Graph vyžaduje Modul PowerShellGet verze 2.0.1 nebo vyšší. Pokud jste nainstalovali nejnovější verze PowerShellu a Azure PowerShellu, už máte požadovanou verzi.

  1. Ověřte svou verzi PowerShellGetu:

    Get-Module -Name PowerShellGet

    Pokud potřebujete aktualizaci, přejděte do modulu PowerShellGet.

  2. Nainstalujte modul:

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

    Příkaz nainstaluje modul v CurrentUser oboru. Pokud potřebujete nainstalovat v AllUsers oboru, spusťte instalaci z relace Prostředí PowerShell pro správu.

  3. Ověřte, že se modul nainstaloval:

    Get-Command -Module Az.ResourceGraph -CommandType Cmdlet

    Příkaz zobrazí Search-AzGraph verzi rutiny a načte modul do relace PowerShellu.

Připojení k Azure

Z relace terminálu editoru Visual Studio Code se připojte k Azure. Pokud máte více než jedno předplatné, spusťte příkazy pro nastavení kontextu pro vaše předplatné. <subscriptionID> nahraďte ID vašeho předplatného Azure.

Connect-AzAccount

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

Spuštění dotazu

Po přidání modulu do vašeho prostředí můžete spustit dotaz založený na tenantovi. Dotaz v tomto příkladu vrátí pět prostředků Azure s každým prostředkem name a type z 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 dotaz Azure Resource Graphu pomocí rutiny Search-AzGraph :

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

    Tento příklad dotazu nepoužívá modifikátor řazení, jako je order by. Pokud dotaz spustíte několikrát, může pro každý požadavek přinést jinou sadu prostředků.

  2. Aktualizujte dotaz na order byname vlastnost:

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

    Stejně jako předchozí dotaz, pokud tento dotaz spustíte několikrát, může pro každý požadavek přinést jinou sadu prostředků. Pořadí příkazů dotazů je důležité. V tomto příkladu order by přichází po limit. Dotaz omezuje výsledky na pět prostředků a pak tyto výsledky seřídí podle názvu.

  3. Aktualizujte dotaz na order byname vlastnost a pak limit výstup na pět výsledků:

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

    Pokud se tento dotaz spustí několikrát beze změn vašeho prostředí, výsledky jsou konzistentní a seřazené name podle vlastnosti, ale stále jsou omezené na pět výsledků. Dotaz seřídí výsledky podle názvu a pak omezí výstup na pět prostředků.

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 toto (Get-AzContext).Account.ExtendedProperties.Subscriptions spuštěním příkazu Pokud chcete prohledat všechna předplatná, ke kterým máte přístup, nastavte pro Search-AzGraph rutinu PSDefaultParameterValues spuštěním příkazu .$PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}

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

Pokud chcete modul odebrat Az.ResourceGraph z relace PowerShellu, spusťte následující příkaz:

Remove-Module -Name Az.ResourceGraph

Pokud chcete modul odinstalovat Az.ResourceGraph z počítače, spusťte následující příkaz:

Uninstall-Module -Name Az.ResourceGraph

Může se zobrazit zpráva, že modul Az.ResourceGraph se právě používá. Pokud ano, musíte vypnout relaci PowerShellu a spustit novou relaci. Potom spuštěním příkazu odinstalujte modul z počítače.

Odhlášení z relace Azure PowerShellu:

Disconnect-AzAccount

Další kroky

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

Principy dotazovacího jazyka služby Azure Resource Graph