如何通过PowerShell与SQLCMD捕获SQL Server存储过程返回值

我来帮你搞定这个问题！要同时把存储过程的结果集导出到文件，还把返回值抓到PowerShell的$RC变量里，关键是利用SQLCMD的:EXIT命令传递返回值，再结合PowerShell的$LASTEXITCODE来捕获。

先确认存储过程的收尾 #

首先你的TEST存储过程得有明确的RETURN语句（不然默认返回0），比如最后加上：

-- 假设你要返回某个整数，比如这里返回100作为示例
RETURN 100;

PowerShell里的完整实现步骤 #

直接上可运行的代码，你只需要替换服务器、数据库和文件路径：

# 1. 执行SQLCMD：导出结果集到文件，同时把存储过程返回值传给SQLCMD的退出码
sqlcmd -S "你的SQL服务器名" -d "目标数据库名" -Q "DECLARE @RC INT; EXEC @RC = [DBO].[TEST]; :EXIT(@RC)" -o "C:\temp\存储过程结果.txt"

# 2. 把SQLCMD的退出码捕获到$RC变量里
$RC = $LASTEXITCODE

# 3. 验证结果（可选）
Write-Host "存储过程的返回值是：$RC"
Write-Host "下面是结果集内容："
Get-Content "C:\temp\存储过程结果.txt"

关键知识点解释 #

• :EXIT(@RC)：这是SQLCMD专属命令，作用是把@RC的值作为SQLCMD进程的退出码。这样PowerShell就能通过$LASTEXITCODE拿到这个值，也就是存储过程的返回值。
• -o参数：专门用来把存储过程返回的结果集写入指定文本文件，文件存在的话会直接覆盖；如果想追加内容，可以把-o "路径"改成>> "路径"（去掉-o，用PowerShell的重定向）。
• 错误处理（可选）：如果担心存储过程执行出错导致返回值没捕获，可以给SQL脚本加个异常捕获：

  DECLARE @RC INT;
  BEGIN TRY
      EXEC @RC = [DBO].[TEST];
  END TRY
  BEGIN CATCH
      SET @RC = -1; -- 自定义错误返回值，比如用-1标记执行失败
  END CATCH
  :EXIT(@RC)
  

注意事项 #

• 确保你的PowerShell环境能找到sqlcmd.exe，如果找不到就用完整路径，比如C:\Program Files\Microsoft SQL Server\Client SDK\ODBC\170\Tools\Binn\sqlcmd.exe（版本号可能不同，自己对应一下）。
• 执行PowerShell的用户需要有SQL Server的访问权限、执行存储过程的权限，以及写入输出文件的权限。

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