New-AzResourceGroupDeployment使用Tag参数报错找不到参数如何解决

报错原因 #

本地安装的Az.Resources PowerShell模块版本过低，-Tag参数是在Az.Resources v3.0.0及以上版本才新增到New-AzResourceGroupDeployment命令中的，低于该版本的命令不支持该参数。

排查步骤 #

• 执行以下命令查看本地已安装的Az.Resources模块版本：

Get-Module Az.Resources -ListAvailable

如果输出的版本号低于3.0.0，即可确认是版本不兼容导致的报错。

解决方法 #

方案1：升级Az PowerShell模块

以管理员身份运行PowerShell，执行以下命令升级到最新版本：

Update-Module -Name Az -Force

升级完成后重启PowerShell，即可正常使用-Tag参数执行原命令。

方案2：无需升级模块的替代方案

如果暂时不方便升级模块，可通过以下方式实现打标签需求：

• 在ARM模板中定义标签参数，将标签值作为模板参数传入，直接给模板部署的资源打标签
• 部署完成后单独调用New-AzTag命令给部署对象添加标签，示例命令：

New-AzTag -ResourceId /subscriptions/替换为你的订阅ID/resourceGroups/demo/providers/Microsoft.Resources/deployments/替换为你的部署名称 -Tag @{"CreatedFrom"="PS"; "Env"="Dev"}

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