> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/automatizacao/runbooks/runbook-references/org/devices/list-mobile-devices.md).
# Listar dispositivos móveis
Listar dispositivos móveis geridos com inventário e detalhes de rede
### Descrição
Lista todos os dispositivos Android, iOS e iPadOS geridos pelo Intune com o respetivo inventário: IMEI, número de série, número de telefone, operadora, propriedade, conformidade e inscrição. Opcionalmente, são adicionados o último endereço IP reportado e a sub-rede, ICCID, identificador eSIM, tecnologia celular, UDID, saúde da bateria e estado de iPad partilhado. Isto mostra em que redes os dispositivos estiveram ativos pela última vez. A lista pode ser limitada pela plataforma, por um grupo de dispositivos ou por um grupo dos utilizadores principais. O relatório pode ser enviado por e-mail ou fornecido como uma ligação de transferência.
### Casos de uso comuns
* Inventário de todos os dispositivos móveis, incluindo IMEI, número de série, número de telefone e operadora
* Identificar em que redes (Wi‑Fi) os dispositivos móveis estiveram ativos pela última vez, por exemplo, scanners portáteis em localizações de armazém
* Rever o estado de conformidade, supervisão e encriptação da frota móvel
* Inventário de SIM/eSIM através de ICCID e identificador eSIM
* Entregar o inventário móvel completo à gestão de ativos como uma pasta de trabalho do Excel ou um ficheiro CSV
### Colunas de saída
Cada execução escreve uma **Resumo** tabela (contagens de dispositivos por plataforma, dispositivos não conformes e de propriedade pessoal e - com os detalhes de rede ativados - o número de dispositivos sem um endereço IP reportado) e até três tabelas de dispositivos no separador Dados de saída do portal RealmJoin. A saída da consola mostra as mesmas contagens, mais a repartição por estado de conformidade e propriedade e os filtros aplicados. Os mesmos dados também podem ser entregues como ficheiros de relatório por e-mail e/ou como uma ligação de transferência, consulte a secção sobre entrega de relatórios abaixo.
#### Inventário (sempre mostrado)
| Coluna | Origem e significado |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Nome do dispositivo | Nome do dispositivo conforme reportado pelo Intune |
| Utilizador principal | Nome principal do utilizador |
| Sistema operativo / Versão do SO | Sistema operativo (Android, iOS, iPadOS) e versão |
| Fabricante / Modelo | Fabricante e modelo do hardware |
| Número de série | Número de série do hardware |
| IMEI | Identificador Internacional de Equipamento Móvel do dispositivo |
| PhoneNumber | Número de telefone do SIM - apenas presente quando `Incluir número de telefone` está ativado, caso contrário a coluna é omitida totalmente |
| Operadora | Operadora do assinante do SIM |
| Propriedade | `empresa` ou `pessoal` |
| Conformidade | Estado de conformidade do Intune |
| Última sincronização | Carimbo de data/hora do último check-in bem-sucedido do Intune |
#### Segurança e inscrição (sempre mostrado)
| Coluna | Origem e significado |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Supervisionado | modo supervisionado do iOS/iPadOS |
| Encriptado | Estado de encriptação do dispositivo |
| Com jailbreak | Se o dispositivo tem jailbreak ou root |
| Estado de ameaça | Estado de ameaça reportado por um parceiro de Mobile Threat Defense (só faz sentido quando um parceiro MTD está ligado) |
| Nível do patch | Nível do patch de segurança do Android (vazio em iOS/iPadOS) |
| Tipo de inscrição / Perfil de inscrição | Como o dispositivo foi inscrito e o perfil de inscrição utilizado |
| Categoria | Categoria do dispositivo no Intune |
| GB livres / GB totais | Armazenamento livre e total (vazio quando o dispositivo não reporta inventário de armazenamento utilizável, comum em perfis de trabalho do Android Enterprise) |
| Inscrito | Data de inscrição |
#### Rede e SIM (apenas com `Incluir detalhes de rede` ativado - desativado por predefinição)
| Coluna | Origem e significado |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| IPv4 / sub-rede | Último endereço IP e sub-rede reportados pelo dispositivo - o indicador mais próximo da rede (Wi‑Fi) em que o dispositivo esteve ativo pela última vez |
| MAC Wi‑Fi | Endereço MAC Wi‑Fi do dispositivo |
| ICCID | Número de identificação único do cartão SIM |
| eSIM | identificador eSIM, quando um eSIM está aprovisionado |
| Celular | Tecnologia celular do dispositivo |
| UDID | Identificador único do dispositivo (iOS/iPadOS) |
| Saúde da bateria | Percentagem de saúde da bateria, quando reportada |
| Partilhado | Se o dispositivo é um iPad partilhado |
| Última sincronização | Carimbo de data/hora do último check-in bem-sucedido do Intune - indica quão antiga é a informação de IP |
Esta tabela está ordenada por sub-rede, pelo que os dispositivos ficam visualmente agrupados pela rede em que foram vistos pela última vez.
### Atualidade dos dados e limitações
Todos os valores descrevem o estado do último check-in bem-sucedido do dispositivo no Intune, não necessariamente o estado atual - interprete-os sempre em conjunto com a coluna LastSync. O Intune não reporta o SSID Wi‑Fi de um dispositivo; o último endereço IP e a sub-rede são o indicador de rede mais próximo. Note que o endereço IP reportado também pode provir de uma ligação celular quando o dispositivo fez o último check-in através de dados móveis. O Intune mascara parcialmente o número de telefone dos dispositivos de propriedade pessoal, independentemente da `Incluir número de telefone` definição.
### Considerações de desempenho
Os detalhes de rede/SIM estão desativados por predefinição e devem ser ativados com cuidado em Tenant de grande dimensão ou com muitos dispositivos móveis: o Microsoft Graph devolve estes valores apenas num pedido de um único dispositivo, não na resposta da lista de dispositivos. O runbook envia sempre estes pedidos através do endpoint de lote do Graph em blocos de até 20, mas o tempo de execução continua a crescer linearmente com o número de dispositivos - milhares de dispositivos móveis significam execuções correspondentemente longas e um risco acrescido de throttling do Graph (os pedidos sujeitos a throttling são repetidos automaticamente com o tempo de espera reportado pelo Graph). Em ambientes de grande dimensão, combine `Incluir detalhes de rede` com os filtros de âmbito de grupo.
### Filtragem de âmbito
O âmbito pode ser limitado aos membros de um grupo de dispositivos do Entra ID (`IncludeDeviceGroup`) e/ou a dispositivos cujo utilizador principal seja membro de um grupo de utilizadores (`IncludeUserGroup`). Quando ambos os filtros estão definidos, um dispositivo tem de corresponder aos dois. As filiações transitivas são resolvidas, pelo que os membros de grupos aninhados são incluídos.
### Entrega do relatório
Os ficheiros de relatório só são gerados quando a **Entrega do relatório** opção inclui um e-mail ou uma ligação de transferência. Com *Apenas dados de saída* selecionado, os resultados são lidos diretamente no separador Dados de saída do portal RealmJoin, onde cada tabela também pode ser exportada para Excel. A entrega por e-mail e a geração da ligação de transferência são independentes e podem ser combinadas; a *Formato do ficheiro do relatório* predefinição é apenas a pasta de trabalho do Excel.
* **E-mail**e envia um e-mail de resumo com o inventário completo anexado em CSV e/ou pasta de trabalho do Excel. Quando o anexo CSV excede o limite de tamanho do e-mail e *CSV e XLSX* está selecionado, o e-mail recorre apenas à pasta de trabalho do Excel. Quando nenhum dispositivo móvel corresponde, o e-mail indica que não foi encontrado nenhum dispositivo e não contém qualquer anexo.
* **Ligação de transferência**carrega o(s) ficheiro(s) de relatório para a Storage Account do Azure configurada nas `RJReport.StorageAccount.*` definições do Tenant (contentor `list-mobile-devices` por predefinição) e imprime ligações de transferência SAS com tempo limitado na saída do trabalho. Adequado quando o inventário é demasiado grande para um anexo de e-mail ou deve ser entregue diretamente à gestão de ativos. O carregamento para o armazenamento autentica-se com a identidade gerida da conta de Automation; essa identidade necessita de **Leitor e acesso aos dados** função RBAC na Storage Account de destino (isto é uma atribuição de Azure RBAC, não uma permissão de aplicação do Graph).
Os ficheiros de relatório contêm todas as colunas das tabelas acima, incluindo a `ID do dispositivo`ICCID. `PhoneNumber` e as colunas de rede/SIM só fazem parte dos ficheiros quando as opções correspondentes estão ativadas. Os dispositivos não conformes são destacados na pasta de trabalho do Excel. Não são criados ficheiros quando nenhum dispositivo móvel corresponde às plataformas e filtros selecionados.
Os agendamentos criados antes da **Entrega do relatório** opção existir continuam a enviar o respetivo email: um destinatário guardado por si só ainda ativa o email para eles. Quando esse agendamento é aberto para edição, a opção mostra *Apenas dados de saída*; selecione novamente a entrega antes de guardar, caso contrário o agendamento deixa de enviar o relatório.
### Configuração relativa ao envio de emails
O envio de um relatório por e-mail é opcional e só acontece quando a **Entrega do relatório** opção inclui um e-mail; é então necessário um destinatário. O endereço do remetente é obtido de `RJReport.EmailSender` Tenant.
Este runbook envia emails utilizando a API do Microsoft Graph. Para enviar emails através da Graph API, é necessário configurar um endereço de email existente na personalização do runbook.
Consulte a [documentação das definições de relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obter detalhes sobre todas as definições disponíveis.
#### Branding do email
O email do relatório respeita as definições opcionais de `RJReport.Branding.*` do Tenant:
* **Imagem do cabeçalho e do rodapé** - URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada
* **Ligação no rodapé** - destino da imagem de rodapé
* **Cor de destaque e do texto** - valores hexadecimais de 6 dígitos, por exemplo `#0052cc`
Quando estas definições não estão configuradas, são usadas as imagens e cores predefinidas de RealmJoin. Uma imagem que não possa ser transferida ou validada, ou um valor de cor inválido, nunca impede o email do relatório - em vez disso, é usada a predefinição correspondente.
Instruções de configuração e requisitos da imagem: [Branding do email](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).
### Localização
Organização → Dispositivos → Listar dispositivos móveis
**Nome completo do Runbook**
rjgit-org\_devices\_list-mobile-devices
### Detalhes
| Propriedade | Valor |
| ------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Versão | 1.1.0 |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
Az.Accounts (>= 5.5.2)
|
| Agendável | não |
### Permissões
#### Permissões da aplicação
* **Tipo**: Microsoft Graph
* DeviceManagementManagedDevices.Read.All
* *Lista dispositivos móveis geridos pelo Intune, incluindo detalhes de hardware, SIM e rede*
* Directory.Read.All *(opcional — recurso: filtragem de escopo por grupo)*
* *Lê os membros do grupo para resolver os filtros opcionais de âmbito de grupo de dispositivos/utilizadores*
* Mail.Send *(opcional — funcionalidade: Relatório por email)*
* *Envia o email do relatório através de Send-RjRbReportEmail quando a entrega por email é selecionada*
* Organization.Read.All *(opcional — funcionalidade: Relatório por email)*
* *Lê /organization para o nome do Tenant usado nos nomes dos ficheiros de relatório, no assunto do e-mail e no rodapé do e-mail; sem isso, o runbook recorre a 'Unknown Tenant'*
#### Notas de permissão
Azure Storage Account: função 'Leitor e acesso aos dados' para a identidade gerida da conta de Automação na Storage Account de destino - o carregamento obtém as chaves da conta através de listKeys (necessário apenas para as opções de ligação de transferência)
### Parâmetros
#### Android
Inclui dispositivos Android.
| Propriedade | Valor |
| -------------------------- | ----------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir dispositivos Android? |
#### iOS
Inclui dispositivos iOS e iPadOS.
| Propriedade | Valor |
| -------------------------- | -------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir dispositivos iOS/iPadOS? |
#### Incluir detalhes de rede
Adiciona endereço IP, sub-rede, ICCID, identificador eSIM, tecnologia celular, UDID, saúde da bateria e estado de iPad partilhado. Requer um pedido extra por dispositivo, pelo que os Tenant de grande dimensão demoram mais.
| Propriedade | Valor |
| -------------------------- | ------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir detalhes de rede e SIM? |
#### Incluir número de telefone
Mostra a coluna do número de telefone. De qualquer forma, o Intune mascara parte do número em dispositivos de propriedade pessoal.
| Propriedade | Valor |
| -------------------------- | ---------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir números de telefone? |
#### IncludeDeviceGroup
Apenas dispositivos neste grupo do Entra ID, incluindo grupos aninhados. Deixe em branco para todos os dispositivos móveis.
| Propriedade | Valor |
| -------------------------- | ------------------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Limitar a dispositivos no grupo |
#### IncludeUserGroup
Apenas dispositivos cujo utilizador principal esteja neste grupo, incluindo grupos aninhados. Deixe em branco para todos.
| Propriedade | Valor |
| -------------------------- | -------------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Limitar aos utilizadores principais no grupo |
#### EmailFrom
Endereço do remetente do email do relatório. Obtido da definição do Tenant RJReport.EmailSender.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingHeaderImageUrl
Imagem de cabeçalho do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.HeaderImageUrl; é utilizado o cabeçalho predefinido do RealmJoin quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingFooterImageUrl
Imagem de rodapé do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.FooterImageUrl; é utilizado o rodapé predefinido do RealmJoin quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingFooterLink
Ligação por trás da imagem de rodapé do email do relatório. Obtida da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é utilizado quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingAccentColor
Cor de destaque do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.AccentColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingTextColor
Cor do texto do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.TextColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ReportFileFormat
Entregar o relatório como CSV, como uma pasta de trabalho do Excel ou ambos.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | Apenas XLSX |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Formato do ficheiro do relatório |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
**Opções do portal**
| Opção do portal | Valor |
| --------------- | ----------- |
| CSV e XLSX | CSV e XLSX |
| Apenas CSV | Apenas CSV |
| Apenas XLSX | Apenas XLSX |
#### CreateDownloadLink
Também carregue o relatório e devolva uma ligação de download que expira após alguns dias.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ContainerName
Contentor de armazenamento para o qual os ficheiros do relatório são carregados. Definir por runbook.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | list-mobile-devices |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ResourceGroupName
Grupo de recursos da conta de armazenamento para carregamentos do relatório. Obtido a partir da definição de tenant RJReport.StorageAccount.ResourceGroup.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### StorageAccountName
Conta de armazenamento para carregamentos do relatório. Obtida a partir da definição de tenant RJReport.StorageAccount.StorageAccountName.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### LinkExpiryDays
Número de dias que uma ligação de download permanece válida. Obtido a partir da definição de tenant RJReport.StorageAccount.LinkExpiryDays.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | 6 |
| Tipo | Int32 |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### SendEmailReport
Envia o relatório para o endereço de email do destinatário.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### EmailTo
Enviar o relatório para estes endereços. Separe vários com vírgulas; cada destinatário recebe um email separado.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Endereço(s) de email do(s) destinatário(s) |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
[Voltar à visão geral da referência do Runbook](/pt/automatizacao/runbooks/runbook-references.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.realmjoin.com/pt/automatizacao/runbooks/runbook-references/org/devices/list-mobile-devices.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.