已安装SqlServer v21.1.18256模块，为何Get-SqlInstance cmdlet不被识别？

排查与解决步骤 #

• 先确认模块是否已导入
  执行命令检查SqlServer模块是否加载：

  Get-Module -Name SqlServer
  

  如果无返回结果，手动导入模块：

  Import-Module SqlServer -Force
  

  导入后再尝试执行Get-SqlInstance命令。

• 定位SqlServer模块的实际路径
  用以下命令查找模块安装位置：

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

  检查返回的ModuleBase路径是否在当前$env:PSModulePath中。如果不在，临时添加路径：

  $env:PSModulePath += ";模块实际路径"
  

  若要永久生效，需在系统或用户环境变量中添加该路径。

• 检查PowerShell版本兼容性
  SqlServer v21.1.18256对PowerShell版本有要求，查看当前版本：

  $PSVersionTable.PSVersion
  

  确保版本在5.1及以上，或使用PowerShell 7.x版本。

• 修复模块安装
  若导入模块出错，尝试重新安装：

  Uninstall-Module -Name SqlServer -AllVersions -Force
  Install-Module -Name SqlServer -RequiredVersion 21.1.18256 -Force -AllowClobber
  

  安装完成后重新导入模块测试。

• 检查执行策略
  过严的执行策略会影响模块加载，查看当前策略：

  Get-ExecutionPolicy
  

  若为Restricted，临时调整为RemoteSigned：

  Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
  

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