Felsöka och se potentiella problem på Android Zebra-enheter i Microsoft Intune

  • Artikel

I Microsoft Intune kan du använda Zebra Mobility Extensions (MX) för att hantera Android Zebra-enheter. När du använder Zebra-enheter skapar du profiler i StageNow för att hantera inställningar och ladda upp dem till Intune. Intune använder StageNow-appen för att tillämpa inställningarna på enheterna. StageNow-appen skapar också en detaljerad loggfil på enheten som används för att felsöka.

Den här funktionen gäller för:

  • Android-enhetsadministratör

Du kan till exempel skapa en profil i StageNow för att konfigurera en enhet. När du skapar StageNow-profilen genererar det sista steget en fil där du kan testa profilen. Du använder den här filen med StageNow-appen på enheten.

I ett annat exempel skapar du en profil i StageNow och testar den. I Intune lägger du till StageNow-profilen och tilldelar den sedan till dina Zebra-enheter. När du kontrollerar statusen för den tilldelade profilen visar profilen en status på hög nivå.

I båda dessa fall kan du få mer information från StageNow-loggfilen, som sparas på enheten varje gång en StageNow-profil tillämpas.

Vissa problem är inte relaterade till innehållet i StageNow-profilen och återspeglas inte i loggarna.

Den här artikeln visar hur du läser StageNow-loggarna. Den visar också några potentiella problem med Zebra-enheter som kanske inte återspeglas i loggarna.

Viktigt

Microsoft Intune upphör stödet för hantering av Android-enhetsadministratörer på enheter med åtkomst till Google Mobile Services (GMS) den 30 augusti 2024. Efter det datumet är enhetsregistrering, teknisk support, felkorrigeringar och säkerhetskorrigeringar otillgängliga. Om du för närvarande använder hantering av enhetsadministratörer rekommenderar vi att du växlar till ett annat Android-hanteringsalternativ i Intune innan supporten upphör. Mer information finns i Avsluta stöd för Android-enhetsadministratör på GMS-enheter.

Mer information om den här funktionen finns i Använda och hantera Zebra-enheter med Zebra Mobility Extensions.

Hämta loggarna

Använda StageNow-appen på enheten

Du behöver inte använda Intune för att distribuera profilen. I stället kan du testa en profil direkt med StageNow på datorn. StageNow-appen på enheten sparar loggarna från testet. Om du vill hämta loggfilen använder du alternativet Mer (...) i Appen StageNow på enheten.

Hämta loggar med Hjälp av Android Debug Bridge

Om du vill hämta loggar efter att profilen har distribuerats med Intune ansluter du enheten till en dator med Android Debug Bridge (adb) (öppnar Androids webbplats).

På enheten sparas loggarna i /sdcard/Android/data/com.microsoft.windowsintune.companyportal/files.

Hämta loggar från e-post

För att få loggar när profilen har distribuerats med Intune kan slutanvändarna skicka loggarna via e-post via en e-postapp på enheten. Öppna appen Företagsportal på Zebra-enheten och skicka loggarna. Med funktionen skicka loggar skapas även ett PowerLift-incident-ID, som du kan referera till om du kontaktar Microsofts support.

Läsa loggarna

När du tittar på loggarna uppstår ett fel när du ser taggen <characteristic-error> . Felinformation skrivs till taggegenskapen <parm-error>>desc .

Feltyper

Zebra-enheter innehåller olika felrapporteringsnivåer:

  • CSP:n stöds inte på enheten. Enheten är till exempel inte en mobil enhet och har ingen mobilhanterare.
  • MX- eller OSX-versionen är felmatchad. Varje CSP är versionshanterad. En fullständig supportmatris finns i Zebras dokumentation (öppnar Zebras webbplats).
  • Enheten rapporterar ett annat problem eller fel.

Exempel

Du har till exempel följande indataprofil:

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

I loggen är XML-koden identisk med indata. Den här matchande utdatan innebär att profilen har tillämpats på enheten utan fel:

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

I ett annat exempel har du följande indata:

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

Loggen visar ett fel eftersom den innehåller en <characteristic-error> tagg. I det här scenariot försökte profilen installera ett Android-paket (APK) som inte finns i den angivna sökvägen:

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

Andra potentiella problem med Zebra-enheter

Det här avsnittet innehåller andra möjliga problem som kan uppstå när du använder Zebra-enheter med enhetsadministratör. Dessa problem rapporteras inte i StageNow-loggarna.

Android System WebView är inaktuell

När äldre enheter loggar in med Företagsportal app kan användarna se ett meddelande om att System WebView-komponenten är inaktuell och behöver uppgraderas:

  • Om enheten har Google Play installerat ansluter du enheten till Internet och söker efter uppdateringar.
  • Om enheten inte har Google Play installerat hämtar du den uppdaterade versionen av komponenten och tillämpar den på enheterna. Eller uppdatera till det senaste enhetsoperativsystemet som utfärdats av Zebra.

Hanteringsåtgärder tar lång tid

Om Google Play-tjänster inte är tillgängliga tar vissa uppgifter upp till 8 timmar att slutföra. Begränsningar för Intune-företagsportal app för Android (öppnar en annan Microsoft-webbplats) kan vara en bra resurs.

"Misstänkt förfalskning av enhet" visas i Intune

Det här felet innebär att Intune misstänker att en Android-enhet som inte är zebra rapporterar sin modell och tillverkare som en Zebra-enhet.

Företagsportal app är äldre än den lägsta version som krävs

Intune kan uppdatera den lägsta nödvändiga versionen av Företagsportal-appen. Om Google Play inte är installerat på enheten uppdateras inte Företagsportal-appen automatiskt. Om den lägsta version som krävs är nyare än den installerade versionen slutar Företagsportal-appen att fungera. Uppdatera till den senaste Företagsportal appen med separat inläsning på Zebra-enheter.

Nästa steg

Zebra-diskussionstavlor (öppnar Zebras webbplats)

Använda och hantera Zebra-enheter med Zebra Mobility Extensions i Intune