MicrosoftTeams 2.0.0模块使用AccessToken认证后Cmdlet运行异常问题

KeyNotFoundException的触发逻辑完全来自MicrosoftTeams 2.0.0版本的内置令牌缓存缺陷：模块内部的AzureSessionProvider会用ConcurrentDictionary存储不同资源的访问令牌，对应两个固定资源键：

• https://graph.microsoft.com：供Teams核心Graph接口Cmdlet（比如Get-Team）使用
• https://api.interfaces.records.teams.microsoft.com：供Cs系列策略类Cmdlet（比如Get-CsTeamsCallingPolicy）的后端接口使用

使用-AadAccessToken参数连接时，模块仅会将你传入的单份令牌存入字典的Graph资源键，不会自动派生/拉取Cs接口对应的令牌条目，后续调用Cmdlet查找对应键时就会直接抛出字典键不存在的异常。后续出现的“未运行Connect-MicrosoftTeams就执行Cmdlet”的报错，全是令牌查找失败引发的连锁会话状态标记异常，不是真的没有完成连接。

• 手动在PowerShell终端复现操作时，只要单靠传入AccessToken连接，不管调用哪类Teams Cmdlet，都会触发字典查找报错
• 走交互式登录流程时所有Cmdlet能正常运行，是因为交互式连接阶段模块会自动完成全资源令牌拉取，自动填充字典的两个键值对，不会出现缺项
• 同一令牌传给Connect-AzureAD能正常工作，是因为AzureAD模块仅需单份Graph资源令牌，不需要额外的Cs接口令牌，不存在缺键场景

1. 升级MicrosoftTeams模块到3.0.0及以上正式版本
   2.0.0、2.0.1这类早期2.x版本的令牌缓存逻辑存在明确代码缺陷，3.0.0版本官方重写了AzureSession的缓存实现，支持单令牌传入时自动从已认证会话中派生所需资源的子令牌，彻底解决缺键问题。
   升级操作命令：

   # 管理员权限运行PowerShell执行
   Install-Module -Name MicrosoftTeams -RequiredVersion 4.9.2 -Force -AllowClobber
   

2. 适配2.x版本的令牌获取逻辑（无法升级时用）
   不要把授权码令牌的资源参数直接设为graph.windows.net，需要在申请授权码时补全Teams模块要求的全量权限范围，获取多份对应资源的令牌：

   // 替换原来的单资源参数配置
   string[] requiredScopes = new[] {
       "https://graph.microsoft.com/.default",
       "https://api.interfaces.records.teams.microsoft.com/.default",
       "openid", "profile"
   };
   // 调用AcquireTokenByAuthorizationCodeAsync时传入上述scopes，将获取到的令牌按资源键存入模块会话缓存
   

3. 临时绕开Cs Cmdlet的会话校验
   如果临时没法升级模块，在执行完Connect-MicrosoftTeams之后，手动给CsCmdlet的会话校验逻辑补全标记：

   # 连接完成后执行
   $global:__CsOnlineSession = $global:__MicrosoftTeamsSession
   

• 不要和已废弃的Skype for Business Online连接器模块混用，该模块和2.0.0以上版本的Teams模块存在底层会话存储冲突，会触发完全相同的字典查找异常
• C# Web应用中创建PowerShell实例时，不要在单次Invoke后销毁原runspace，模块的令牌缓存是存在runspace会话内的，新建PowerShell实例会丢失所有连接状态
• 传入的AccessToken必须是AAD v1端点签发的，v2端点签发的令牌即使scope完全匹配，也会被模块判定为无效，触发缓存查找异常

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