TeamCity中PowerShell脚本预定义参数未生效问题咨询

我之前也踩过这个坑！问题出在TeamCity的参数替换逻辑上：它不会自动解析你本地.ps1脚本里的%teamcity.predefined.parameter%标记——因为这些脚本是直接在构建Agent上执行的，TeamCity的参数替换只在它自身的构建配置层面（比如步骤命令、参数定义）生效，不会主动去扫描修改你的本地脚本内容。

下面给你几个可行的解决思路：

方法1：用环境变量传递参数（最推荐） #

TeamCity会把所有预定义参数和标记为“环境变量”的自定义参数注入到Agent的环境变量中，你可以直接在PowerShell脚本里引用这些环境变量：

1. 确认TeamCity预定义参数对应的环境变量名：比如teamcity.build.number会变成TEAMCITY_BUILD_NUMBER（全大写，点号转下划线）
2. 修改你的variables.ps1脚本，把%teamcity.predefined.parameter%替换为PowerShell的环境变量引用：

   $variable1="path/to/source"
   $variable2="path/to/source/$env:TEAMCITY_BUILD_NUMBER.pro"
   $variableN="..."
   

3. 如果是自定义参数，需要在TeamCity构建配置的Parameters页面里，把参数的Kind设置为Environment variable，这样Agent才能读取到。

方法2：让TeamCity先预处理你的脚本 #

通过TeamCity的构建步骤先替换脚本里的参数标记，再执行处理后的脚本：

1. 添加一个Command Line类型的构建步骤，放在执行variables.ps1的步骤之前
2. 输入以下PowerShell命令（替换成你的实际参数和脚本路径）：

   (Get-Content .\variables.ps1) -replace '%teamcity.predefined.parameter%', '%teamcity.predefined.parameter%' | Set-Content .\variables-processed.ps1
   

   这里的第二个%teamcity.predefined.parameter%会被TeamCity自动替换为实际值，然后写入新的脚本文件
3. 后续构建步骤改为执行variables-processed.ps1

方法3：在TeamCity里直接定义PowerShell变量 #

跳过本地脚本的硬编码，直接在TeamCity的构建步骤里设置变量：

1. 在TeamCity的构建步骤中，选择PowerShell类型
2. 在脚本内容里直接引用TeamCity参数：

   $variable1="path/to/source"
   $variable2="path/to/source/%teamcity.predefined.parameter%.pro"
   $variableN="..."
   

   这种情况下TeamCity会先解析%teamcity.predefined.parameter%，再把完整的脚本内容传给PowerShell执行

内容的提问来源于stack exchange，提问作者Alexey.Ozerov