Jenkins Pipeline运行内联多行PowerShell脚本的语法问题

核心报错原因 #

你遇到的问题来自4个高频踩坑点：

• Groovy三引号字符串的解析规则：'''包裹的内容会原样传递，你原代码里PowerShell脚本每一行带的多级前置缩进会被当成脚本内容传给PowerShell，直接触发PowerShell语法错误。
• Groovy闭包语法歧义：dir是Jenkins流水线内置步骤，接收闭包作为参数，如果把{单独放在新行，Groovy会把它识别为独立闭包，而非dir的参数，直接导致流水线语法校验失败。
• PowerShell执行逻辑缺失：没有做错误动作偏好设置、退出码校验，外部命令（net、sc.exe）执行时的异常返回码会直接被Jenkins判定为步骤失败，同时裸字符串输出在重定向场景下容易出现日志丢失、解析异常的问题。
• 引号转义错误：你尝试的Write-Output '"xxx"'写法会让输出内容额外包裹一层双引号，属于多余转义。

可直接使用的修正代码 #

stage('Cleanup') {
    steps {
        powerShell '''
$ErrorActionPreference = "Stop"
$serv_status = Get-Service myService -ErrorAction SilentlyContinue

if ($null -ne $serv_status) {
    Write-Output "Old version of myService detected"
    Write-Output "Stopping the service..."
    net stop myService | Out-Null
    # 兼容服务已停止场景：net stop对已停止服务返回退出码2，不属于错误
    if ($LASTEXITCODE -notin 0,2) {
        throw "Failed to stop myService, exit code: $LASTEXITCODE"
    }

    Write-Output "Removing the service..."
    sc.exe delete myService | Out-Null
    if ($LASTEXITCODE -ne 0) {
        throw "Failed to delete myService, exit code: $LASTEXITCODE"
    }
}
'''
        // 闭包{必须和dir方法同行，避免Groovy解析错误
        dir("${env.ROOT_PATH}") {
            cleanWs()
        }
    }
}

关键注意事项 #

• 三单引号包裹的PowerShell脚本不要保留和Groovy代码对齐的前置缩进，所有PowerShell代码顶格写在三引号块内即可，避免多余空格触发语法错误。
• 不要在PowerShell里直接写sc delete myService，PowerShell中sc是Set-Content的内置别名，必须写全sc.exe才能调用服务控制命令。
• 外部命令执行后追加| Out-Null可以避免PowerShell输出对象格式化导致的Jenkins日志乱码、步骤挂起问题。
• 如果需要让PowerShell脚本支持Groovy变量插值，可以把三单引号换成三双引号"""，此时脚本内的PowerShell变量（比如$serv_status）需要转义成\$serv_status，避免被Groovy提前解析。

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