对 Microsoft Intune 中的 Android Zebra 设备进行故障排除并查看出现的潜在问题Troubleshoot and see potential issues on Android Zebra devices in Microsoft Intune

在 Microsoft Intune 中,可以使用 Zebra Mobility Extensions (MX) 来管理 Android Zebra 设备In Microsoft Intune, you can use Zebra Mobility Extensions (MX) to manage Android Zebra devices. 使用 Zebra 设备时,可以在 StageNow 中创建配置文件以管理设置,并将其上传到 Intune。When using Zebra devices, you create profiles in StageNow to manage settings, and upload them to Intune. Intune 使用 StageNow 应用在设备上应用设置。Intune uses the StageNow app to apply the settings on the devices. StageNow 应用还会在设备上创建用于进行故障排除的详细日志文件。The StageNow app also creates a detailed log file on the device that's used to troubleshoot.

此功能适用于:This feature applies to:

  • AndroidAndroid

例如,在 StageNow 中创建配置文件以配置设备。For example, you create a profile in StageNow to configure a device. 创建 StageNow 配置文件时,最后一步会生成一个用于测试配置文件的文件。When you create the StageNow profile, the last step generates a file for you test the profile. 可以通过设备上的 StageNow 应用使用此文件。You consume this file with the StageNow app on the device.

再举一个例子,在 StageNow 中创建一个配置文件,并对其进行测试。In another example, you create a profile in StageNow, and test it. 在 Intune 中,添加 StageNow 配置文件,然后将其分配给 Zebra 相关设备。In Intune, you add the StageNow profile, and then assign it to your Zebra devices. 检查分配的配置文件的状态时,配置文件将显示概要状态。When checking the status of the assigned profile, the profile shows a high-level status.

在这两种情况下,你都可以从 StageNow 日志文件中获取更多详细信息,该文件在每次应用 StageNow 配置文件时都会保存在设备上。In both these cases, you can get more details from the StageNow log file, which is saved on the device every time a StageNow profile applies.

有些问题与 StageNow 配置文件的内容不相关,这些问题不会显示在日志中。Some issues aren't related to the contents of the StageNow profile, and aren't reflected in the logs.

本文介绍了如何读取 StageNow 日志,并列出了可能不会在日志中显示的 Zebra 设备的一些其他潜在问题。This article shows you how to read the StageNow logs, and lists some other potential issues with Zebra devices that may not be reflected in the logs.

有关此功能的详细信息,请参阅通过 Zebra Mobility Extensions 使用和管理 Zebra 设备Use and manage Zebra devices with Zebra Mobility Extensions has more information on this feature.

获取日志Get the logs

在设备上使用 StageNow 应用Use the StageNow app on the device

当你在计算机上直接使用 StageNow 测试配置文件,而不是使用 Intune 部署配置文件时,设备上的 StageNow 应用将保存测试中的日志。When you test a profile directly using StageNow on your computer in, instead of using Intune to deploy the profile, the StageNow app on the device saves the logs from the test. 若要获取日志文件,请使用设备上的 StageNow 应用中的“更多(…)”选项 。To get the log file, use the More (...) option in the StageNow app on the device.

使用 Android Debug Bridge 获取日志Get logs using Android Debug Bridge

要在通过 Intune 部署配置文件后获取日志,请使用 Android Debug Bridge (adb)(打开 Android 网站)将设备连接到计算机。To get logs after the profile is already deployed with Intune, connect the device to a computer with Android Debug Bridge (adb) (opens Android's web site).

在设备上,日志保存在 /sdcard/Android/data/com.microsoft.windowsintune.companyportal/filesOn the device, logs are saved in /sdcard/Android/data/com.microsoft.windowsintune.companyportal/files

通过电子邮件获取日志Get logs from email

要在通过 Intune 部署配置文件后获取日志,最终用户可以使用设备上的电子邮件应用通过电子邮件向你发送日志。To get logs after the profile is already deployed with Intune, end users can email you the logs using an email app on the device. 在 Zebra 设备上,打开公司门户应用,然后发送日志On the Zebra device, open the Company Portal app, and send the logs. 使用发送日志功能还会创建 PowerLift 事件 ID,如需与 Microsoft 支持部门联系,可参考此 ID。Using the send logs feature also creates a PowerLift incident ID, which you can reference if contacting Microsoft support.

读取日志Read the logs

查看日志时,每当查看 <characteristic-error> 标记时都会出错。When looking at the logs, there's an error whenever you see the <characteristic-error> tag. 错误详细信息将写入 <parm-error> 标记 > desc 属性中。Error details are written to the <parm-error> tag > desc property.

错误类型Error types

Zebra 设备包括不同的错误报告级别:Zebra devices include different error reporting levels:

  • 设备上不支持 CSP。The CSP isn't supported on device. 例如,设备不是移动设备,也没有移动电话管理器。For example, the device isn't a cellular device and doesn't have a cellular manager.
  • MX 或 OSX 版本不匹配。The MX or OSX version is mismatched. 每个 CSP 都会纳入版本控制。Each CSP is versioned. 有关完整的支持矩阵,请参阅 Zebra 的文档(打开 Zebra 的网站)。For a full support matrix, see Zebra's documentation (opens Zebra's web site).
  • 设备报告其他问题或错误。The device reports another issue or error.

示例Examples

例如,你拥有以下输入配置文件:For example, you have the following input profile:

<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 与输入完全相同。In the log, the XML is identical to the input. 此匹配的输出表示配置文件已成功应用于设备且没有出错:This matching output means the profile successfully applied to the device with no errors:

<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>

再例如,你具有以下输入:In another example, you have the following input:

<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> 标记。The log shows an error, as it contains a <characteristic-error> tag. 在此场景中,配置文件尝试安装给定路径中不存在的 Android 包 (APK):In this scenario, the profile tried to install an Android package (APK) that doesn't exist in the given path:

<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 设备的其他潜在问题Other potential issues with Zebra devices

本部分列出了设备管理员在使用 Zebra 设备时可能会遇到的其他问题。This section lists other possible issues you may see when using Zebra devices with Device Administrator. StageNow 日志中不报告这些问题。These issues aren't reported in the StageNow logs.

Android System WebView 已过时Android System WebView is out of date

当旧设备使用公司门户应用登录时,用户可能会看到一条消息,该消息指出 System WebView 组件已过时,需要升级。When older devices sign in using the Company Portal app, users may see a message that the System WebView component is out of date, and needs upgraded. 如果设备已安装 Google Play,请将其连接到 Internet,然后检查更新。If the device has Google Play installed, connect it to the internet, and check for updates. 如果设备未安装 Google Play,请获取组件的更新版本,然后将其应用于设备。If the device doesn't have Google Play installed, get the updated version of the component, and apply it to the devices. 或者,更新到 Zebra 发布的最新设备 OS。Or, update to the latest device OS issued by Zebra.

管理操作需要很长时间Management actions take a long time

如果 Google Play 服务不可用,则一些任务最多需要 8 个小时才能完成。If Google Play services aren't available, some tasks take up to 8 hours to finish. 适用于 Android 的 Intune 公司门户应用的限制(打开另一个 Microsoft 网站)可能是不错的资源。Limitations of Intune Company Portal app for Android (opens another Microsoft web site) may be a good resource.

Intune 中显示“设备涉嫌欺骗”"Device spoofing suspected" shows in Intune

此错误表示,Intune 怀疑某个非 Zebra 的 Android 设备将其模型和制造商报告为 Zebra 设备。This error means that Intune suspects a non-Zebra Android device is reporting its model and manufacturer as a Zebra device.

公司门户应用的版本低于所需的最低版本Company Portal app is older than minimum required version

Intune 可能会更新公司门户应用所需的最低版本。Intune may update the minimum required version of the Company Portal app. 如果设备上未安装 Google Play,则公司门户应用不会自动更新。If Google Play isn't installed on the device, the Company Portal app doesn't get automatically updated. 如果所需的最低版本比安装的版本更高,则公司门户应用将停止运行。If the minimum required version is newer than the installed version, the Company Portal app stops working. 使用 Zebra 设备上的旁加载更新到最新的公司门户应用。Update to the latest Company Portal app using sideloading on Zebra devices.

后续步骤Next steps

Zebra 讨论板(打开 Zebra 的网站)Zebra discussion boards (opens Zebra's web site)

通过 Intune 中的 Zebra Mobility Extensions 使用和管理 Zebra 设备Use and manage Zebra devices with Zebra Mobility Extensions in Intune