如何为Bicep模块传递TemplateParameterFile参数文件？

你遇到的问题核心是：-TemplateParameterFile参数仅作用于根部署模板（这里是Main.bicep），无法直接为子模块指定独立的参数文件。你之前的命令报错，是因为PowerShell把模块的参数文件当成了根模板的参数输入，但根模板并没有定义这些参数，导致编译失败。

以下是两种可行的解决方法：

方法一：将模块参数提升为根模板参数，通过根参数文件传递 #

1. 修改根模板Main.bicep，把模块需要的参数定义为根模板的顶层参数，再传递给子模块：

targetScope = 'subscription'

// 定义与子模块匹配的根参数
param AutomationAccountName string
param AzureADTenant string
param AzureBastionSubnetAddressSpace string
param BastionIPName string

resource rg 'Microsoft.Resources/resourceGroups@2021-01-01' = {
  name: 'rg-test1234'
  location: 'westus2'
}

module initial './InitialDeployment_template.bicep' = {
  name: 'initialDeployment'
  scope: rg
  params: {
    AutomationAccountName: AutomationAccountName
    AzureADTenant: AzureADTenant
    AzureBastionSubnetAddressSpace: AzureBastionSubnetAddressSpace
    BastionIPName: BastionIPName
  }
}

2. 调整参数文件结构，使其对应根模板的参数（将原InitialDeployment_parameters.json修改为根模板参数格式）：

{
  "$schema": "https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "AutomationAccountName": { "value": "your-automation-account-name" },
    "AzureADTenant": { "value": "your-tenant-id" },
    "AzureBastionSubnetAddressSpace": { "value": "10.0.1.0/24" },
    "BastionIPName": { "value": "your-bastion-public-ip-name" }
  }
}

3. 执行原PowerShell命令即可，此时参数文件会将值传递给根模板，再由根模板转发给子模块：

New-AzSubscriptionDeployment `
  -Name demoSubDeployment `
  -TemplateFile Main.bicep `
  -TemplateParameterFile .\InitialDeployment_parameters.json -Location westus2 -WhatIf

方法二：在Bicep中直接加载参数文件（编译时读取） #

利用Bicep的loadJsonContent函数，在编译阶段直接读取模块参数文件的内容，再映射给子模块：

targetScope = 'subscription'

// 加载模块参数文件内容
var initialModuleParams = loadJsonContent('./InitialDeployment_parameters.json').parameters

resource rg 'Microsoft.Resources/resourceGroups@2021-01-01' = {
  name: 'rg-test1234'
  location: 'westus2'
}

module initial './InitialDeployment_template.bicep' = {
  name: 'initialDeployment'
  scope: rg
  params: {
    AutomationAccountName: initialModuleParams.AutomationAccountName.value
    AzureADTenant: initialModuleParams.AzureADTenant.value
    AzureBastionSubnetAddressSpace: initialModuleParams.AzureBastionSubnetAddressSpace.value
    BastionIPName: initialModuleParams.BastionIPName.value
  }
}

部署时无需指定-TemplateParameterFile，直接运行：

New-AzSubscriptionDeployment `
  -Name demoSubDeployment `
  -TemplateFile Main.bicep `
  -Location westus2 -WhatIf

注意：此方法要求参数文件与Main.bicep路径正确关联，且编译时文件可访问；若参数包含敏感信息，需谨慎使用，因为编译后的ARM模板会明文包含参数值。

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