PowerShell连接Office 365报错：Connect-ExchangeOnline未被识别

问题描述 #

已导入ExchangeOnlineManagement模块，但执行PowerShell脚本连接Office 365时，出现异常：

"术语Connect-ExchangeOnline未被识别为 cmdlet、函数、脚本或可运行程序"

用户使用的C#调用代码如下：

string script = @"
               Set-ExecutionPolicy Unrestricted
               $user = '<your username>'
               $pwd = '<your password>'
               $SecurePass = ConvertTo-SecureString -AsPlainText $pwd -Force
               $Cred = New-Object System.Management.Automation.PSCredential -ArgumentList $user,$SecurePass
               Import-Module -Name ExchangeOnlineManagement
               Connect-ExchangeOnline -Credential $Cred
               ";
try
{
   using (Runspace runspace = RunspaceFactory.CreateRunspace())
   {
      runspace.Open();
      Pipeline pipe = runspace.CreatePipeline();
      pipe.Commands.AddScript(script);
      
      try
      {
         var results = pipe.Invoke();
      } 
      catch (Exception e)
      {

      }
      
      var error = pipe.Error.ReadToEnd();
      if (error.Count > 0)
      {
         foreach (PSObject err in error)
         {
            //more logging not sharing that code
         }
      }
   }
}
catch (Exception ex)
{ }

解决方法 #

• 检查模块安装与版本

  1. 打开管理员权限的PowerShell，执行Get-Module -ListAvailable ExchangeOnlineManagement，确认模块已正确安装
  2. 确保模块版本在2.0及以上（Connect-ExchangeOnline是该版本后新增的cmdlet，旧版本使用的是Connect-EXOPSSession）
  3. 如果模块安装在非默认路径，导入时需指定完整路径，示例：

     Import-Module -Name ExchangeOnlineManagement -ModulePath "C:\Program Files\WindowsPowerShell\Modules\ExchangeOnlineManagement\2.0.5" -ErrorAction Stop
     

• 在Runspace初始化时加载模块
  避免脚本动态导入模块可能出现的加载失败，直接在C#的Runspace配置中导入模块：

  InitialSessionState initialState = InitialSessionState.CreateDefault();
  initialState.ImportPSModule(new[] { "ExchangeOnlineManagement" });
  using (Runspace runspace = RunspaceFactory.CreateRunspace(initialState))
  {
      runspace.Open();
      Pipeline pipe = runspace.CreatePipeline();
      pipe.Commands.AddScript(script);
      
      // 后续执行与错误处理代码
  }
  

• 验证执行策略与权限

  1. Set-ExecutionPolicy Unrestricted在非交互式会话中可能不生效，建议提前在系统中设置（需管理员权限），或在InitialSessionState中配置：

     initialState.ExecutionPolicy = ExecutionPolicy.Unrestricted;
     

  2. 确保运行C#程序的账户拥有读取PowerShell模块目录的权限

• 添加模块加载错误检查
  在PowerShell脚本中导入模块后，立即检查cmdlet是否存在，提前抛出明确错误：

  Import-Module -Name ExchangeOnlineManagement -ErrorAction Stop
  if (-not (Get-Command Connect-ExchangeOnline -ErrorAction SilentlyContinue)) {
      throw "Connect-ExchangeOnline cmdlet 未找到，请确认模块是否正确加载"
  }
  

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