使用 Azure CLI 部署 Microsoft Web IQ

以下步驟請登入 Azure，註冊 Web IQ 資源提供者，建立帳號，取得資源 ID 並檢查帳單費用。所有指令都用 PowerShell 執行，因為請求主體是以 PowerShell 物件建置並轉換成 JSON。在執行之前，先把訂閱 ID、資源群組和帳號的預留位置值換成你自己的。

若要從瀏覽器部署 Web IQ，請參見「使用 Azure 入口網站部署 Microsoft Web IQ」。

Prerequisites

您可以在 Azure 訂閱中建立資源。 Web IQ 需要付費 Azure 訂用帳戶。 Azure 點數無法用於 Web IQ。
Azure CLI 和 PowerShell。

建立一個 Web IQ 帳號

這個步驟會讓你登入 Azure，選擇要建立帳戶的訂閱，然後註冊 Microsoft.WebIQ 資源提供者。註冊提供者後，Web IQ 資源類型即可在您的訂閱中使用，且每個訂閱只需完成一次即可。註冊指令會等到提供者完全註冊後才返回。

az login

$subscriptionId = "<subscription-id>"
$resourceGroup = "<resource-group>"
$accountName = "<globally-unique-account-name>"
$apiVersion = "2026-06-01-preview"

az account set --subscription $subscriptionId
az provider register --namespace Microsoft.WebIQ --wait

然後，帳號會根據建構為 PowerShell 物件並轉換為 JSON 的定義來建立。指令會將此 JSON 作為完整的資源定義傳遞。在此範例中，帳號使用全域位置、WebIQ.Grounding 類型及 G3 SKU，並將 statisticsEnabled 設為 false。 API 版本標示了用於部署的 Microsoft.WebIQ 修訂版本，因此後續指令也使用相同的值。

$account = @{
  location = "global"
  kind = "WebIQ.Grounding"
  sku = @{
    name = "G3"
  }
  properties = @{
    statisticsEnabled = $false
  }
} | ConvertTo-Json -Depth 10 -Compress

az resource create `
  --resource-group $resourceGroup `
  --name $accountName `
  --resource-type "Microsoft.WebIQ/accounts" `
  --api-version $apiVersion `
  --is-full-object `
  --properties $account

取得資源識別碼

帳號建立後，取回其資源 ID。資源 ID 是帳戶在 Azure 中的唯一路徑，你可以用它在後續操作中參考該帳戶，包括下一節的成本查詢。此指令以帳號名稱查找，並只回傳其 ID 值。

$resourceId = az resource show `
  --resource-group $resourceGroup `
  --name $accountName `
  --resource-type "Microsoft.WebIQ/accounts" `
  --api-version $apiVersion `
  --query id `
  --output tsv

$resourceId

檢查 Azure 計費成本

此步驟會檢查帳戶花了多少成本。它建立一個涵蓋過去 30 天的日期範圍，然後使用 PreTaxCost 指標，並依前一節的資源 ID 進行篩選，以請求每日成本。

請求會送交給 Azure 成本管理。由於此呼叫針對成本管理而非 Web IQ 提供者，因此使用自己的 API 版本，與建立帳號時使用的版本不同。費用資料在帳戶剛建立後可能需要一段時間才會出現，因此新帳戶在當前期間可能顯示成本很低或沒有。

$from = (Get-Date).AddDays(-30).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
$to = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")

$query = @{
  type = "ActualCost"
  timeframe = "Custom"
  timePeriod = @{
    from = $from
    to = $to
  }
  dataset = @{
    granularity = "Daily"
    aggregation = @{
      totalCost = @{
        name = "PreTaxCost"
        function = "Sum"
      }
    }
    filter = @{
      dimensions = @{
        name = "ResourceId"
        operator = "In"
        values = @($resourceId)
      }
    }
  }
} | ConvertTo-Json -Depth 10 -Compress

az rest `
  --method post `
  --url "https://management.azure.com/subscriptions/${subscriptionId}/providers/Microsoft.CostManagement/query?api-version=2025-03-01" `
  --body $query `
  --output json

Troubleshooting

本節列出你在建立 Web IQ 帳號時可能遇到的常見錯誤，以及如何解決這些錯誤。如果指令失敗，請閱讀 Azure CLI 回傳的完整錯誤文字，因為它通常會列出確切原因和應採取的行動。

您的訂閱未啟用 Web IQ

在部署資源之前，必須先為您的 Azure 訂閱啟用 Web IQ。如果沒有，帳號建立會失敗，錯誤訊息顯示該功能未針對所選訂閱啟用。

若要解決此問題，請聯絡你的 Microsoft 帳戶代表或業務主管申請存取權限。一旦你的訂閱啟用，請再次執行帳號建立指令。

API 版本無效

API 版本值必須是 Microsoft.WebIQ 提供者支援的修訂版本。本指南使用 2026-06-01-preview。如果你傳入供應商不支援的版本，指令就會失敗，Azure 通常會在錯誤訊息中列出支援的版本。要查看供應商支援哪些版本，請執行：

az provider show --namespace Microsoft.WebIQ --query "resourceTypes[?resourceType=='accounts'].apiVersions" --output tsv

使用指令回傳的版本之一（本指南為 2026-06-01-preview），並在每個 Web IQ 指令中使用相同的值，使請求與回應相符。

部署之後

部署完成後，註冊或登入 Web IQ 入口網站，連結你的資源 ID，並建立 API 金鑰。新的 Web IQ 資源預設速率限制為每秒 15 次查詢（QPS）;你目前的限制會顯示在 Web IQ 入口網站。您使用 Web IQ 須遵守 Web IQ 使用條款。請在開始前先審閱這些內容。

意見反應

此頁面對您有幫助嗎？

上次更新時間： 2026-10-16