Connect-PowerBIServiceAccount异常：Windows服务器认证失败求助

使用PowerShell 7.x环境下的MicrosoftPowerBIMgmt v1.2.1111模块，通过服务主体证书认证Power BI时，笔记本操作完全正常，但Windows服务器执行相同步骤后出现错误：failed to populate environments in settings。已尝试复用有效证书、强制启用TLS1.2、重装模块等操作，问题仍未解决。

• 验证证书存储位置与权限
  确保.pfx证书导入到CurrentUser\My证书存储，而非LocalMachine。执行以下命令确认证书存在：

  Get-ChildItem -Path Cert:\CurrentUser\My | Where-Object {$_.Thumbprint -eq "你的证书指纹"}
  

  若证书存在但仍报错，检查运行PowerShell的用户是否拥有证书读取权限：右键证书→所有任务→管理私钥，添加对应用户并授予读取权限。

• 检查PowerShell执行策略
  服务器执行策略过严可能阻碍模块加载配置。执行命令查看当前策略：

  Get-ExecutionPolicy
  

  若为Restricted，临时调整为RemoteSigned（测试完成后可改回）：

  Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
  

  重新导入模块后重试认证：

  Import-Module MicrosoftPowerBIMgmt -Force
  Connect-PowerBIServiceAccount -ServicePrincipal -Tenant "my-tenant" -ApplicationId "my-app-id" -CertificateThumbprint "你的证书指纹"
  

• 排查代理与网络访问细节
  即使443端口连通，服务器代理配置可能未被PowerShell识别。检查系统代理设置，若存在代理，添加环境变量后重启PowerShell：

  $env:HTTPS_PROXY = "http://你的代理地址:端口"
  $env:HTTP_PROXY = "http://你的代理地址:端口"
  

  也可直接测试Power BI API的连通性：

  Invoke-RestMethod -Uri "https://api.powerbi.com/v1.0/myorg/groups" -Method Get -Headers @{"Authorization" = "Bearer $((Get-PowerBIAccessToken).Token)"}
  

• 确认服务主体权限与租户同步
  重新检查MS Entra中服务主体的角色分配：确保已分配Power BI Service Administrator角色，且权限范围为整个租户。若刚修改权限，等待15-30分钟让权限同步后重试。

• 清理旧模块残留并重装指定版本
  服务器可能存在旧版本模块冲突，先卸载所有版本：

  Uninstall-Module MicrosoftPowerBIMgmt -AllVersions -Force
  

  再重装指定版本：

  Install-Module MicrosoftPowerBIMgmt -RequiredVersion 1.2.1111 -Force -AllowClobber
  

• 启用调试日志定位具体错误
  开启模块调试模式获取详细错误信息：

  Set-PowerBIContext -Debug
  Connect-PowerBIServiceAccount -ServicePrincipal -Tenant "my-tenant" -ApplicationId "my-app-id" -CertificateThumbprint "你的证书指纹"
  

  同时查看模块日志文件（默认路径：C:\Users\<用户名>\AppData\Local\Microsoft\PowerBI\Cmdlets\Logs），日志中会记录API调用的具体响应，帮助定位是认证失败、环境拉取失败还是其他问题。

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