如何在PowerShell中配置ARM函数所需的订阅与资源组参数以复用Azure DevOps部署模板

这个问题的核心在于：Azure DevOps的ARM部署任务会自动为模板注入当前部署上下文的订阅和资源组信息，所以subscription()和resourceGroup()这些内置函数能正常工作；但在PowerShell中直接部署时，模板没有默认的上下文，需要我们手动提供这些值，同时还要保证模板在两种环境下都能复用。

下面是具体的解决方案，分为模板修改和PowerShell部署配置两部分：

1. 修改ARM模板，添加兼容双环境的可选参数 #

我们可以给模板添加两个可选参数，让它们默认使用ARM内置函数的值（适配Azure DevOps），同时支持手动传入值（适配PowerShell）。

步骤1：在模板的parameters段添加参数 #

"parameters": {
    // 保留你现有的参数（hostingPlanName、name、currentStack、sku、skuCode等）
    "subscriptionId": {
        "type": "string",
        "defaultValue": "[subscription().subscriptionId]",
        "metadata": {
            "description": "订阅ID，Azure DevOps中自动获取，PowerShell中需手动传入"
        }
    },
    "resourceGroupName": {
        "type": "string",
        "defaultValue": "[resourceGroup().name]",
        "metadata": {
            "description": "资源组名称，Azure DevOps中自动获取，PowerShell中需手动传入"
        }
    },
    "resourceGroupLocation": {
        "type": "string",
        "defaultValue": "[resourceGroup().location]",
        "metadata": {
            "description": "资源组所在区域，Azure DevOps中自动获取，PowerShell中可手动传入或通过资源组获取"
        }
    }
}

步骤2：替换模板中依赖上下文的表达式 #

把原来的resourceGroup().location和serverFarmId的表达式替换为使用参数：

"resources": [
    {
        "apiVersion": "2018-11-01",
        "name": "[parameters('name')]",
        "type": "Microsoft.Web/sites",
        "location": "[parameters('resourceGroupLocation')]", // 替换这里
        "tags": {},
        "dependsOn": [
            "[concat('Microsoft.Web/serverfarms/', parameters('hostingPlanName'))]"
        ],
        "properties": {
            "name": "[parameters('name')]",
            "siteConfig": {
                "metadata": [
                    {
                        "name": "CURRENT_STACK",
                        "value": "[parameters('currentStack')]"
                    }
                ]
            },
            // 替换serverFarmId的表达式
            "serverFarmId": "[concat('/subscriptions/', parameters('subscriptionId'), '/resourcegroups/', parameters('resourceGroupName'), '/providers/Microsoft.Web/serverfarms/', parameters('hostingPlanName'))]",
            "clientAffinityEnabled": true
        }
    },
    {
        "apiVersion": "2018-11-01",
        "name": "[parameters('hostingPlanName')]",
        "type": "Microsoft.Web/serverfarms",
        "location": "[parameters('resourceGroupLocation')]", // 替换这里
        "kind": "",
        "tags": {},
        "dependsOn": [],
        "properties": {
            "name": "[parameters('hostingPlanName')]"
        },
        "sku": {
            "Tier": "[parameters('sku')]",
            "Name": "[parameters('skuCode')]"
        }
    }
]

2. PowerShell中部署模板的配置 #

在PowerShell中，我们需要先获取或指定订阅和资源组信息，然后传递给模板：

步骤1：登录Azure并设置上下文 #

如果还未登录Azure，先执行：

# 登录Azure账号
Connect-AzAccount

# 切换到目标订阅（如果需要）
Set-AzContext -Subscription "你的订阅名称或ID"

步骤2：获取订阅和资源组信息 #

# 获取当前上下文的订阅ID
$currentContext = Get-AzContext
$subscriptionId = $currentContext.Subscription.Id

# 指定目标资源组名称（如果是新建资源组，需要先创建；如果是现有资源组，也可以用Get-AzResourceGroup获取）
$resourceGroupName = "你的目标资源组名称"

# 获取资源组的区域（如果需要）
$resourceGroupLocation = (Get-AzResourceGroup -Name $resourceGroupName).Location

步骤3：部署ARM模板 #

使用New-AzResourceGroupDeployment命令部署，传递参数：

New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName `
    -TemplateFile "你的模板文件路径（比如./template.json）" `
    -subscriptionId $subscriptionId `
    -resourceGroupName $resourceGroupName `
    -resourceGroupLocation $resourceGroupLocation `
    # 传递其他必要参数，比如-hostingPlanName "你的托管计划名称" -name "你的网站名称"等

为什么这个方案可行？ #

• 在Azure DevOps的ARM部署任务中，我们不需要传递subscriptionId、resourceGroupName这些参数，模板会自动使用默认值（调用subscription()和resourceGroup()内置函数），和之前的行为完全一致。
• 在PowerShell中，我们手动传入这些参数，覆盖默认值，模板就能正确拼接出资源ID路径，解决无法获取上下文的问题。

额外小贴士 #

• 如果是自动化的PowerShell脚本，可以通过环境变量读取订阅和资源组信息（比如CI/CD环境中的变量），不需要手动输入。
• 确保你的PowerShell环境安装了最新版的Az模块：Install-Module -Name Az -AllowClobber -Scope CurrentUser

内容的提问来源于stack exchange，提问作者PedroC88