教程：将输出添加到 ARM 模板

2025-10-15

本教程介绍如何从 Azure 资源管理器模板（ARM 模板）返回值。需要为部署的资源提供值时，可以使用输出。本教程需要 7 分钟 才能完成。

先决条件

建议完成有关变量的教程，但这不是必需的。

需要具有 Visual Studio Code，以及 Azure PowerShell 或 Azure Command-Line 接口（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",
        "Premium_LRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-09-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",
        "Premium_LRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-09-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 对象。

它使用引用函数获取存储帐户的运行时状态。若要获取资源的运行时状态，请传递资源的名称或 ID。在这种情况下，请使用用于创建存储帐户名称的同一变量。

最后，它从存储帐户返回 primaryEndpoints 属性。

部署模板

你已准备好部署模板并查看返回的值。

如果尚未创建资源组，请参阅 “创建资源组”。本示例假定已将 templateFile 变量设置为模板文件的路径，如第一个教程所示。

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.chinacloudapi.cn/",
    "web": "https://storeluktbfkpjjrkm.z19.web.core.chinacloudapi.cn/",
    "blob": "https://storeluktbfkpjjrkm.blob.core.chinacloudapi.cn/",
    "queue": "https://storeluktbfkpjjrkm.queue.core.chinacloudapi.cn/",
    "table": "https://storeluktbfkpjjrkm.table.core.chinacloudapi.cn/",
    "file": "https://storeluktbfkpjjrkm.file.core.chinacloudapi.cn/"
}

注释

如果部署失败，请使用 verbose 开关获取有关所创建资源的信息。使用 debug 开关获取调试的详细信息。