VSTS任务组Azure PowerShell脚本发布失败问题求助

你遇到的发布失败，核心原因是Azure PowerShell脚本的Param()块语法错误，混淆了VSTS的变量引用规则和PowerShell自身的参数定义规范：

1. 在PowerShell的参数声明中，你错误地使用了VSTS的变量引用语法$(变量名)，比如[String] $(apiManagementRg)。PowerShell会把$(apiManagementRg)当作参数名的一部分，但$()是PowerShell的子表达式运算符，这种写法完全不符合PowerShell参数的命名规则，直接触发了语法解析错误（报错里提到的“Missing ')' in function parameter list”就是这个原因）。
2. 另外，如果你的参数名包含减号（比如报错里的Container-Service），这也违反了PowerShell标识符规则——参数名必须是合法的变量名，不能包含减号、空格这类特殊字符。

1. 修正PowerShell脚本的参数声明 #

把Param()块里的VSTS变量引用写法，改成标准的PowerShell参数格式，参数名前加$，使用合法的标识符（比如驼峰命名或下划线）：

Param(
 [String] $apiManagementRg,
 [String] $apiManagementName,
 [String] $swaggerUrl,
 [String] $basePath,
 [String] $apiId
)

2. 修正脚本内的变量引用 #

脚本后续命令里的VSTS变量引用，也要改成PowerShell变量的写法（去掉外层的$()，直接用参数名）：

$ApiMgmtContext = New-AzureRmApiManagementContext -ResourceGroupName $apiManagementRg -ServiceName $apiManagementName
Import-AzureRmApiManagementApi -Context $ApiMgmtContext -SpecificationFormat "Swagger" -SpecificationUrl $swaggerUrl -Path $basePath -ApiId $apiId

3. 在VSTS任务组中传递参数 #

回到VSTS任务组的Azure PowerShell任务配置，在脚本参数输入框中，把VSTS变量传递给PowerShell脚本的参数，格式如下：

-apiManagementRg $(apiManagementRg) -apiManagementName $(apiManagementName) -swaggerUrl $(swaggerUrl) -basePath $(basePath) -apiId $(apiId)

这样VSTS就会把你配置的变量值，正确传递给PowerShell脚本的对应参数。

完成以上三步后，重新执行发布，应该就能解决这个语法错误导致的失败了。

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