快速入門：使用 Azure CLI 執行 Resource Graph 查詢

本快速入門說明如何使用 Azure CLI 的擴充功能來執行 Azure Resource Graph 查詢。 本文也會示範如何排序（排序）並限制查詢的結果。 您可以針對租使用者、管理群組或訂用帳戶中的資源執行查詢。 完成時，您可以移除延伸模組。

必要條件

• 如果您沒有 Azure 帳戶，請在您開始之前先建立 免費帳戶。
• Azure CLI 必須是 Resource Graph 延伸模組的 2.22.0 版或更高版本。
• Visual Studio Code \(英文\)。

連接到 Azure

從 Visual Studio Code 終端機工作階段中連線到 Azure。 如果您有多個訂用帳戶，請執行命令來設定您訂用帳戶的內容。 使用您的 Azure 訂用帳戶識別碼來取代 <subscriptionID> 。

az login

# Run these commands if you have multiple subscriptions
az account list --output table
az account set --subscription <subscriptionID>

安裝 延伸模組

若要讓 Azure CLI 使用 Azure Resource Graph 查詢資源，必須安裝 Resource Graph 擴充功能。 您可以使用下列步驟手動安裝擴充功能。 否則，第一次執行查詢 az graph 時，系統會提示您安裝擴充功能。

1. 列出可用的擴充功能和版本：

   az extension list-available --output table
   

2. 安裝擴充功能：

   az extension add --name resource-graph
   

3. 確認已安裝擴充功能：

   az extension list --output table
   

4. 顯示延伸模組的語法：

   az graph query --help
   

   如需 Azure CLI 擴充功能的詳細資訊，請移至 使用和管理 Azure CLI 的擴充功能。

執行查詢

將 Azure CLI 擴充功能新增至您的環境之後，您可以執行租使用者型查詢。 此範例中的查詢會傳回五個具有 name 和 type 每個資源的 Azure 資源。 若要依 管理群組 或訂用帳戶查詢，請使用 --management-groups 或 --subscriptions 自變數。

1. 執行 Azure Resource Graph 查詢：

   az graph query --graph-query 'Resources | project name, type | limit 5'
   

   此查詢範例不會使用像是的 order by排序修飾詞。 如果您多次執行查詢，可能會為每個要求產生一組不同的資源。

2. 將查詢更新為 order byname 屬性：

   az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
   

   如同先前的查詢，如果您多次執行此查詢，則可能會為每個要求產生一組不同的資源。 查詢命令的順序很重要。 在此範例中，order by 會出現在 limit 之後。 查詢會將結果限製為五個資源，然後依名稱排序這些結果。

3. 將查詢更新為 order byname 屬性，然後將 limit 輸出更新為五個結果：

   az graph query --graph-query 'Resources | project name, type | order by name asc | limit 5'
   

   如果此查詢執行數次，且您的環境沒有任何變更，則結果會一致且依 name 屬性排序，但仍限製為五個結果。 查詢會依名稱排序結果，然後將輸出限制為五個資源。

清除資源

若要移除 Resource Graph 延伸模組，請執行下列命令：

az extension remove --name resource-graph

若要登出您的 Azure CLI 工作階段：

az logout

下一步

在本快速入門中，您已使用 Azure CLI 的擴充功能來執行 Azure Resource Graph 查詢。 若要深入瞭解，請移至查詢語言詳細數據一文。

了解 Azure Resource Graph 查詢語言