VS Code运行PowerShell报Connect-MsGraph无法识别问题咨询

• VS Code的PowerShell扩展默认调用PowerShell 7（pwsh，跨平台Core版本），和系统自带的Windows PowerShell 5.1是完全独立的两个运行环境，模块安装路径、加载配置相互隔离。为Windows PowerShell 5.1安装的模块，PowerShell 7默认无法读取，多数情况下所谓的"为VS Code安装模块"实际是装到了错误的运行环境中。
• VS Code内手动选择的PowerShell运行版本不匹配，比如选到了x86架构的PowerShell、未装模块的PowerShell 7环境，和桌面端正常运行脚本的Windows PowerShell x64 5.1环境不一致。
• 模块安装路径未加入对应运行环境的PSModulePath环境变量，或模块安装时作用域选择错误，导致当前PowerShell会话无法扫描到已安装的模块。
• VS Code内的PowerShell会话启动时未完成模块扫描缓存，导致命令暂时无法识别。
• 注意：命令名拼写不匹配也会触发同类报错：Microsoft.Graph.Intune模块对应的登录命令为Connect-MSGraph，新版Microsoft Graph模块的登录命令为Connect-MgGraph，拼写和安装模块不对应时也会提示cmdlet无法识别。

1. 确认并切换到正确的PowerShell运行环境
   • 在VS Code打开的PowerShell终端中执行$PSVersionTable，查看返回结果中的PSEdition和PSVersion字段：
     • 显示PSEdition: Core、版本号7.x时，当前运行环境为PowerShell 7，和桌面端正常运行脚本的Windows PowerShell环境不一致
     • 显示PSEdition: Desktop、版本号5.1.x时，才是和桌面端一致的Windows PowerShell 5.1环境
   • 切换方法：按Ctrl+Shift+P调出命令面板，输入PowerShell: Show Session Menu，在弹出的列表中选择Windows PowerShell (x64) 5.1，等待终端重启完成后再测试脚本。
2. 为当前运行环境重新安装对应模块
   • 确认终端已经切到目标PowerShell环境后，执行以下命令安装模块，强制安装到当前用户的模块目录：

     Install-Module -Name Microsoft.Graph.Intune -Scope CurrentUser -Force -AllowClobber
     

   • 安装完成后执行Get-Command Connect-MSGraph，如果返回命令的具体路径信息，说明命令已经可以正常识别。
3. 校验模块搜索路径配置
   • 如果安装完成后仍无法识别命令，执行$env:PSModulePath -split ';'查看当前环境的模块搜索路径列表，确认模块安装所在的路径在列表中。如果路径缺失，可以手动将模块路径加入环境变量，或者以管理员权限启动终端，执行带-Scope AllUsers参数的安装命令重装模块。
4. 强制导入模块测试
   • 临时解决可以在脚本开头添加强制导入模块的语句，跳过PowerShell的自动模块扫描流程：

     Import-Module Microsoft.Graph.Intune -Force
     

   • 语句执行无报错的前提下，后续调用Connect-MSGraph即可正常识别。
5. 修复执行策略限制
   • 当PowerShell执行策略过于严格时，会阻止模块自动加载，在对应终端执行以下命令修改当前用户的执行策略，执行后重启终端再测试：

     Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
     

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