VMware Workspace ONE 置备工具 允许您测试 出厂置备 配置文件、配置工具设置以及使用命令行操作来运行测试。您还可以收集日志以帮助对工具问题进行故障排除。

导航

命令行操作

您可以选择使用命令行操作来运行测试。

表 1. VMware Workspace ONE 置备工具 命令行操作
命令行操作 说明
-a、--action 必需。要执行的操作(AppsOnly、Full 或 TrackOnly)。
-p、--ppkg 必需。PPKG 文件路径。
-u、--unattend 无人参与 XML 文件路径。
-s、--shutdown 在 Sysprep 命令完成运行后关闭计算机。
-r、--reboot 在 Sysprep 后重新启动计算机。您可以使用此选项审核计算机并验证首次运行体验是否正常运行。如果未指定任何选项,则默认情况下该工具会重新引导。
-q、--quit 在 Sysprep 完成运行命令后,会关闭 Sysprep 工具而不重新引导或关闭设备。
-g、--gui 使用 GUI 运行应用程序。

默认值为 false

-l、--autologin 在重新引导后启用自动登录。

默认值为 false

-n、--username 自动登录的用户名。
-w、--password 用于自动登录的密码。
--help 显示帮助屏幕。
--version 显示版本信息。
运行操作后,将显示退出代码。这些代码报告操作的结果。退出代码如下所示:
  • 0 - 成功
  • 1 - 故障
  • 2 - 需要重新引导
  • 3 - 超时
一些示例包括:
  • 显示帮助屏幕:VMwareWS1ProvisioningTool --help
  • 仅应用应用程序 (PPKG):VMwareWS1ProvisioningTool -a appsonly -p "C:\MyProvisioningPackage.ppkg"
  • 应用完整进程(ppkg 和 XML)- 结束时关闭系统:VMwareWS1ProvisioningTool -a full -p "C:\MyProvisioningPackage.ppkg" -u "C:\MyAnswer.xml" -s
  • 应用完整进程(PPKG 和 XML)- 结束时重新引导系统:VMwareWS1ProvisioningTool -a full -p "C:\MyProvisioningPackage.ppkg" -u "C:\MyAnswer.xml" -r
  • 仅使用 GUI 跟踪应用程序队列:VMwareWS1ProvisioningTool -a trackonly --gui
  • 在启用自动登录的情况下使用 GUI 跟踪应用程序队列:VMwareWS1ProvisioningTool -a trackonly --gui --autologin -n myuser -w mypassword

VMware Workspace ONE 置备工具 配置选项

您可以更改 VMware Workspace ONE 置备工具 的配置设置以满足您的需求。要更改设置,您必须编辑 VMwareWS1ProvisioningTool.exe.config 文件。

配置文件包含控制 VMware Workspace ONE 置备工具 如何运行的设置。以下是应考虑的一些常用设置。在配置文件中可找到更多设置。请考虑查看以下设置以满足您的需求。
表 2. VMware Workspace ONE 置备工具 配置设置
设置 说明
loggingConfiguration 输入文件路径、日志记录级别、文件大小和存档文件的最大数量。

level= 值控制日志级别。默认值为 "Information"。要进行故障排除,请考虑将级别更改为 "Verbose"

"TimeoutMinutes" 以分钟为单位输入一个值,表示该工具在超时前可尝试应用 PPKG 的时间长度。请考虑将此值设置为 90 分钟以下。
"RefreshRateSeconds" 以秒为单位输入一个值,表示该工具刷新 PPKG 安装进度的频率。
"BitLockerDecryptionTimeoutMinutes" 以分钟为单位输入一个值,表示该工具在超时之前等待 BitLocker 解密完成的时间。
"UnattendXmlCleanup" 设置为 True 时,将在对设备进行注册预备后从系统驱动器中移除源未纳管的 XML 文件。如果设备上没有未纳管的 XML,则仅复制文件。
"PpkgCleanup" 在 v2.2 中添加 设置为 true 时,将删除指定清理文件路径中的所有 PPKG 文件。
"PpkgCleanupPath" 在 v2.2 中添加 输入文件路径以在进行注册预备后清理所有 PPKG。具有 PPKG 扩展名的所有文件都将被删除。

读取 PPKG 最终摘要日志

VMware Workspace ONE 置备工具 完成将 PPKG 应用到设备后,系统会生成摘要日志。您可以在 C:\ProgramData\Airwatch\UnifiedAgent\Logs\PPKGFinalSummary.log 中找到日志。这些日志对进行故障排除非常有用。如果在置备设备时出现问题,Dell 可能会要求提供这些日志。

日志包含操作系统详细信息、客户端网络详细信息、设备型号和制造商以及 PPKG 详细信息等重要信息。如果未将设备设置为审核模式,则将在日志中进行备注,以帮助对进程失败的原因进行故障排除。您还可以查看处理过程中该工具中显示的状态更新的日志。

有关对故障进行故障排除的日志

VMware Workspace ONE 置备工具 会在工具出现故障后收集信息。该工具会收集日志,并将其存储到计算机用户的 Users\<username>\AppData\Local\Temp\DiagnosticsDiagnostics 文件夹中。

该工具会收集列出的日志。
  • 在计算机的 C:\ProgramData\Airwatch\UnifiedAgent\Logs 中找到的 Logs 文件夹的 ZIP 文件,其中包含 PPKGFinalSummary.log 文件。
  • 在计算机的 C:\ProgramData\AwProvAgent 中找到的 AwProvAgent 文件夹的 ZIP 文件。
  • 在计算机的 C:\ProgramData\VMware 中找到的 VMware 文件夹的 ZIP 文件。
  • 在计算机的 C:\ProgramData\AirWatchMDM\Support 中找到的 Support 文件夹的 ZIP 文件。
  • 在计算机的 C:\ProgramData\AirWatchMDM\Support\WINDIR\system32\AirWatchMDM.tmf 中找到的 AirWatchMDM.tmf 文件。
该工具会从计算机收集注册表项和值。
  • HKLM\SOFTWARE\AIRWATCH
  • HKML\SOFTWARE\AirWatchMDM
  • HKLM\SOFTWARE\Microsoft\EnterpriseDesktopAppManagement
  • HKLM\SOFTWARE\Microsoft\Provisioning\OMADM\Accounts
  • HKLM\SOFTWARE\Microsoft\Provisioning\OMADM\MDMDeviceID
该工具会收集工具的 事件查看器中列出的服务的事件日志文件。
  • 在查看器的事件查看器 > 应用程序和服务日志 > AirWatch 中找到的 AirWatch 事件文件。
  • 在查看器的事件查看器 > 应用程序和服务日志 > AirWatch 置备代理 > 操作中找到的置备服务事件文件。
  • 在查看器的事件查看器 > 应用程序和服务日志 > Microsoft > Windows > 设备管理企业诊断提供程序 > 管理员中找到的设备管理事件文件。