如何在PowerShell中将请求Body分离到YAML文件并传递参数？

没问题，咱们一步步来实现把硬编码的$body分离到YAML文件里，这样配置和代码分开，维护起来更方便：

1. 创建独立的YAML配置文件 #

首先，把你原来的JSON格式$body转换成更易读的YAML格式，创建一个比如TaskWindowsConfig.yaml的文件，内容如下：

type: taskWindows
actions:
  abortActions: []
  emailNotifications: []
  setVariableActions: []
  snmpNotifications: []
  systemOperations: []
agent: test
name: Test Create
summary: Test Create

YAML语法更简洁，没有多余的引号和括号，后续修改配置会轻松很多。

2. 安装YAML解析模块（PowerShell默认不自带） #

PowerShell本身没有内置YAML解析功能，所以我们需要安装powershell-yaml模块来读取和转换YAML文件。打开PowerShell（建议以管理员身份运行），执行以下命令：

Install-Module -Name powershell-yaml -Scope CurrentUser -Force

如果你的环境禁止在线安装模块，也可以手动下载模块文件放到PowerShell的模块目录中，不过上面的命令是最便捷的方式。

3. 修改调用逻辑：读取YAML并转换为JSON #

因为Stonebranch.Create.Task.Windows函数需要JSON格式的-Body参数，所以我们要把YAML文件读取后转换成符合要求的JSON字符串。更新你的调用代码如下：

# 1. 读取YAML配置文件内容
$yamlContent = Get-Content -Path "C:\Path\To\TaskWindowsConfig.yaml" -Raw
# 2. 将YAML转换为PowerShell对象
$taskConfig = ConvertFrom-Yaml -Yaml $yamlContent
# 3. 将PowerShell对象转换为JSON字符串（-Depth确保嵌套结构完整转换）
$body = ConvertTo-Json -InputObject $taskConfig -Depth 10

# 4. 调用Stonebranch的创建任务函数
$response = Stonebranch.Create.Task.Windows -Sb_base_uri $Sb_base_uri -Auth_filename $Auth_filename -Method POST -Body $body

这里的-Depth 10是为了避免嵌套结构（比如actions下的数组）因为默认深度不够被截断，保证JSON结构和原硬编码内容一致。

4. 可选：让YAML路径支持动态参数（更灵活） #

如果需要根据不同场景使用不同的YAML配置，可以把YAML文件路径作为参数传入脚本，修改调用脚本如下：

param(
    [Parameter(Mandatory=$true)]
    [string]$YamlConfigPath,
    [Parameter(Mandatory=$true)]
    [string]$Sb_base_uri,
    [Parameter(Mandatory=$true)]
    [string]$Auth_filename
)

$yamlContent = Get-Content -Path $YamlConfigPath -Raw
$taskConfig = ConvertFrom-Yaml -Yaml $yamlContent
$body = ConvertTo-Json -InputObject $taskConfig -Depth 10

$response = Stonebranch.Create.Task.Windows -Sb_base_uri $Sb_base_uri -Auth_filename $Auth_filename -Method POST -Body $body

调用时就可以动态指定配置文件：

.\YourScript.ps1 -YamlConfigPath "C:\Configs\DevTask.yaml" -Sb_base_uri "https://your-sb-instance.com" -Auth_filename "auth.txt"

验证要点 #

• 确保YAML文件语法正确：缩进用空格（不要用Tab），数组和键值对格式符合YAML规范。
• 转换后的JSON和原硬编码$body结构一致，可以通过输出$body查看内容对比。
• Stonebranch API对JSON格式有严格要求的话，ConvertTo-Json默认生成的双引号格式和原代码一致，完全兼容。

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