Solucionar problemas e ver possíveis problemas em dispositivos Android Zebra em Microsoft Intune

Artigo
09/11/2023

Em Microsoft Intune, você pode usar o MX (Zebra Mobility Extensions) para gerenciar dispositivos Android Zebra. Ao usar dispositivos Zebra, você cria perfis no StageNow para gerenciar configurações e carregá-los para Intune. Intune usa o aplicativo StageNow para aplicar as configurações nos dispositivos. O aplicativo StageNow também cria um arquivo de log detalhado no dispositivo que é usado para solucionar problemas.

Esse recurso aplica-se a:

Administrador de dispositivo Android

Por exemplo, você cria um perfil no StageNow para configurar um dispositivo. Quando você cria o perfil StageNow, a última etapa gera um arquivo para você testar o perfil. Você consome esse arquivo com o aplicativo StageNow no dispositivo.

Em outro exemplo, você cria um perfil no StageNow e o testa. Em Intune, você adiciona o perfil StageNow e, em seguida, atribua-o aos dispositivos Zebra. Quando você marcar o status do perfil atribuído, o perfil mostra um status de alto nível.

Em ambos os casos, você pode obter mais detalhes do arquivo de log StageNow, que é salvo no dispositivo sempre que um perfil StageNow se aplica.

Alguns problemas não estão relacionados ao conteúdo do perfil StageNow e não são refletidos nos logs.

Este artigo mostra como ler os logs do StageNow. Ele também lista alguns problemas potenciais com dispositivos Zebra que podem não ser refletidos nos logs.

Importante

Microsoft Intune está encerrando o suporte para o gerenciamento de administrador de dispositivos Android em dispositivos com acesso ao GMS (Google Mobile Services) em 30 de agosto de 2024. Após essa data, o registro do dispositivo, o suporte técnico, as correções de bug e as correções de segurança não estarão disponíveis. Se você usar atualmente o gerenciamento de administrador de dispositivos, recomendamos mudar para outra opção de gerenciamento do Android no Intune antes do fim do suporte. Para obter mais informações, leia Fim do suporte para o administrador de dispositivos Android em dispositivos GMS.

Usar e gerenciar dispositivos Zebra com extensões de mobilidade zebra tem mais informações sobre esse recurso.

Obter os logs

Usar o aplicativo StageNow no dispositivo

Você não precisa usar Intune para implantar o perfil. Em vez disso, você pode testar um perfil diretamente usando o StageNow em seu computador. O aplicativo StageNow no dispositivo salva os logs do teste. Para obter o arquivo de log, use a opção Mais (...) no aplicativo StageNow no dispositivo.

Obter logs usando a Ponte de Depuração do Android

Para obter logs depois que o perfil for implantado com Intune, conecte o dispositivo a um computador com a Ponte de Depuração do Android (adb) (abre o site do Android).

No dispositivo, os logs são salvos em /sdcard/Android/data/com.microsoft.windowsintune.companyportal/files.

Obter logs por email

Para obter logs depois que o perfil for implantado com Intune, os usuários finais podem enviar por email os logs usando um aplicativo de email no dispositivo. No dispositivo Zebra, abra o aplicativo Portal da Empresa e envie os logs. O uso do recurso enviar logs também cria uma ID de incidente do PowerLift, que você pode referenciar se entrar em contato com o suporte da Microsoft.

Ler os logs

Quando você olha para os logs, há um erro sempre que você vê a <characteristic-error> marca. Os detalhes do erro são gravados na <parm-error> propriedade tag >desc .

Tipos de erro

Os dispositivos Zebra incluem diferentes níveis de relatório de erros:

O CSP não tem suporte no dispositivo. Por exemplo, o dispositivo não é um dispositivo celular e não tem um gerenciador de celular.
A versão MX ou OSX é incompatível. Cada CSP é versão. Para obter uma matriz de suporte completa, acesse a documentação da Zebra (abre o site da Zebra).
O dispositivo relata outro problema ou erro.

Exemplos

Por exemplo, você tem o seguinte perfil de entrada:

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

No log, o XML é idêntico à entrada. Essa saída correspondente significa que o perfil foi aplicado com êxito ao dispositivo sem erros:

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

Em outro exemplo, você tem a seguinte entrada:

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

O log mostra um erro, pois contém uma <characteristic-error> marca. Nesse cenário, o perfil tentou instalar um APK (pacote Android) que não existe no caminho determinado:

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

Outros problemas potenciais com dispositivos Zebra

Esta seção lista outros possíveis problemas que você pode ver ao usar dispositivos Zebra com o Administrador de Dispositivos. Esses problemas não são relatados nos logs do StageNow.

O Android System WebView está desatualizado

Quando dispositivos mais antigos entrarem usando o aplicativo Portal da Empresa, os usuários poderão ver uma mensagem de que o componente do System WebView está desatualizado e precisa ser atualizado:

Se o dispositivo tiver o Google Play instalado, conecte o dispositivo à Internet e marcar para atualizações.
Se o dispositivo não tiver o Google Play instalado, obtenha a versão atualizada do componente e aplique-o aos dispositivos. Ou atualize para o sistema operacional de dispositivo mais recente emitido pela Zebra.

As ações de gerenciamento levam muito tempo

Se os serviços do Google Play não estiverem disponíveis, algumas tarefas levarão até 8 horas para serem concluídas. Limitações de Portal da Empresa do Intune aplicativo para Android (abre outro site da Microsoft) podem ser um bom recurso.

"Falsificação de dispositivos suspeitos" é exibida em Intune

Esse erro significa que Intune suspeita que um dispositivo Android não Zebra esteja relatando seu modelo e fabricante como um dispositivo Zebra.

Portal da Empresa aplicativo é mais antigo que a versão mínima necessária

Intune pode atualizar a versão mínima necessária do aplicativo Portal da Empresa. Se o Google Play não estiver instalado no dispositivo, o aplicativo Portal da Empresa não será atualizado automaticamente. Se a versão mínima necessária for mais recente que a versão instalada, o aplicativo Portal da Empresa deixará de funcionar. Atualize para o aplicativo Portal da Empresa mais recente usando sideload em dispositivos Zebra.

Próximas etapas

Painéis de discussão zebra (abre o site da Zebra)

Usar e gerenciar dispositivos Zebra com extensões de mobilidade zebra em Intune