Invoke-Sqlcmd报错：必须声明标量变量@Environment问题求助

错误信息 #

Invoke-Sqlcmd : 必须声明标量变量 "@Environment"。
消息 137，级别 15，状态 2，过程 ，第 1 行。
位于 C:\Scripts\envrefresh script\newtest.ps1:26 字符:19
... nvResults = Invoke-Sqlcmd -ServerInstance $serverInstance -Database $ ...

CategoryInfo          : InvalidOperation: (:) [Invoke-Sqlcmd], SqlPowerShellSqlExecutionException
FullyQualifiedErrorId : SqlError,Microsoft.SqlServer.Management.PowerShell.GetScriptCommand

执行的PowerShell脚本 #

param(
    [string]$Environment
)

# 步骤2：定义SQL连接详情
$serverInstance = "removed"
$database = "removed"

# 设置日志
$logFilePath = "C:\Logs\ScriptLog.txt"
$timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"

function LogMessage {
param (
    [string]$message
)
$logMessage = "$timestamp - $message"
Add-content -Path $logFilePath -Value $logMessage
}

LogMessage "脚本执行已启动。"

try {
# 步骤3：调用存储过程upSelectEnvRefreshEnvironment并传入步骤1的参数
$envResults = Invoke-Sqlcmd -ServerInstance $serverInstance -Database $database -Query "EXEC     
upSelectEnvRefreshEnvironment @Environment" -Variable @{"Environment" = $Environment}

# 步骤4-5：处理每条结果
foreach ($row in $envResults) {
    $environmentID = $row.EnvironmentID
    $connectionName = $row.ConnectionName

    # 步骤6：为每个EnvironmentID连接到对应的数据库
    $innerConnectionString = "Server=$serverInstance;Database=$connectionName;Integrated   
Security=True;"
    
    # 将LiveDBUser = NonLiveDBUser的值传入存储过程upEnvRefreshRenameDBUsers
    $permissionsResults = Invoke-Sqlcmd -ServerInstance $serverInstance -Database $database - 
Query "EXEC upSelectEnvRefreshPermissionsMapping @EnvironmentID" -Variable @{"EnvironmentID" = 
$environmentID}
    
    foreach ($permRow in $permissionsResults) {
        $liveDBUser = $permRow.LiveDBUser
        $nonLiveDBUser = $permRow.NonLiveDBUser

        # 步骤7：执行存储过程upEnvRefreshRenameDBUsers
        Invoke-Sqlcmd -ServerInstance $serverInstance -Database "DevOps" -Query "EXEC 
dbo.upEnvRefreshRenameDBUsers @LiveDBUser, @NonLiveDBUser" -Variable @{"LiveDBUser" = 
$liveDBUser; "NonLiveDBUser" = $nonLiveDBUser}

        LogMessage "已重命名数据库用户：LiveDBUser=$liveDBUser, NonLiveDBUser=$nonLiveDBUser"
    }
}

LogMessage "脚本执行成功完成。"
}
catch {
LogMessage "发生错误：$_"
}

排查解决方案 #

1. 修正-Variable参数传递格式 #

部分旧版本SqlServer模块不支持哈希表格式的-Variable参数，改用字符串数组形式传递：

$envResults = Invoke-Sqlcmd -ServerInstance $serverInstance -Database $database -Query "EXEC upSelectEnvRefreshEnvironment @Environment" -Variable "Environment=$Environment"

2. 验证参数是否有效传入 #

在调用Invoke-Sqlcmd前添加日志，确认$Environment变量是否有值：

LogMessage "当前传入的Environment参数值：$Environment"

如果值为空，执行脚本时需明确指定参数：

.\newtest.ps1 -Environment "你的目标环境名称"

3. 检查存储过程定义 #

确认SQL存储过程upSelectEnvRefreshEnvironment的参数列表中确实包含@Environment，且参数类型与PowerShell传入的字符串类型匹配。

4. 临时替代方案（仅限可信环境） #

若上述方法无效，可直接将参数嵌入查询语句（注意：仅适用于可信输入，避免SQL注入风险）：

$envResults = Invoke-Sqlcmd -ServerInstance $serverInstance -Database $database -Query "EXEC upSelectEnvRefreshEnvironment '$Environment'"

内容的提问来源于stack exchange，提问作者Bradley Bowns Bredzu