如何将PowerShell GUI输入值传入Azure DevOps构建管道运行时变量？

问题描述 #

已编写PowerShell脚本通过Azure DevOps REST API触发构建管道，支持传递运行时变量控制任务执行。使用System.Windows.Forms制作简易GUI后，文本框输入的变量值无法传入管道，管道内所有变量均显示为undefined，尝试合并脚本等方法未解决问题。

原脚本问题分析 #

1. JSON结构错误：触发脚本中resources.repositories.self被写成字符串形式的哈希表，而非直接使用哈希表，导致JSON序列化后结构异常。
2. 变量传递逻辑失效：GUI脚本尝试用字符串替换方式给触发脚本变量赋值，但触发脚本的变量嵌套在$body哈希表中，并非独立PowerShell变量，替换操作无法修改目标值。
3. Invoke-Expression误用：拼接脚本内容再执行的方式不仅不安全，还易因字符串转义问题导致变量值传递失败。

修复后的完整脚本 #

将GUI与触发逻辑整合，直接使用GUI收集的变量构建请求体：

Add-Type -AssemblyName System.Windows.Forms

# 定义表单
$form = New-Object System.Windows.Forms.Form
$form.Text = "Azure DevOps构建触发器"
$form.Width = 400
$form.Height = 500
$form.StartPosition = "CenterScreen"

# 存储变量的哈希表
$variables = @{
    'variable1' = ''
    'variable2' = ''
    'variable3' = ''
    'variable4' = ''
    'variable5' = ''
    'variable6' = ''
    'variable7' = ''
    'variable8' = ''
    'variable9' = ''
    'variable10' = ''
    'variable11' = ''
    'variable12' = ''
    'variable13' = ''
}

# 创建变量输入控件的函数
function CreateVariableControl($labelText, $top) {
    $label = New-Object System.Windows.Forms.Label
    $label.Text = $labelText
    $label.Location = New-Object System.Drawing.Point(10, $top)
    $label.AutoSize = $true

    $textBox = New-Object System.Windows.Forms.TextBox
    $textBox.Location = New-Object System.Drawing.Point(150, $top)
    $textBox.Size = New-Object System.Drawing.Size(200, 20)

    $form.Controls.Add($label)
    $form.Controls.Add($textBox)

    # 文本框内容变更时更新变量值
    $currentVarName = $labelText
    $textBox.Add_TextChanged({
        $script:variables[$currentVarName] = $this.Text
    })
}

# 添加所有变量输入控件
$top = 30
foreach ($varName in $variables.Keys) {
    CreateVariableControl $varName $top
    $top += 30
}

# 触发按钮点击事件
$buttonRun = New-Object System.Windows.Forms.Button
$buttonRun.Text = "触发构建"
$buttonRun.Location = New-Object System.Drawing.Point(150, $top + 30)
$buttonRun.Add_Click({
    # 构建请求头
    $headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
    $headers.Add("Content-Type", "application/json")
    $headers.Add("Authorization", "Basic [替换为你的PAT]")

    # 构建请求体，直接使用GUI收集的变量
    $bodyVariables = @{}
    foreach ($varName in $variables.Keys) {
        $bodyVariables[$varName] = @{ value = $variables[$varName] }
    }

    $body = @{
        stagesToSkip = @()
        resources = @{
            repositories = @{
                "self" = @{ refName = 'refs/heads/master' }
            }
        }
        templateParameters = @{}
        variables = $bodyVariables
    } | ConvertTo-Json -Depth 10  # 增加Depth确保嵌套结构序列化完整

    try {
        $response = Invoke-RestMethod `
            -Uri 'https://dev.azure.com/[你的组织]/[你的项目]/_apis/pipelines/[管道ID]/runs?api-version=7.0' `
            -Method 'POST' `
            -Headers $headers `
            -Body $body
        [System.Windows.Forms.MessageBox]::Show("构建触发成功！运行ID：$($response.id)", "成功", [System.Windows.Forms.MessageBoxButtons]::OK, [System.Windows.Forms.MessageBoxIcon]::Information)
    } catch {
        [System.Windows.Forms.MessageBox]::Show("触发失败：$($_.Exception.Message)", "错误", [System.Windows.Forms.MessageBoxButtons]::OK, [System.Windows.Forms.MessageBoxIcon]::Error)
    }
})

$form.Controls.Add($buttonRun)
$form.ShowDialog()

关键修复点 #

• 修正JSON序列化：将resources.repositories.self改为直接使用哈希表，添加-Depth 10确保嵌套结构完整序列化。
• 直接传递变量值：在按钮点击事件中，用GUI收集的变量直接构建请求体的variables部分，避免字符串替换的不可靠性。
• 移除Invoke-Expression：将触发逻辑整合到GUI点击事件中，简化流程同时避免脚本注入风险。
• 添加用户反馈：增加消息框提示构建触发结果，提升用户体验。

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