在 Microsoft Intune 中排查并查看 Android Zebra 设备上的潜在问题

项目
09/11/2023

在 Microsoft Intune 中，可以使用 Zebra Mobility Extensions (MX) 来管理 Android Zebra 设备。使用 Zebra 设备时，可在 StageNow 中创建配置文件来管理设置，并将其上传到Intune。 Intune使用 StageNow 应用在设备上应用设置。 StageNow 应用还会在设备上创建用于故障排除的详细日志文件。

此功能适用于：

Android 设备管理员

例如，在 StageNow 中创建配置文件来配置设备。创建 StageNow 配置文件时，最后一步将生成一个文件，用于测试配置文件。可以在设备上通过 StageNow 应用使用此文件。

在另一个示例中，在 StageNow 中创建配置文件并对其进行测试。在Intune中添加 StageNow 配置文件，然后将其分配给 Zebra 设备。检查分配的配置文件的状态时，配置文件会显示高级状态。

在这两种情况下，都可以从每次应用 StageNow 配置文件时保存在设备上的 StageNow 日志文件中获取更多详细信息。

某些问题与 StageNow 配置文件的内容无关，并且不会反映在日志中。

本文介绍如何读取 StageNow 日志。它还列出了 Zebra 设备的一些潜在问题，这些问题可能不会反映在日志中。

重要

Microsoft Intune于 2024 年 8 月 30 日终止对有权访问 Google 移动服务的设备上的 Android 设备管理员管理的支持， (GMS) 。在此日期之后，设备注册、技术支持、bug 修复和安全修复将不可用。如果当前使用设备管理员管理，建议在支持结束之前切换到 Intune 中的另一个 Android 管理选项。有关详细信息，请阅读在 GMS 设备上终止对 Android 设备管理员的支持。

通过 Zebra 移动性扩展使用和管理 Zebra 设备，详细了解此功能。

获取日志

在设备上使用 StageNow 应用

无需使用 Intune 来部署配置文件。相反，可以使用计算机上的 StageNow 直接测试配置文件。设备上的 StageNow 应用保存测试中的日志。若要获取日志文件，请使用设备上的 StageNow 应用中的 “更多 (...) ”选项。

使用 Android 调试桥获取日志

若要使用 Intune 部署配置文件后获取日志，请将设备连接到具有 Android Debug Bridge (adb) 的计算机， (打开 Android 网站) 。

在设备上，日志保存在中 /sdcard/Android/data/com.microsoft.windowsintune.companyportal/files。

从电子邮件获取日志

若要使用 Intune 部署配置文件后获取日志，最终用户可以使用设备上的电子邮件应用通过电子邮件发送日志。在 Zebra 设备上，打开公司门户应用，然后发送日志。使用发送日志功能还会创建 PowerLift 事件 ID，如果联系 Microsoft 支持部门，可以参考该 ID。

读取日志

查看日志时，只要看到标记， <characteristic-error> 就会出现错误。错误详细信息将写入 <parm-error> 标记 >desc 属性。

错误类型

Zebra 设备包括不同的错误报告级别：

设备不支持 CSP。例如，设备不是手机网络设备，也没有手机网络管理器。
MX 或 OSX 版本不匹配。每个 CSP 都是版本控制。有关完整支持矩阵，请转到 Zebra 的文档 (打开 Zebra 网站) 。
设备报告另一个问题或错误。

示例

例如，你具有以下输入配置文件：

<wap-provisioningdoc>
    <characteristic type="Clock">
        <parm name="AutoTime" value="false"/>
        <parm name="TimeZone" value="GMT-5"/>
        <parm name="Date" value="2014-12-03"/>
        <parm name="Time" value="11:11:11"/>
    </characteristic>
</wap-provisioningdoc>

在日志中，XML 与输入相同。此匹配输出意味着配置文件已成功应用于设备，没有错误：

<wap-provisioningdoc>
    <characteristic type="Clock" version="6.0">
        <parm name="AutoTime" value="false"/>
        <parm name="TimeZone" value="GMT-5"/>
        <parm name="Date" value="2014-12-03"/>
        <parm name="Time" value="11:11:11"/>
    </characteristic>
</wap-provisioningdoc>

在另一个示例中，你具有以下输入：

<wap-provisioningdoc>
    <characteristic type="XmlMgr" version="4.2" >
        <parm name="ProcessingMode" value="1"/>
    </characteristic>
    <characteristic type="AppMgr" version="4.2" >
        <parm name="Action" value="Install"/>
        <parm name="APK" value="/sdcard/test.apk"/>
    </characteristic>
</wap-provisioningdoc>

日志显示错误，因为它包含标记 <characteristic-error> 。在此方案中，配置文件尝试安装给定路径中不存在的 Android 包 (APK) ：

<wap-provisioningdoc>
    <characteristic type="XmlMgr" version="4.2">
        <parm name="ProcessingMode" value="1"/>
    </characteristic>
    <characteristic-error type="AppMgr" version="5.1" desc="missing">
        <parm-error name="Action" value="Install" desc="apk doesnot exist in the path"/>
        <parm name="APK" value="/sdcard/test.apk"/>
    </characteristic-error>
</wap-provisioningdoc>

Zebra 设备的其他潜在问题

本部分列出了在设备管理员中使用 Zebra 设备时可能看到的其他可能问题。 StageNow 日志中不会报告这些问题。

Android 系统 WebView 已过期

当较旧的设备使用公司门户应用登录时，用户可能会看到一条消息，指出系统 WebView 组件已过期，需要升级：

如果设备已安装 Google Play，则将设备连接到 Internet，并检查更新。
如果设备未安装 Google Play，请获取组件的更新版本，并将其应用于设备。或者，更新到 Zebra 发布的最新设备 OS。

管理操作需要很长时间

如果 Google Play 服务不可用，则某些任务最多需要 8 小时才能完成。 Android Intune 公司门户应用的限制 (打开另一个 Microsoft 网站) 可能是一个很好的资源。

Intune中显示“可疑设备欺骗”

此错误意味着Intune怀疑非 Zebra Android 设备将其型号和制造商报告为 Zebra 设备。

公司门户应用早于所需的最低版本

Intune可能会更新公司门户应用的最低要求版本。如果设备上未安装 Google Play，则不会自动更新公司门户应用。如果所需的最低版本高于已安装的版本，则公司门户应用将停止工作。在 Zebra 设备上使用旁加载更新到最新的公司门户应用。

后续步骤

Zebra 讨论板 (打开 Zebra 网站)