通过适用于企业的 Windows 更新报告配置脚本配置设备
建议使用适用于企业的 Windows 更新报告配置脚本,将设备配置为将数据发送到Microsoft,以便与适用于企业的 Windows 更新报表配合使用。 该脚本配置注册表项支持策略,确保所需的服务正在运行,等等。 对于手动 配置适用于企业的 Windows 更新报表中所述的所需策略,此脚本是建议的补充,因为它可以提供有关配置策略之外是否存在任何配置问题的反馈。
关于脚本
配置脚本直接配置注册表项。 组策略或 MDM 等策略设置可能会覆盖注册表项。 使用脚本重新配置设备不会重新配置以前设置的策略,无论是组策略还是 MDM。 如果组策略或 MDM 配置与 手动配置适用于企业的 Windows 更新报表中列出的必需配置之间存在冲突,则设备数据可能不会正确显示在适用于企业的 Windows 更新报告中。
可以从 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 更新报表。 |
101 | 检查Microsoft Entra 联接失败并出现意外异常。 |
102 | 不应启用 DisableOneSettingsDownloads 策略。 请禁用此策略。 |