Azure DevOps迁移验证报错MsalClientException：需配置窗口句柄

问题概述 #

在将本地Azure DevOps Server 2022.1迁移至Azure DevOps Service的验证环节，执行Migrator.exe validate命令时触发MsalClientException，提示需要配置窗口句柄。日志显示异常源于调用Microsoft Graph时需要弹出交互式登录窗口，但服务器环境下无法获取有效窗口句柄。已尝试以管理员/普通用户身份在cmd、PowerShell运行命令，以及通过Connect-AzAccount认证后执行，问题仍存在。

解决步骤 #

• 在活跃桌面会话中执行命令
  确保操作在有完整桌面交互的会话中进行：不要使用无桌面的远程会话（如断开远程桌面后后台运行），保持远程桌面连接处于活跃状态，避免最小化远程窗口（部分远程工具会暂停桌面交互）。

• 强制使用设备代码流认证
  在验证命令中添加/authmode:DeviceCode参数，绕开本地窗口交互需求：

  Migrator.exe validate /collection:"http://localhost:8080/tfs/{Collection}" /region:{region} /output:"C:\temp" /tenantdomainname:{name} /authmode:DeviceCode
  

  执行后按照提示在任意浏览器中打开指定链接，输入设备代码完成认证即可。

• 检查用户交互式登录权限
  确认运行命令的用户拥有以下权限：

  1. 打开本地组策略编辑器，导航至计算机配置>Windows设置>安全设置>本地策略>用户权限分配
  2. 确保用户在允许本地登录和交互式登录列表中
  3. 若使用服务账号执行，需额外赋予其交互式登录权限（默认服务账号无此权限）

• 禁用WAM强制使用传统认证流程
  创建系统环境变量AZURE_DEVOPS_MIGRATOR_DISABLE_WAM=1，重启命令行窗口后重新执行验证命令。WAM在服务器环境下可能无法正常获取窗口句柄，禁用后会切换到兼容的认证方式。

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