> 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 do iPad Partilhado. Isso mostra em que redes os dispositivos estiveram ativos por último. A lista pode ser limitada por plataforma, por um grupo de dispositivos ou por um grupo dos utilizadores principais. O relatório pode ser enviado por e-mail ou disponibilizado através de um link 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 por último, por exemplo scanners portáteis em locais 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 um livro de trabalho do Excel ou 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 Output Data do portal RealmJoin. A saída da consola mostra as mesmas contagens, além da 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 um link de transferência; veja a secção sobre entrega de relatórios abaixo.

#### Inventário (sempre apresentado)

| Coluna                      | Origem e significado                                                                                                              |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| NomeDoDispositivo           | Nome do dispositivo conforme reportado pelo Intune                                                                                |
| PrimaryUser                 | Nome principal do utilizador do utilizador principal                                                                              |
| OperatingSystem / OSVersion | Sistema operativo (Android, iOS, iPadOS) e versão                                                                                 |
| Manufacturer / Model        | Fabricante e modelo do hardware                                                                                                   |
| Número de série             | Número de série do hardware                                                                                                       |
| IMEI                        | Identidade Internacional de Equipamento Móvel do dispositivo                                                                      |
| PhoneNumber                 | Número de telefone do SIM - só presente quando `IncludePhoneNumber` está ativado; caso contrário, a coluna é omitida por completo |
| Operadora                   | Operadora subscritora do SIM                                                                                                      |
| Propriedade                 | `empresa` ou `pessoal`                                                                                                            |
| Conformidade                | Estado de conformidade do Intune                                                                                                  |
| Última sincronização        | Carimbo de data/hora da última verificação de Intune bem-sucedida                                                                 |

#### Segurança e inscrição (sempre apresentado)

| Coluna                             | Origem e significado                                                                                                                                              |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Supervisionado                     | modo supervisionado do iOS/iPadOS                                                                                                                                 |
| Encriptado                         | Estado de encriptação do dispositivo                                                                                                                              |
| Com jailbreak                      | Indica se o dispositivo tem jailbreak ou root                                                                                                                     |
| ThreatState                        | Estado da ameaça reportado por um parceiro de Mobile Threat Defense (só é relevante quando um parceiro MTD está ligado)                                           |
| PatchLevel                         | Nível do patch de segurança do Android (vazio em iOS/iPadOS)                                                                                                      |
| EnrollmentType / EnrollmentProfile | Como o dispositivo foi inscrito e o perfil de inscrição utilizado                                                                                                 |
| Categoria                          | Categoria do dispositivo do Intune                                                                                                                                |
| GB livres / GB totais              | Armazenamento livre e total (vazio quando o dispositivo não reporta um inventário de armazenamento utilizável, comum em perfis de trabalho do Android Enterprise) |
| Inscrito                           | Data de inscrição                                                                                                                                                 |

#### Rede e SIM (apenas com `IncludeNetworkDetails` 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 por último |
| WiFiMAC              | 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           | Indica se o dispositivo é um iPad Partilhado                                                                                                      |
| Última sincronização | Carimbo de data/hora da última verificação de Intune bem-sucedida - indica quão antigas são as informações de IP                                  |

Esta tabela está ordenada por sub-rede, pelo que os dispositivos ficam agrupados visualmente pela rede em que foram vistos por último.

### Atualidade dos dados e limitações

Todos os valores descrevem o estado da última verificação de Intune do dispositivo bem-sucedida, 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 efetuou a última verificação através de dados móveis. O Intune mascara parcialmente o número de telefone dos dispositivos de propriedade pessoal, independentemente da `IncludePhoneNumber` definição.

### Considerações de desempenho

Os detalhes de rede/SIM estão desativados por predefinição e devem ser ativados com cuidado em tenants grandes ou com muitos dispositivos móveis: o Microsoft Graph devolve estes valores apenas num pedido a 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 aumentado de limitação do Graph (os pedidos limitados são repetidos automaticamente com o tempo de espera reportado pelo Graph). Em ambientes grandes, combine `IncludeNetworkDetails` 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 são definidos, um dispositivo tem de corresponder a ambos. As pertenças 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 um link de transferência. Com *Apenas dados de saída* selecionado, os resultados são lidos diretamente no separador Output Data do portal RealmJoin, onde cada tabela também pode ser exportada para Excel. O envio por e-mail e a geração de links de transferência são independentes e podem ser combinados; o *Formato do arquivo do relatório* valor predefinido é apenas o livro de trabalho do Excel.

* **E-mail**: envia um e-mail de resumo com o inventário completo em anexo como CSV e/ou livro 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 ao livro de trabalho do Excel. Quando nenhum dispositivo móvel corresponde, o e-mail indica que não foi encontrado nenhum dispositivo e não inclui 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 apresenta links SAS de transferência com validade limitada 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 Storage Account autentica-se com a identidade gerida da conta de Automation; essa identidade necessita da **, atribuída diretamente na Storage Account.** 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`. O `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 no livro 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 e-mail: um destinatário guardado por si só ainda ativa o e-mail 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 e-mail

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; nesse caso, é necessário um destinatário. O endereço do remetente é obtido a partir de `RJReport.EmailSender` definição do Tenant.

Este runbook envia e-mails usando a API Microsoft Graph. Para enviar e-mails via API Graph, é necessário configurar um endereço de e-mail existente na personalização do runbook.

Veja 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 e-mail

O e-mail do relatório respeita as `RJReport.Branding.*` definições opcionais do Tenant:

* **Imagem do cabeçalho e do rodapé** - URLs HTTPS públicos, PNG/JPEG/GIF, máx. 200 KB cada
* **Link do rodapé** - destino da imagem de rodapé
* **Cor de destaque e do texto** - valores hexadecimais de 6 dígitos, por ex. `#0052cc`

Quando estas definições não estão configuradas, são usadas as imagens e cores predefinidas do RealmJoin. Uma imagem que não possa ser descarregada ou validada, ou um valor de cor inválido, nunca impede o e-mail do relatório - é usada em vez disso a predefinição correspondente.

Instruções de configuração e requisitos de imagem: [Branding do e-mail](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.2.0                                                                                                              |
| Módulos necessários | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Agendável           | não                                                                                                                |

### Permissões

#### Permissões de aplicativo

* **Tipo**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *Lista dispositivos móveis geridos pelo Intune, incluindo detalhes de hardware, SIM e rede*
  * Directory.Read.All *(opcional — funcionalidade: filtragem por âmbito de 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 e-mail)*
    * *Envia o e-mail do relatório através de Send-RjRbReportEmail quando a entrega por e-mail é selecionada*
  * Organization.Read.All *(opcional — funcionalidade: Relatório por e-mail)*
    * *Lê /organization para obter 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 'Reader and Data Access' para a identidade gerida da Automation Account na Storage Account de destino - o carregamento obtém as chaves da conta através de listKeys (só necessário para as opções de ligação de download)

### Parâmetros

#### Android

Inclui dispositivos Android.

| Propriedade                | Valor                         |
| -------------------------- | ----------------------------- |
| Obrigatório                | falso                         |
| Valor padrão               | Verdadeiro                    |
| Tipo                       | Booleano                      |
| Nome de exibição no portal | Incluir dispositivos Android? |

#### iOS

Inclui dispositivos iOS e iPadOS.

| Propriedade                | Valor                            |
| -------------------------- | -------------------------------- |
| Obrigatório                | falso                            |
| Valor padrão               | Verdadeiro                       |
| Tipo                       | Booleano                         |
| Nome de exibição no portal | Incluir dispositivos iOS/iPadOS? |

#### IncludeNetworkDetails

Adiciona endereço IP, sub-rede, ICCID, identificador eSIM, tecnologia celular, UDID, saúde da bateria e estado do iPad Partilhado. Requer um pedido adicional por dispositivo, pelo que tenants grandes demoram mais.

| Propriedade                | Valor                           |
| -------------------------- | ------------------------------- |
| Obrigatório                | falso                           |
| Valor padrão               | Falso                           |
| Tipo                       | Booleano                        |
| Nome de exibição no portal | Incluir detalhes de rede e SIM? |

#### IncludePhoneNumber

Mostra a coluna do número de telefone. De qualquer forma, o Intune mascara parte do número nos dispositivos de propriedade pessoal.

| Propriedade                | Valor                        |
| -------------------------- | ---------------------------- |
| Obrigatório                | falso                        |
| Valor padrão               | Verdadeiro                   |
| Tipo                       | Booleano                     |
| Nome de exibição no 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 padrão               |                                 |
| Tipo                       | Texto                           |
| Nome de exibição no 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 padrão               |                                              |
| Tipo                       | Texto                                        |
| Nome de exibição no portal | Limitar aos utilizadores principais do grupo |

#### EmailFrom

Endereço do remetente do e-mail do relatório. Obtido a partir da definição do Tenant RJReport.EmailSender.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingHeaderImageUrl

Imagem do cabeçalho do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida a partir da definição do Tenant RJReport.Branding.HeaderImageUrl; o cabeçalho padrão do RealmJoin é usado quando está vazio.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingFooterImageUrl

Imagem do rodapé do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida a partir da definição do Tenant RJReport.Branding.FooterImageUrl; o rodapé padrão do RealmJoin é usado quando está vazio.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingFooterLink

Link por trás da imagem do rodapé do e-mail do relatório. Obtido a partir da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é usado quando está vazio.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingAccentColor

Cor de destaque do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida a partir da definição do Tenant RJReport.Branding.AccentColor; o padrão do RealmJoin é usado quando está vazio ou inválido.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingTextColor

Cor do texto do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida a partir da definição do Tenant RJReport.Branding.TextColor; o padrão do RealmJoin é usado quando está vazio ou inválido.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ReportFileFormat

Entregue o relatório em CSV, como uma pasta de trabalho do Excel, ou ambos.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               | Somente XLSX                                            |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Formato do arquivo do relatório                         |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

**Opções do portal**

| Opção do portal | Valor        |
| --------------- | ------------ |
| CSV e XLSX      | CSV e XLSX   |
| Somente CSV     | Somente CSV  |
| Somente XLSX    | Somente XLSX |

#### CreateDownloadLink

Além disso, faça upload do relatório e retorne um link de download que expira após alguns dias.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | Falso                                                   |
| Tipo             | Booleano                                                |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ContainerName

Contêiner de armazenamento para o qual os arquivos do relatório são enviados. Definido por runbook.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | list-mobile-devices                                     |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ResourceGroupName

Grupo de recursos da Storage Account para uploads de relatórios. Obtido da configuração do Tenant RJReport.StorageAccount.ResourceGroup.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### StorageAccountName

Storage Account para uploads de relatórios. Obtida da configuração do Tenant RJReport.StorageAccount.StorageAccountName.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### SubscriptionId

ID da assinatura da Storage Account para uploads de relatórios. Obtido da configuração do Tenant RJReport.StorageAccount.SubscriptionId; quando vazio, é usada a assinatura na qual a identidade gerenciada entra.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### LinkExpiryDays

Número de dias que um link de download permanece válido. Obtido da configuração do Tenant RJReport.StorageAccount.LinkExpiryDays.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | 6                                                       |
| Tipo             | Int32                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### SendEmailReport

Envia o relatório para o endereço de e-mail do destinatário.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | Falso                                                   |
| Tipo             | Booleano                                                |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### EmailTo

Envie o relatório para estes endereços. Separe vários com vírgulas; cada destinatário recebe um e-mail separado.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               |                                                         |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Endereço(s) de e-mail do destinatário                   |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

[Voltar à visão geral da referência do runbook](https://docs.realmjoin.com/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=<question>&goal=<user_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.
