DevOps流水线创建Firewall规则参数无法识别问题咨询

根因定位 #

• 自定义函数名New-AzSqlServerFirewallRule与Azure Az.Sql模块提供的官方命令完全重名，导致函数内部调用时触发递归，没有真正执行官方命令
• 自定义的New-AzSqlServerFirewallRule函数未声明ResourceGroupName、FirewallRuleName等入参，调用时传入这些参数会直接触发参数不匹配报错，和参数顺序无关
• 你查询到的命令迭代信息是正确的：旧AzureRM模块的New-AzureSqlDatabaseServerFirewallRule已淘汰，Az模块对应的正确命令确实是New-AzSqlServerFirewallRule，命令本身无问题

修复方案 #

1. 修改自定义函数名，避免覆盖官方命令，同时给自定义函数补全入参声明
2. 提前校验Az.Sql模块加载状态，避免环境依赖缺失
3. 修正后的可运行代码如下：

# 预加载Az.Sql模块，确认环境依赖正常
Import-Module Az.Sql -MinimumVersion 3.0.0 -ErrorAction Stop

# 重命名自定义函数，避免和官方命令冲突
function Add-DevOpsAgentIPToSqlFirewall {
  param(
    [Parameter(Mandatory = $true)]
    [string]$ResourceGroupName,
    [Parameter(Mandatory = $true)]
    [string]$ServerName,
    [Parameter(Mandatory = $true)]
    [string]$AzureFirewallName
  )
  # 获取代理公网IP并去除首尾空格
  $agentIP = (New-Object net.webclient).DownloadString("https://api.ipify.org").Trim()
  # 调用官方命令创建防火墙规则
  New-AzSqlServerFirewallRule -ResourceGroupName $ResourceGroupName -ServerName $ServerName -FirewallRuleName $AzureFirewallName -StartIPAddress $agentIP -EndIPAddress $agentIP
}

# 调用自定义函数，传入对应变量即可
Add-DevOpsAgentIPToSqlFirewall -ResourceGroupName $ResourceGroupName -ServerName $ServerName -AzureFirewallName $AzureFirewallName

额外排查点 #

• 若修改后仍报错，可在脚本中增加调试命令Get-Command New-AzSqlServerFirewallRule，确认输出的CommandType为Cmdlet、来源为Az.Sql，若显示为Function说明仍存在重名覆盖问题
• 确认$AzureFirewallName符合命名规则：仅支持字母、数字、连字符，不能以连字符开头/结尾，长度不超过128位
• 确保执行脚本前已完成Azure鉴权，DevOps场景下直接使用官方Azure PowerShell任务即可自动完成鉴权，无需手动写登录逻辑

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