PowerShell SqlServer模块异常：安装成功但导入仅加载3项

我来帮你排查这个头疼的问题——明明安装SqlServer模块成功了，但导入时只能拿到3项内容，这大概率是模块加载环节出了兼容性、文件完整性或者环境配置的问题，下面是几个针对性的解决步骤：

1. 先确认PowerShell环境与模块的兼容性 #

SqlServer 21.0.17240版本对PowerShell环境有一定要求，先排查基础环境：

• 检查PowerShell位数：运行$env:PROCESSOR_ARCHITECTURE，如果返回x86（32位），但你的模块装在C:\Program Files\WindowsPowerShell\Modules（64位路径），那32位PowerShell根本找不到完整的模块文件。这种情况请切换到64位PowerShell重试。
• 检查PowerShell版本：运行$PSVersionTable.PSVersion，确保主版本号≥5.1（21.x版本的SqlServer模块最低要求PS5.1）。如果版本过低，建议升级PowerShell后重新安装模块。

2. 强制清理并重新加载模块 #

有时候模块可能残留了旧的加载缓存，试试彻底清理后重新加载：

• 先卸载已加载的模块：

  Remove-Module SqlServer -Force -ErrorAction SilentlyContinue
  

• 然后用最高级别的日志输出重新导入，查看加载细节：

  Import-Module SqlServer -Verbose -Debug -ErrorAction Stop
  

  重点看Debug输出里有没有类似“跳过加载某模块”“依赖项缺失”的提示，这些会直接导致部分功能无法导入。

3. 检查模块清单文件的完整性 #

模块的psd1清单文件是加载的核心配置，如果它损坏或配置错误，会导致模块只加载部分内容：

• 运行命令验证清单文件：

  Test-ModuleManifest -Path "C:\Program Files\WindowsPowerShell\Modules\sqlserver\21.0.17240\sqlserver.psd1"
  

  输出里的警告或错误会直接告诉你清单哪里有问题，比如缺失的嵌套模块、无效的导出配置。
• 也可以手动打开这个psd1文件，检查RootModule、NestedModules、ExportedCommands等字段，确认指向的文件都存在于模块目录中。

4. 彻底重装模块 #

如果前面的排查都没解决问题，大概率是安装过程中文件损坏了，试试彻底重装：

• 先卸载所有版本的SqlServer模块：

  Uninstall-Module SqlServer -AllVersions -Force -ErrorAction SilentlyContinue
  

• 手动删除残留的模块文件夹：打开C:\Program Files\WindowsPowerShell\Modules，删除名为sqlserver的目录。
• 重新安装模块，加上强制覆盖和允许覆盖现有命令的参数：

  Install-Module -Name SqlServer -Repository PSGallery -Verbose -Force -AllowClobber
  

  安装时全程关注Verbose输出，确保没有下载失败、权限不足之类的报错。

5. 提前检查模块的导出内容 #

如果重装后还是有问题，先不导入模块，直接查看它应该导出的内容：

Get-Module -ListAvailable SqlServer | Select-Object -ExpandProperty ExportedCommands

如果输出里只有3项，说明安装的模块本身就是不完整的；如果输出有大量命令，那问题出在导入环节，回到步骤2继续排查加载日志。

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