使用Invoke-Command调用Invoke-Sqlcmd时实例变量传递问题求助

问题场景 #

编写读取远程SQL实例的脚本时，遇到ServerInstance变量传递失效的问题：直接硬编码实例名可正常运行，使用变量传递则连接失败。

可正常运行的命令 #

invoke-command -computername computer1 -ScriptBlock { Invoke-Sqlcmd -ServerInstance servername\sqlexpress -Database master -Query "SELECT SERVERPROPERTY('productversion'), SERVERPROPERTY ('productlevel'), SERVERPROPERTY ('edition'), SERVERPROPERTY ('engineedition')"}

运行结果 #

PSComputerName : computer1
RunspaceId     : 5393f2e0-715c-46c1-9e64-13642c2f031b
Column1        : 14.0.1000.169
Column2        : RTM
Column3        : Express Edition (64-bit)
Column4        : 4

无法运行的代码 #

$Instance="computer1\sqlexpress"
invoke-command -computername computer1 -ScriptBlock { Invoke-Sqlcmd -ServerInstance $Instance -Database master -Query "SELECT SERVERPROPERTY('productversion'), SERVERPROPERTY ('productlevel'), SERVERPROPERTY ('edition'), SERVERPROPERTY ('engineedition')"}

错误信息 #

A network-related or instance-specific error occurred while establishing a connection to SQL Server.
The server was not found or was not accessible. Verify that the instance name is correct and that SQL Server is configured to allow remote connections.
(provider:Named Pipes Provider, error: 40 - Could not open a connection to SQL Server)

中文翻译：

建立与SQL Server的连接时出现与网络相关的或特定于实例的错误。
找不到服务器或无法访问服务器。请验证实例名称是否正确，并且SQL Server配置为允许远程连接。
(提供程序: 命名管道提供程序, 错误: 40 - 无法打开到SQL Server的连接)

解决思路及方案 #

问题核心：Invoke-Command的脚本块在远程计算机的独立PowerShell会话中执行，默认无法直接访问本地会话的$Instance变量，导致远程会话中该变量未定义，进而引发SQL连接失败。

提供两种可行解决方法：

方法1：使用-ArgumentList传递变量 #

通过-ArgumentList参数将本地变量传递到远程脚本块，在脚本块内用$args数组接收：

$Instance="computer1\sqlexpress"
invoke-command -computername computer1 -ScriptBlock { 
    Invoke-Sqlcmd -ServerInstance $args[0] -Database master -Query "SELECT SERVERPROPERTY('productversion'), SERVERPROPERTY ('productlevel'), SERVERPROPERTY ('edition'), SERVERPROPERTY ('engineedition')"
} -ArgumentList $Instance

方法2：使用$using:作用域引用本地变量（PowerShell 3.0+支持） #

通过$using:前缀让远程脚本块直接引用本地会话的变量，无需额外参数传递：

$Instance="computer1\sqlexpress"
invoke-command -computername computer1 -ScriptBlock { 
    Invoke-Sqlcmd -ServerInstance $using:Instance -Database master -Query "SELECT SERVERPROPERTY('productversion'), SERVERPROPERTY ('productlevel'), SERVERPROPERTY ('edition'), SERVERPROPERTY ('engineedition')"
}

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