Sdílet prostřednictvím


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

Tento rychlý start popisuje, jak spustit dotaz Azure Resource Graphu pomocí Az.ResourceGraph modulu pro Azure PowerShell. Modul je součástí nejnovější verze Azure PowerShellu a přidává rutiny pro Resource Graph.

Č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.

Požadavky

Instalace modulu

Pokud jste nainstalovali nejnovější verze PowerShellu a Azure PowerShellu, už máte Az.ResourceGraph modul a požadovanou verzi modulu PowerShellGet.

Volitelná instalace modulu

Pomocí následujících kroků nainstalujte Az.ResourceGraph 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šší.

  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 by name 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 by name 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ů

Odhlášení z relace Azure PowerShellu:

Disconnect-AzAccount

Volitelné kroky čištění

Pokud jste nainstalovali nejnovější verzi Azure PowerShellu, Az.ResourceGraph modul se zahrne a neměl by se odebírat. Následující kroky jsou volitelné, pokud jste provedli ruční instalaci Az.ResourceGraph modulu a chcete modul odebrat.

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.

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.