Azure PowerShell部署ADF管道时pipelineReturnValue活动配置异常修复咨询

问题场景 #

使用Azure PowerShell命令Set-AzDataFactoryV2Pipeline部署ADF管道时，SetVariable活动的value字段原本定义为数组结构，但部署后被自动转为转义的JSON字符串，导致活动逻辑不符合预期。

原因分析 #

1. 错误使用setSystemVariable属性：该属性仅用于设置ADF系统变量（如PipelineName、RunId），针对自定义变量设置此属性时，会触发ADF内部序列化异常，将数组转为字符串。
2. PowerShell对JSON文件的自动序列化处理：-DefinitionFile参数读取JSON文件时，可能会将数组这类复杂类型二次序列化为字符串，导致结构失真。

修复方案 #

方案1：移除无效的setSystemVariable属性 #

直接修改管道JSON定义，删除setSystemVariable: true配置（自定义变量不需要此属性）：

修正后的SetVariable活动typeProperties片段：

"typeProperties": {
    "variableName": "pipelineReturnValue",
    "value": [
        {
            "key": "strCommaSeparatedString",
            "value": {
                "type": "Expression",
                "content": "@activity('Process API data').output.Holiday"
            }
        }
    ]
}

修改后重新执行原部署命令即可。

方案2：手动转换JSON为PowerShell对象后部署 #

绕过-DefinitionFile的自动序列化逻辑，手动读取JSON内容并转为PowerShell对象再传递：

# 读取JSON文件并转换为PSObject
$pipelineDefinition = Get-Content ./PL_PROCESS_API.json -Raw | ConvertFrom-Json
# 部署管道
Set-AzDataFactoryV2Pipeline -Force -ResourceGroupName MY_DEV_RESOURCE_GRP -DataFactoryName MYADF001 -Name PL_PROCESS_API -Definition $pipelineDefinition

这种方式确保数组结构原样传递到ADF，避免序列化失真。

方案3：验证目标变量类型 #

确认ADF中pipelineReturnValue变量的类型为Array：

• 进入ADF管道编辑界面，打开变量配置面板
• 检查pipelineReturnValue的类型，若为String则修改为Array
• 重新部署管道

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