如何在Active Batch作业中通过PowerShell脚本使用Active变量？

1. 基础读取：环境变量法（最常用，无额外依赖） #

Active Batch默认会把所有开启了「暴露到执行环境」配置的变量（包括系统内置变量、作业级变量、步骤级变量），在PowerShell脚本启动时自动注入到进程环境变量中，直接用PowerShell原生的$env:语法就能读取，不需要加载任何额外组件。
示例：如果你在作业里定义了名为Source_File_Path的Active变量，脚本里直接读取即可：

# 读取Active Batch传入的源文件路径变量
$sourcePath = $env:Source_File_Path
Write-Host "读取到的源路径：$sourcePath"

注意事项：

• 如果你的变量名包含空格、横杠等特殊字符（比如Input Dir、User-Id），注入环境变量时特殊字符会被自动替换为下划线，对应读取时要写成$env:Input_Dir、$env:User_Id
• 拿不准变量名的话，先跑Get-ChildItem Env:列全当前进程所有环境变量，匹配对应名称即可

2. 进阶操作：COM对象法（支持动态读、写变量） #

如果需要在脚本运行中动态更新变量值给后续步骤用，或者读取其他作用域的实时变量值，就用Active Batch自带的COM对象操作，不需要走环境变量的静态注入：

# 加载当前作业的上下文对象
$abJob = New-Object -ComObject ActiveBatch.Job

# 读取指定Active变量的实时值
$processStatus = $abJob.Variables.Item("Process_Status").Value
Write-Host "当前流程状态：$processStatus"

# 修改Active变量值，修改后后续作业步骤能直接读到更新后的值
$abJob.Variables.Item("Process_Status").Value = "Running"

# 也可以临时新增作业级变量供后续步骤调用
$abJob.Variables.Add("Script_Run_Time", (Get-Date -ToString "yyyy-MM-dd HH:mm:ss"))

常见踩坑说明 #

• 回写变量前一定要在Active Batch控制台给对应变量开启「允许作业步骤修改」权限，否则脚本运行时会抛出权限拒绝错误
• 环境变量方式只能拿到脚本启动瞬间的变量快照，脚本运行过程中其他步骤改的变量不会同步到当前进程的环境变量里，需要实时取值的场景必须用COM对象方式
• 不要手动把Active变量拼接到PowerShell的启动参数字符串里传值，遇到特殊字符很容易出现转义错误、脚本注入问题，优先用上面两种原生方式
• 调试阶段可以先在测试步骤里跑下面的脚本，把所有Active Batch相关的环境变量打出来确认，减少排错成本：

# 调试用：列出所有AB相关注入变量
Get-ChildItem Env: | Where-Object Name -like "AB*" | Format-Table Name,Value -AutoSize

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