PowerShell中SQL连接字符串赋值异常问题求助

问题场景 #

编写的PowerShell函数如下：

function GenericSqlQuery($ConnectionString, $SQLQuery) {
    Write-Host $ConnectionString
    $Connection = New-Object System.Data.SQLClient.SQLConnection
    $Connection.ConnectionString = $ConnectionString
    $Connection.Open()
    $Command = New-Object System.Data.SQLClient.SQLCommand
    $Command.Connection = $Connection
    $Command.CommandText = $SQLQuery
    $Reader = $Command.ExecuteReader()
    while ($Reader.Read()) {
         $Reader.GetValue(0)
    }
    $Connection.Close()
}

执行时Write-Host $ConnectionString能正常显示变量内容，但赋值给$Connection.ConnectionString时抛出异常：

Exception setting "ConnectionString": "Format of the initialization string does not conform to specification starting at index 64."
At C:\Users\Blah\Desktop\Debugger\ABS9_DB_Update.ps1:7 char:5

• $Connection.ConnectionString = "$ConnectionString"
  

• ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  

  • CategoryInfo : NotSpecified: (:) [], SetValueInvocationException
  • FullyQualifiedErrorId : ExceptionWhenSetting

尝试多种连接字符串构建方式均出现变量替换后格式错误的问题。

排查与解决方法 #

1. 检查连接字符串的实际字符内容 #

Write-Host无法显示隐藏控制字符或换行符，这些字符会导致连接字符串格式失效。用以下命令查看字符串的十六进制编码，定位索引64处的字符：

$ConnectionString | Format-Hex

若发现不可见字符，需清理连接字符串中的非法内容。

2. 避免PowerShell对字符串的解析干扰 #

如果连接字符串包含引号、空格或特殊字符，传递参数时用单引号包裹，防止PowerShell错误解析：

GenericSqlQuery -ConnectionString 'Data Source=MyServer;Initial Catalog=MyDB;User ID=sa;Password=Pass@123' -SQLQuery "SELECT TOP 1 Name FROM Users"

若连接字符串是动态拼接的，确保拼接过程中没有引入多余的引号或分号。

3. 验证变量类型与完整性 #

确认$ConnectionString是纯字符串类型，而非数组或其他对象：

$ConnectionString.GetType()

如果是数组，说明传递参数时未正确包裹含空格的字符串，导致参数被拆分成多个元素。

4. 检查连接字符串语法 #

手动核对Write-Host输出的连接字符串：

• 每个键值对格式为Key=Value;，末尾分号可省略但不能遗漏中间分号
• 关键字拼写正确（如Initial Catalog而非InitialCatlog）
• 密码等包含特殊字符的参数，若值中包含分号或双引号，需用双引号包裹该值

优化后的函数（添加错误处理） #

为避免连接未关闭的情况，添加try/catch/finally块保障资源释放：

function GenericSqlQuery($ConnectionString, $SQLQuery) {
    Write-Host $ConnectionString
    $Connection = New-Object System.Data.SQLClient.SQLConnection
    try {
        $Connection.ConnectionString = $ConnectionString
        $Connection.Open()
        # 简化Command初始化逻辑
        $Command = New-Object System.Data.SQLClient.SQLCommand($SQLQuery, $Connection)
        $Reader = $Command.ExecuteReader()
        while ($Reader.Read()) {
             $Reader.GetValue(0)
        }
    }
    catch {
        Write-Error "执行失败: $_"
    }
    finally {
        # 确保连接关闭并释放资源
        if ($Connection.State -eq [System.Data.ConnectionState]::Open) {
            $Connection.Close()
        }
        $Connection.Dispose()
    }
}

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