教學指南：將輸出新增至 Azure Resource Manager 範本

在本教學課程中，您將瞭解如何從 Azure Resource Manager 範本（ARM 範本）傳回值。當您需要為部署的資源獲取值時，可以使用輸出結果。本教學課程需要 7 分鐘 才能完成。

先決條件

建議您完成變數的教學課程，但這不是必要條件。

您必須有 Visual Studio Code 和 Azure PowerShell 或 Azure CLI。如需詳細資訊，請參閱範本工具。

審查模板

在上一個教學課程的結尾，您的範本具有下列 JSON：

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

它會部署儲存體帳戶，但不會傳回任何相關資訊。您可能需要從新資源擷取屬性，以便稍後可供參考。

新增輸出

您可以使用輸出從範本傳回值。例如，可能有助於取得新儲存體帳戶的端點。

以下範例顯示對範本的變更，以便新增輸出值。將整個檔案複製，並以其內容替換您的範本：

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

關於您添加的輸出值，有一些重要項目需要注意。

傳回值的類型會設定為 object，這表示它會傳回 JSON 物件。

它會使用參考函式來取得儲存體帳戶的執行階段狀態。若要取得資源的執行階段狀態，請傳遞資源的名稱或識別碼。在此情況下，您會使用用來建立儲存體帳戶名稱的相同變數。

最後，它會從儲存體帳戶傳回 primaryEndpoints 屬性。

部署範本

您已準備好部署範本並查看傳回值。

如果您尚未建立資源群組，請參閱建立資源群組。此範例假設您已將變數設定 templateFile 為範本檔案的路徑，如第一個教學課程所示。

Azure PowerShell
Azure CLI

New-AzResourceGroupDeployment `
  -Name addoutputs `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storagePrefix "store" `
  -storageSKU Standard_LRS

若要執行此部署命令，您必須擁有最新版本的 Azure CLI。

az deployment group create \
  --name addoutputs \
  --resource-group myResourceGroup \
  --template-file $templateFile \
  --parameters storagePrefix=store storageSKU=Standard_LRS

在部署命令的輸出中，只有在輸出為 JSON 格式時，您才會看到類似下列範例的物件：

{
    "dfs": "https://storeluktbfkpjjrkm.dfs.core.windows.net/",
    "web": "https://storeluktbfkpjjrkm.z19.web.core.windows.net/",
    "blob": "https://storeluktbfkpjjrkm.blob.core.windows.net/",
    "queue": "https://storeluktbfkpjjrkm.queue.core.windows.net/",
    "table": "https://storeluktbfkpjjrkm.table.core.windows.net/",
    "file": "https://storeluktbfkpjjrkm.file.core.windows.net/"
}

備註

如果部署失敗，請使用 verbose 交換器來取得所建立資源的相關資訊。使用 debug 參數取得更多資訊，以進行偵錯。