Invoke-Sqlcmd的-OutputAs参数无法识别问题求助

我之前碰到过完全一样的问题，核心原因是SqlServer模块版本迭代带来的参数变更——你的服务器上装的是21.1.18256版本的SqlServer模块，这个版本里Invoke-Sqlcmd的OutputAs参数已经被重命名为OutputType了；而其他能正常运行的服务器大概率装的是更旧的模块版本（比如19.x及以前），那些版本还在使用OutputAs参数。

给你几个可行的解决方案：

1. 直接替换参数名（最快修复） #

把脚本里的-OutputAs DataTable改成-OutputType DataTable即可，修改后的命令示例：

Invoke-Sqlcmd -ServerInstance $strServer -Database $strDatabase -Query $query -OutputType DataTable

2. 跨版本兼容写法（如果脚本需要在不同模块版本的服务器上运行） #

如果你的脚本要兼顾新旧模块版本，可以动态检测当前环境支持的参数，再选择对应的参数名：

# 构建Invoke-Sqlcmd的参数哈希表
$invokeArgs = @{
    ServerInstance = $strServer
    Database       = $strDatabase
    Query          = $query
}

# 检查当前Invoke-Sqlcmd是否支持OutputAs参数
$hasOutputAsParam = (Get-Command Invoke-Sqlcmd).Parameters.ContainsKey('OutputAs')
if ($hasOutputAsParam) {
    $invokeArgs['OutputAs'] = 'DataTable'
} else {
    $invokeArgs['OutputType'] = 'DataTable'
}

# 执行命令
Invoke-Sqlcmd @invokeArgs

3. 确认模块版本差异 #

你可以在正常运行的服务器上执行以下命令，对比模块版本：

Get-Module -ListAvailable SqlServer | Select-Object Name, Version

不出意外的话，正常服务器的SqlServer模块版本会低于20.x，这些版本还保留着OutputAs参数。

补充说明：SqlServer模块从20.x版本开始，对Invoke-Sqlcmd的参数做了标准化调整，OutputAs就是其中一个被重命名的参数，目的是让参数命名更符合PowerShell的规范。

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