部署链接式ARM模板时，parametersLink能否使用relativePath？

核心结论 #

parametersLink不支持relativePath语法，这是VS Code报错“Missing required property "uri"”的根本原因。ARM模板的schema明确要求parametersLink必须包含uri属性，而relativePath仅为templateLink在本地部署场景下的兼容扩展语法，官方文档未提及parametersLink支持该属性，因此无法直接使用。

本地PowerShell部署的可行方案 #

由于所有文件都在本地目录，可通过以下方式解决：

方案1：构建本地参数文件的绝对URI #

在PowerShell中获取当前目录的绝对路径，拼接成file://格式的URI传入主模板，再生成完整的参数文件路径：

1. 主模板新增参数接收本地根路径：

"parameters": {
    "env": { "type": "String" },
    "localRootUri": { "type": "String" }
}

2. 修改parametersLink使用完整uri：

"parametersLink": {
    "uri": "[concat(parameters('localRootUri'), 'linked/storage/linkedtemplate_idbridge_base_storage.parameters-', parameters('env'), '.json')]"
}

3. PowerShell部署时传递localRootUri参数：

$localRoot = "file:///$($PWD.Path.Replace('\', '/'))/"
New-AzResourceGroupDeployment -ResourceGroupName <你的资源组名> -TemplateFile .\mainTemplate.json -env dev -localRootUri $localRoot

方案2：直接内联参数内容（适用于简单场景） #

如果参数文件内容不多，可直接把参数值写进主模板的parameters属性，替代parametersLink：

"parameters": {
    "storageAccountName": "[concat('sa', parameters('env'), '001')]"
    // 其他参数按需求添加
}

修改后的主模板示例（方案1） #

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "env": { "type": "String" },
        "localRootUri": { "type": "String" }
    },
    "resources": [
        {
            "type": "Microsoft.Resources/deployments",
            "apiVersion": "2022-09-01",
            "name": "storage",
            "properties": {
                "mode": "Incremental",
                "templateLink": {
                    "relativePath": "linked/storage/linkedtemplate_idbridge_base_storage.json"
                },
                "parametersLink": {
                    "uri": "[concat(parameters('localRootUri'), 'linked/storage/linkedtemplate_idbridge_base_storage.parameters-', parameters('env'), '.json')]"
                }
            }
        },
        {
            "type": "Microsoft.Resources/deployments",
            "apiVersion": "2022-09-01",
            "name": "monitoring",
            "properties": {
                "mode": "Incremental",
                "templateLink": {
                    "relativePath": "linked/monitoring/linkedtemplate_idbridge_base_monitoring.json"
                },
                "parametersLink": {
                    "uri": "[concat(parameters('localRootUri'), 'linked/monitoring/linkedtemplate_idbridge_base_monitoring.parameters-', parameters('env'), '.json')]"
                }
            }
        },
        {
            "type": "Microsoft.Resources/deployments",
            "apiVersion": "2022-09-01",
            "name": "notification",
            "properties": {
                "mode": "Incremental",
                "templateLink": {
                    "relativePath": "linked/notification/linkedtemplate_idbridge_base_notification.json"
                },
                "parametersLink": {
                    "uri": "[concat(parameters('localRootUri'), 'linked/notification/linkedtemplate_idbridge_base_notification.parameters-', parameters('env'), '.json')]"
                }
            }
        }
    ]
}

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