PowerShell Invoke-SqlCmd是否支持ConnectionString？多服务器异常排查

核心问题分析 #

你遇到的错误本质是PowerShell实际调用的Invoke-Sqlcmd来自不支持ConnectionString参数的旧版本SQLPS模块，尽管Get-Command显示来源为SqlServer。这是因为：

• SQLPS 1.0是旧版SQL Server配套模块，确实没有ConnectionString参数；
• Server3同时存在SqlServer 22.2.0和SQLPS 1.0，模块加载时可能存在隐式冲突（比如会话中提前加载了SQLPS的组件，或者模块优先级导致解析混淆）。

分步解决方案 #

1. 强制脚本使用SqlServer模块的Invoke-Sqlcmd #

这是最快的临时解决方法，无需修改服务器环境：

• 方法一：脚本开头强制导入指定版本的SqlServer模块
  在脚本最顶部添加：

  # 强制导入22.2.0版本的SqlServer模块，覆盖已加载的旧版组件
  Import-Module SqlServer -RequiredVersion 22.2.0 -Force -ErrorAction Stop
  

• 方法二：调用时直接指定模块前缀
  把原脚本中的Invoke-SqlCmd @sqlCmdParameters替换为：

  SqlServer\Invoke-SqlCmd @sqlCmdParameters
  

2. 彻底解决模块冲突（移除/升级SQLPS） #

移除SQLPS 1.0模块

SQLPS 1.0通常随旧版SQL Server管理组件安装，可通过以下步骤卸载：

• 打开控制面板 > 程序和功能；
• 找到并卸载以下任一匹配项：
  • Microsoft SQL Server 2016 Shared Management Objects
  • Microsoft SQL Server 2016 SQLPS
  • 如果是通过RSAT安装的，卸载Remote Server Administration Tools > Feature Administration Tools > SQL Server Tools；
• 卸载后重启PowerShell会话，再次运行Get-Module -ListAvailable *Sql*确认SQLPS已移除。

升级SQLPS到15.0版本（可选）

如果需要保留SQLPS模块，可升级到支持ConnectionString的15.0版本：

1. 安装SQL Server 2019共享管理对象（包含SQLPS 15.0）；
2. 安装完成后，PowerShell会优先加载高版本的SQLPS模块。

3. 验证修复效果 #

在Server3上运行以下命令确认：

# 确认Invoke-Sqlcmd的来源为SqlServer
Get-Command Invoke-Sqlcmd | Select-Object Name, Source, Version

# 检查是否存在ConnectionString参数
(Get-Command Invoke-Sqlcmd).Parameters.ContainsKey('ConnectionString')

如果输出True，说明参数已被正确识别。

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