批处理嵌入含注释与括号的PowerShell代码报错排查

问题背景 #

借助Batch和PowerShell的注释语法，可在单个.bat文件中混合两种脚本，无需生成临时文件。但使用管道传递含#注释和括号的PowerShell代码时，Batch脚本会抛出「may was unexpected at this time.」或「) was unexpected at this time.」错误；但直接在CMD终端运行类似管道命令（如echo # Preserve lines above. Only Comments (lines starting with ::) may be stripped! | powershell -NoProfile -noninteractive -Command -）却能正常执行。当前使用PowerShell 5.1版本，需要解决该兼容性问题。

现有模板代码 #

第一种模板代码 #

:: 从标准输入执行PowerShell脚本的实现思路
:: 跳过指定行之前内容的实现思路

:: echo write-host 'Hello World!'#22 | powershell -NoProfile -noninteractive -Command -
@ECHO OFF
for /f "delims=:" %%i in ('findstr /rinc:":POWERSHELL" %~f0') do (set line_no=%%i)
for /f "skip=%line_no% delims=" %%a in ('type %~f0') do (echo %%a) ^
| powershell -NoProfile -noninteractive -Command -
EXIT /B 0

第二种psbat模板代码 #

:: psbat模板说明
:: 本模板可将PowerShell代码封装到Batch文件中，双击即可执行，不受PowerShell默认RESTRICED执行策略限制。可参考执行策略相关文档和设置命令。
::
:: 使用方法
:: 复制本模板，保留`@ECHO OFF`到`:POWERSHELL`的代码，自定义PowerShell代码写在`:POWERSHELL`下方。

:: 本文件整合批处理与PowerShell脚本，双击即可执行，不受PowerShell默认执行策略限制。
@ECHO OFF
powershell.exe -NoProfile -Command "& { $skip = $true; $script = Get-Content '%~f0' | ?{ If ($skip) { $skip = $_ -ne ':POWERSHELL'} Else { return $true} } | Out-String; [ScriptBlock]::Create(\"`$PSScriptRoot='%~dp0'`n$script\").Invoke() }"
EXIT /B 0

:POWERSHELL
# 保留上方代码行，仅可删除::开头的注释
# PowerShell代码写在下方

# 强制PowerShell输出英文错误信息的实现思路
# [cultureinfo]::CurrentUICulture = 'en-US'
# [System.Threading.Thread]::CurrentThread.CurrentUICulture = 'en-US'

write-host "Hello World!"
# $wshell = New-Object -ComObject wscript.shell;
# $wshell.AppActivate('title of the application window')
# $date = Get-Date # [DateTime]::Now
# $counter = 0

PowerShell版本信息 #

powershell -Command $PSVersionTable

Name                           Value
----                           -----
PSVersion                      5.1.26100.4768
PSEdition                      Desktop
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}
BuildVersion                   10.0.26100.4768
CLRVersion                     4.0.30319.42000
WSManStackVersion              3.0
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1

问题原因分析 #

第一种模板的核心问题是：Batch的for /f循环在输出PowerShell代码行时，CMD会对包含括号、%、!等特殊字符的内容进行语法解析，导致管道传递的内容被Batch提前拆解，触发语法错误。而直接在CMD中执行echo ... | powershell ...时，echo的内容不会经过Batch脚本的循环处理，特殊字符不会被CMD解析，因此能正常运行。

解决方案 #

方案1：优化第一种模板，转义特殊字符 #

修改echo %%a部分，通过forfiles命令实现特殊字符自动转义，避免Batch解析错误：

@ECHO OFF
for /f "delims=:" %%i in ('findstr /rinc:":POWERSHELL" %~f0') do (set line_no=%%i)
for /f "skip=%line_no% delims=" %%a in ('type %~f0') do (
    forfiles /p "%~dp0" /m "%~nx0" /c "cmd /c echo @file | findstr /v @file >nul && echo %%a"
) | powershell -NoProfile -noninteractive -Command -
EXIT /B 0

方案2：使用第二种模板的改进版本（推荐） #

第二种模板通过PowerShell自身读取文件内容并跳过指定行，从根源上避免Batch解析PowerShell代码的问题。优化后的代码如下：

@ECHO OFF
powershell.exe -NoProfile -Command "$skip = $true; $script = Get-Content '%~f0' | ForEach-Object { if ($skip) { $skip = $_ -ne ':POWERSHELL' } else { $_ } } | Out-String; $PSScriptRoot = '%~dp0'; Invoke-Expression $script"
EXIT /B 0

:POWERSHELL
# 这里写你的PowerShell代码
write-host "Hello World!"
# 示例：带括号和注释的代码
$test = "This is a test (with parentheses)" # 测试注释
write-host $test

该版本简化了脚本执行逻辑，同时正确设置$PSScriptRoot，解决了原代码中的转义问题。

验证方法 #

将带括号和注释的PowerShell代码添加到:POWERSHELL下方，双击运行.bat文件，若能正常输出结果且无语法错误，则说明问题解决。

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