相应的角色：管理员代理 | 销售代理
Microsoft 客户协议批量证明工具是一种控制台应用程序，旨在使合作伙伴能够证明客户接受Microsoft 客户协议。 本文档概述了该工具用户可能提出的一些常见问题。
常规
谁可以使用该工具执行操作？
合作伙伴中心中具有全局管理员或管理员代理角色的任何用户都可以使用该工具。
如果使用批量工具为客户证明，我多久才能看到合作伙伴中心针对客户反映的证明？
查看合作伙伴中心反映的证明的时间因工具的每个更新操作处理的客户数而异。 但是，所有成功的证明都应在四小时内反映在合作伙伴中心。
一次可以更新的客户记录的最大数量是多少？
CSV 文件中一次更新的客户记录数没有限制。 该工具在触发更新操作时处理所有可操作记录。 它为每个 API 调用合作伙伴中心最多批处理 500 个客户。 它会继续执行此批处理行为，直到所有可操作的客户协议记录都调度到合作伙伴中心。
如果我使用批量工具来证明，我的客户是否仍会收到一封电子邮件通知，告知我是否为他们证明？
是的，客户会收到你为其证明的电子邮件通知。 电子邮件通知将发送到主要联系人电子邮件地址。
我在一次证明中犯了一个错误。 如何实现修复数据，因为客户记录不再显示在提取的数据中？
可以使用合作伙伴中心或合作伙伴中心创建协议 API 来更新证明详细信息。 处理受影响的客户记录后，该工具将无法再成功提取/更新受影响的客户记录。
我尝试批量工具检索我的客户，我看不到其中一些。 为什么会这样？
并非所有客户都需要操作。 在 2023 年 4 月 1 日之前接受Microsoft 客户协议的客户必须尽快审查并接受新条款，以便与Microsoft保持最新协议。 批量工具的提取操作返回范围内的客户。 范围内的客户也会在其个人帐户页面上进行标记。
或者，还可以通过合作伙伴中心的客户的帐户页面确定哪些客户需要执行操作。 当需要协议操作时，客户帐户页上会显示一条通知。
我已将受影响的客户定向到Microsoft管理中心接受Microsoft客户协议，但他们看不到接受的选项或收到错误。 他们如何接受协议？
在某些情况下，客户无法直接接受 MCA。 在这种情况下，合作伙伴必须为客户提供证明。 有关详细信息，请参阅“如何确认客户已接受Microsoft 客户协议”。
故障排除指南和错误消息
在联系合作伙伴中心支持人员之前，如何获取有关错误的更多详细信息？
可以在工具根目录中的“日志”文件夹中查看日志文件。 日志文件名称的格式为： log_{MM-dd-yyyy_HH-mm-ss}.txt。
默认日志级别为 信息。 可以通过在运行该工具时传入运行时参数调试，将日志级别 更改为 Debug 。 例如，dotnet run -- debug。
下面列出了一系列常见错误及其解决方法。
异常消息：“未强制实施合作伙伴帐户”。
当用于运行该工具的帐户未在 MFA 中注册时，会发生此错误。 访问合作伙伴中心客户工作区 API 需要 MFA。 在 MFA 中注册帐户，然后重试。
如果合作伙伴组织以前通过Microsoft被授予 MFA 异常，请运行该工具 dotnet run -- noMfa 以绕过 MFA 检查。
身份验证错误：“AADSTS50011：请求中指定的重定向 URI'”http://localhost:(PORT)与为应用程序 ID 配置的重定向 URI 不匹配”
如果未正确配置应用程序的平台配置和/或其重定向 URI，则会发生此错误。 确保应用程序的重定向 URI 配置为包括在http://localhost移动和桌面应用程序平台上。
若要了解详细信息，请参阅Microsoft 客户协议批量证明工具：先决条件。
API 调用错误：“无法为状态代码为记录调度请求：（STATUS CODE）”
根据 API 调用的状态代码，错误消息可能会有所不同。 下面是一些常见的状态代码：
- 400 - 错误的请求。 当输入 CSV 文件中的数据出现问题时，通常会发生此错误。 可以在日志文件中找到更多详细信息。 例如，日志文件中的以下错误消息指示批量工具更新的客户协议记录中至少有一个电子邮件地址无效。
工具输出中所示的错误：
日志文件中显示的错误详细信息：
403 - 禁止访问。 当用于运行该工具的帐户没有执行操作的适当权限时，通常会发生此错误。 确保使用的帐户具有全局管理员或管理员代理角色
500 - 内部服务器错误。 当合作伙伴中心 API 出现问题时，通常会发生此错误。 请稍后再试，或联系合作伙伴中心支持人员以获取帮助。
相关内容
- 若要获取更多帮助，请与客户支持联系