PowerShell Start-Process运行AFImport.exe参数语法错误排查

问题复现 #

参考AFImport标准调用语法：

AFImport "\\AFServer\database" /File:"C:\Filename.xml" /P

编写的初始PowerShell脚本：

Set-Location -Path "$Env:pihome64\AF"
$xml = "C:\Temp\test.xml"
$AF = "\\AFtest\AF-test"
$log = "C:\Temp\log.txt"
Start-Process AFImport.exe -ArgumentList '$AF','File:$xml','/P' -Wait -RedirectStandardOutput $log

执行现象：弹出CMD窗口启动AFImport.exe后无任何输出，数秒后窗口自动关闭，日志文件无有效内容。

核心语法错误 #

• 单引号导致变量未展开：PowerShell中单引号包裹的内容为字面量，不会解析内部变量。代码中'$AF'、'File:$xml'会直接把$AF、$xml这两个字符串本身传给程序，不会替换为提前定义的服务器路径、XML文件路径，AFImport收到非法参数直接退出。
• /File参数格式错误：标准语法中文件参数以/开头，路径需要用双引号包裹，原代码写的File:$xml缺少开头的/，也没有给文件路径加合法的引号包裹，程序无法识别该参数。
• 未捕获错误流：原代码只重定向了标准输出流，AFImport因参数错误抛出的报错信息会输出到错误流，弹窗一闪而过时用户看不到报错内容。

修正后代码 #

Set-Location -Path "$Env:pihome64\AF"
$xml = "C:\Temp\test.xml"
$AF = "\\AFtest\AF-test"
$stdoutLog = "C:\Temp\log.txt"
$stderrLog = "C:\Temp\err_log.txt"

# 构造参数列表，用双引号包裹保证变量展开，路径加转义双引号兼容带空格的路径
$argList = @(
    "`"$AF`"",
    "/File:`"$xml`"",
    "/P"
)

Start-Process AFImport.exe `
    -ArgumentList $argList `
    -Wait `
    -NoNewWindow `
    -RedirectStandardOutput $stdoutLog `
    -RedirectStandardError $stderrLog

补充说明：添加-NoNewWindow参数可以避免弹出独立的CMD窗口，所有输出直接在当前PowerShell会话关联的流中处理；单独重定向错误流可以快速定位参数、权限、文件路径类的报错。

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