通过 Windows 更新 for Business 报告配置脚本配置设备

项目
10/19/2023
适用于:

✅ Windows 11, ✅ Windows 10

建议使用 Windows 更新 for Business 报表配置脚本，将设备配置为将数据发送到 Microsoft 以用于 Windows 更新 for Business 报表。该脚本配置注册表项支持策略，确保所需的服务正在运行，等等。此脚本是配置“手动配置设备 for Windows 更新 for Business 报表中所述的所需策略的建议补充，因为它可以提供有关配置策略之外是否存在任何配置问题的反馈。

关于脚本

配置脚本直接配置注册表项。请注意，注册表项可能会被策略设置（例如组策略或 MDM）覆盖。 使用脚本重新配置设备不会重新配置以前设置的策略，无论是组策略还是 MDM。如果组策略或 MDM 配置与手动配置适用于企业的 Windows 更新报表中列出的所需配置之间存在冲突，则设备数据可能不会正确显示在 Windows 更新 for Business 报表中。

可以从 Microsoft 下载中心下载脚本。继续阅读，了解如何配置脚本并解释日志中输出的错误代码，以便进行故障排除。

如何组织此脚本

此脚本的两个主要文件是 ConfigScript.ps1 和 RunConfig.bat。根据本身的方向进行配置RunConfig.bat，随后ConfigScript.ps1将使用输入的参数运行RunConfig.bat。.bat 有两种使用脚本的方法：在试点模式或部署模式下。

重要提示

PsExec 用于在系统上下文中运行脚本。配置设备后，从设备中删除 PsExec.exe。

如何使用此脚本

RunConfig.bat编辑文件以配置以下变量，然后运行编辑的 .bat 文件：

变量	允许的值和说明	示例
runMode	试点 (默认) ：具有附加诊断和附加日志记录的详细模式。试点模式最适合用于脚本的测试运行或故障排除。部署：不运行任何其他诊断或添加额外的日志记录	`runMode=Pilot`
logPath	将保存日志的路径。日志的默认位置为 `.\UCLogs`。	`logPath=C:\temp\logs`
logMode	0：仅登录到主机 1 (默认) ：记录到文件和控制台。 2：仅记录到文件。	`logMode=2`
DeviceNameOptIn	true (默认) ：设备名称发送给 Microsoft。 false：设备名称不会发送到 Microsoft。	`DeviceNameOptIn=true`
ClientProxy	直接 (默认) ：不使用代理。与终结点的连接是直接的。系统：使用不带身份验证的系统代理。这种类型的代理通常使用 netsh 进行配置，可以使用进行验证 `netsh winhttp show proxy`。用户：代理是通过 IE 配置的，它可能要求用户身份验证，也可能不需要用户身份验证。有关详细信息，请参阅Windows 更新客户端如何确定用于连接到Windows 更新网站的代理服务器	`ClientProxy=Direct`
源	由 .bat 文件和 PowerShell 脚本用于查找依赖项。建议不要更改此值。	`source=%~dp0`

脚本错误

错误	描述
1	意外错误
12	CheckVortexConnectivity 失败，检查日志输出了解详细信息。
12	运行 CheckVortexConnectivity 时出现意外失败。
16	设备上正在等待重新启动。重启设备，然后重新运行脚本。
17	CheckRebootRequired 中的意外异常。
27	不是系统帐户。
30	无法禁用企业身份验证代理。此注册表值必须为 0，UTC 才能在经过身份验证的代理环境中运行。
34	尝试检查代理设置时出现意外异常。
35	检查用户代理时出现意外异常。
37	收集日志时出现意外异常。
40	检查和设置遥测时出现意外异常。
41	无法模拟登录用户。
42	尝试模拟登录用户时出现意外异常。
43	尝试模拟登录用户时出现意外异常。
44	运行 CheckDiagTrack 服务时出错。
45	找不到 DiagTrack.dll。
50	DiagTrack 服务未运行。
51	尝试运行 Census.exe 时出现意外异常。
52	找不到 Census.exe。
54	MICROSOFT 帐户登录助手 (禁用 MSA) 服务。
55	未能为 SetDeviceNameOptIn 创建新的注册表路径。
56	未能在注册表路径上为 SetDeviceNameOptIn 创建属性。
57	未能更新 SetDeviceNameOptIn 的值。
58	SetDeviceNameOptIn 中的意外异常。
59	尝试清理 OneSettings 时，未能删除注册表路径中的 LastPersistedEventTimeOrFirstBoot 属性。
60	尝试清理 OneSettings 时无法删除注册表项。
61	尝试清理 OneSettings 时出现意外异常。
62	AllowTelemetry 注册表项不是正确类型的REG_DWORD。
63	AllowTelemetry 未设置为适当的值，并且脚本无法设置该值。
64	AllowTelemetry 不是正确类型的REG_DWORD。
66	未能验证 UTC 连接和最近上传。
67	验证 UTC CSP 时出现意外失败。
99	设备未Windows 10或Windows 11。
100	设备必须Microsoft Entra联接或Microsoft Entra混合联接才能使用 Windows 更新 for Business 报表。
101	检查Microsoft Entra联接失败并出现意外异常。
102	不应启用 DisableOneSettingsDownloads 策略。请禁用此策略。

后续步骤

使用适用于企业的 Windows 更新报表

通过