Guida introduttiva: Eseguire la prima query di Resource Graph con Azure PowerShell

  • Articolo

Il primo passaggio per usare Azure Resource Graph consiste nel verificare che il modulo per Azure PowerShell sia installato. Questa guida introduttiva illustra il processo di aggiunta del modulo all'installazione di Azure PowerShell.

Alla fine di questo processo, il modulo risulterà aggiunto all'installazione di Azure PowerShell scelta e si eseguirà la prima query di Resource Graph.

Prerequisiti

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

Azure Cloud Shell

Azure Cloud Shell è un ambiente di shell interattivo ospitato in Azure e usato tramite il browser. È possibile usare Bash o PowerShell con Cloud Shell per usare i servizi di Azure. È possibile usare i comandi preinstallati di Cloud Shell per eseguire il codice in questo articolo, senza dover installare alcun elemento nell'ambiente locale.

Per avviare Azure Cloud Shell:

Opzione Esempio/Collegamento
Selezionare Prova nell'angolo superiore destro di un codice o di un blocco di comandi. Selezionando Prova non viene copiato automaticamente il codice o il comando in Cloud Shell. Screenshot that shows an example of Try It for Azure Cloud Shell.
Passare a https://shell.azure.com o selezionare il pulsante Avvia Cloud Shell per aprire Cloud Shell nel browser. Button to launch Azure Cloud Shell.
Selezionare il pulsante Cloud Shell nella barra dei menu nell'angolo in alto a destra del portale di Azure. Screenshot that shows the Cloud Shell button in the Azure portal

Per usare Azure Cloud Shell:

  1. Avviare Cloud Shell.

  2. Selezionare il pulsante Copia in un blocco di codice (o blocco di comandi) per copiare il codice o il comando.

  3. Incollare il codice o il comando nella sessione di Cloud Shell selezionando CTRL+MAIUSC+V in Windows e Linux oppure selezionando CMD+MAIUSC+V in macOS.

  4. Selezionare INVIO per eseguire il codice o il comando.

Aggiungere il modulo di Resource Graph

Per consentire ad Azure PowerShell di eseguire query su Azure Resource Graph, il modulo deve essere aggiunto. Questo modulo può essere usato con PowerShell installato in locale, con Azure Cloud Shell o con l'immagine Docker di PowerShell.

Requisiti di base

Il modulo Azure Resource Graph richiede il software seguente:

  • Azure PowerShell 1.0.0 o versione successiva. Se non è ancora installato, seguire queste istruzioni.

  • PowerShellGet 2.0.1 o versione successiva. Se non è installato o aggiornato, seguire queste istruzioni.

Installare il modulo

Il modulo Resource Graph per PowerShell è Az.ResourceGraph.

  1. Da un prompt di PowerShell amministrativo eseguire i comandi seguenti:

    # Install the Resource Graph module from PowerShell Gallery
Install-Module -Name Az.ResourceGraph

  2. Verificare che il modulo sia stato importato e che sia almeno una versione 0.11.0:

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

Eseguire la prima query di Resource Graph

Con il modulo Azure PowerShell aggiunto all'ambiente preferito, è possibile provare una semplice query di Resource Graph basata su tenant. La query restituisce le prime cinque risorse di Azure con il nome e il tipo di risorsa di ogni risorsa. Per eseguire query in base al gruppo di gestione o alla sottoscrizione, usare i -ManagementGroup parametri o -Subscription .

  1. Eseguire la prima query di Azure Resource Graph usando il cmdlet 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'

    Nota

    Poiché questo esempio di query non prevede un modificatore del tipo di ordinamento, ad esempio order by, se si esegue questa query più volte, è probabile che venga restituito un set di risorse diverso per ogni richiesta.

  2. Aggiornare la query applicando order by alla proprietà Name:

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

    Nota

    Come nella prima query, se si esegue questa query più volte, è probabile che venga restituito un set di risorse diverso per ogni richiesta. L'ordine dei comandi della query è importante. In questo esempio order by segue limit. Questo ordine dei comandi prima limita i risultati della query e successivamente li ordina.

  3. Aggiornare la query applicando prima order by alla proprietà Name e quindi limit ai primi cinque risultati:

    # 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

Quando la query finale viene eseguita più volte, presupponendo che nulla nell'ambiente cambi, i risultati restituiti sono coerenti e ordinati in base alla proprietà Name , ma ancora limitati ai primi cinque risultati.

Nota

Se la query non restituisce risultati da una sottoscrizione a cui si ha già accesso, tenere presente che il cmdlet Search-AzGraph è impostato sulle sottoscrizioni nel contesto predefinito. Per visualizzare l'elenco di ID di sottoscrizione che fanno parte del contesto predefinito, eseguire (Get-AzContext).Account.ExtendedProperties.Subscriptions. Per eseguire la ricerca in tutte le sottoscrizioni a cui si ha accesso, è possibile impostare PSDefaultParameterValues per il cmdlet Search-AzGraph eseguendo $PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}

Pulire le risorse

Per rimuovere il modulo di Resource Graph dall'ambiente di Azure PowerShell, è possibile usare il comando seguente:

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

Nota

Questo comando non elimina il file del modulo scaricato in precedenza, ma lo rimuove semplicemente dalla sessione di PowerShell in esecuzione.

Passaggi successivi

In questo argomento di avvio rapido è stato aggiunto il modulo Resource Graph all'ambiente di Azure PowerShell ed è stata eseguita la prima query. Per altre informazioni sul linguaggio di Resource Graph, passare alla pagina dei dettagli del linguaggio di query.

Altre informazioni sul linguaggio di query