> 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/automacao/runbooks/runbook-references/org/devices/list-mobile-devices.md). # Listar dispositivos móveis Lista todos os dispositivos móveis geridos (Android, iOS/iPadOS) com detalhes de inventário, segurança e rede específicos para dispositivos móveis. ### Descrição Lista todos os dispositivos móveis geridos pelo Intune com o respetivo inventário específico para dispositivos móveis, como IMEI, número de série, número de telefone, operadora, propriedade, conformidade e detalhes de inscrição. Opcionalmente, o último endereço IP e sub-rede reportados, ICCID, identificador eSIM, tecnologia celular, UDID, estado da bateria e estado de Shared iPad são adicionados por dispositivo, o que ajuda a ver em que redes (Wi-Fi) os dispositivos estiveram ativos pela última vez. O resultado pode ser restringido por plataforma e por um grupo de dispositivos do Entra e/ou por um grupo de utilizadores dos utilizadores primários. Opcionalmente, o inventário completo é enviado como relatório por email com anexos CSV e/ou Excel (xlsx) e/ou carregado para um Storage Account do Azure, devolvendo ligações de download com validade limitada. Sem destinatário e sem a opção de ligação de download, o runbook apenas imprime o resultado na saída do trabalho. O parâmetro ReportFileFormat controla quais formatos de ficheiro são gerados e entregues (apenas CSV, CSV & XLSX, ou apenas XLSX). Quando o anexo CSV excede o limite de tamanho do email e "CSV & XLSX" é selecionado, o email recorre apenas ao livro do Excel. ### Colunas de saída O runbook imprime um bloco de resumo (contagens de dispositivos por plataforma, estado de conformidade e propriedade, filtros aplicados e - com detalhes de rede ativados - o número de dispositivos sem um endereço IP reportado) seguido por até três tabelas. Os mesmos dados podem opcionalmente ser entregues como relatório por email e/ou como ligação de download, veja [Entrega do relatório](#report-delivery). #### Inventário (sempre mostrado) | Coluna | Origem e significado | | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | Nome do dispositivo | Nome do dispositivo conforme reportado pelo Intune | | Utilizador | Nome principal de utilizador do utilizador primário | | SO / 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 | Identidade Internacional de Equipamento Móvel do dispositivo | | Número de telefone | Número de telefone do SIM - apenas presente quando `Incluir número de telefone` está ativado, caso contrário a coluna é omitida por completo | | Operadora | Operadora do assinante do SIM | | Propriedade | `empresa` ou `pessoal` | | Conformidade | Estado de conformidade do Intune | | Última sincronização | Carimbo de data/hora da última entrada bem-sucedida no 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 | Indica se o dispositivo tem jailbreak ou root | | Estado de ameaça | Estado de ameaça reportado por um parceiro Mobile Threat Defense (apenas 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 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 `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á provisionado | | 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 entrada bem-sucedida no Intune - indica quão antigas são as informações de IP | Esta tabela está ordenada por sub-rede, pelo que os dispositivos se agrupam visualmente pela rede em que foram vistos pela última vez. ### Atualidade dos dados e limitações Todos os valores descrevem o estado da última entrada bem-sucedida 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 a última entrada através de dados móveis. O Intune mascara parcialmente o número de telefone dos dispositivos de propriedade pessoal, independentemente de `Incluir número de telefone` configuraçã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, e não na resposta da lista de dispositivos. O runbook envia sempre estes pedidos através do ponto de extremidade batch 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 limitação do Graph (os pedidos limitados são repetidos automaticamente com o tempo de espera reportado pelo Graph). Em ambientes grandes, 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 (`IncludeDeviceGroup`) e/ou a dispositivos cujo utilizador primário é membro de um grupo de utilizadores (`IncludeUserGroup`). Quando ambos os filtros estão definidos, um dispositivo tem de corresponder a ambos. As associações transitivas são resolvidas, pelo que os membros de grupos aninhados são incluídos. ### Entrega do relatório Por predefinição, o runbook apenas imprime as tabelas na saída do trabalho. Estão disponíveis dois canais de entrega opcionais e podem ser combinados: * **Relatório por email** (`EmailTo`): envia um email de resumo com o inventário completo anexado como CSV e/ou livro do Excel (`ReportFileFormat`, predefinição `Somente XLSX`). Requer a `RJReport.EmailSender` definição; a identidade visual do email é retirada das `RJReport.Branding.*` definições, tal como nos outros runbooks de relatório. Quando o anexo CSV excede o limite de tamanho do email e `CSV e XLSX` é selecionado, o email recorre apenas ao livro do Excel. * **Ligação de download** (`CreateDownloadLink`): carrega o(s) ficheiro(s) do relatório para a Storage Account configurada nas `RJReport.StorageAccount.*` definições (contentor `list-mobile-devices` por predefinição) e imprime ligações SAS de download com validade limitada na saída do trabalho. Adequado quando o inventário é demasiado grande para um anexo de email ou deve ser entregue diretamente à gestão de ativos. Os ficheiros do relatório contêm todas as colunas das tabelas acima, incluindo o `DeviceId`. `Número de telefone` 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 realçados no livro do Excel. Não são criados ficheiros quando nenhum dispositivo móvel corresponde às plataformas e filtros selecionados. ### 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.0.0 | | Módulos necessários |

RealmJoin.RunbookHelper (>= 0.8.9)
Microsoft.Graph.Authentication (>= 2.39.0)
Az.Accounts (>= 5.5.2)

| | Agendável | não | ### Notas O Intune não reporta o SSID Wi-Fi de um dispositivo. O último endereço IP e a sub-rede reportados são o indicador de rede mais próximo e devem ser sempre interpretados em conjunto com a coluna Last Sync, porque descrevem o estado da última entrada bem-sucedida do dispositivo - o que também pode ter acontecido através de ligação celular. Pré-requisitos: * O parâmetro EmailFrom deve ser configurado na personalização do runbook (definição RJReport.EmailSender) quando é solicitado um relatório por email * As definições RJReport.StorageAccount.\* devem ser configuradas quando é solicitada uma ligação de download Fonte dos dados e atualidade: Todos os valores são retirados do inventário do Intune de cada dispositivo, que é atualizado com a entrada regular do dispositivo. Descrevem, portanto, o estado da última entrada bem-sucedida e não necessariamente o estado atual. Os detalhes de rede e SIM (endereço IP, sub-rede, ICCID, UDID, ...) não fazem parte da resposta da lista de dispositivos do Graph e são obtidos com um pedido adicional do Graph por dispositivo, enviado através do ponto de extremidade batch do Graph em blocos de até 20. Desempenho: Os detalhes de rede/SIM estão desativados por predefinição. Quando ativados, o tempo de execução cresce linearmente com o número de dispositivos móveis. Em tenants com muitos dispositivos móveis, combine a opção com os filtros de âmbito de grupo. 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 várias 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 um livro do Excel ou ficheiro CSV ### Permissões #### Permissões da aplicação * **Tipo**: Microsoft Graph * DeviceManagementManagedDevices.Read.All * *Lista os dispositivos móveis geridos pelo Intune, incluindo detalhes de hardware, SIM e rede* * Directory.Read.All *(opcional — feature: Filtragem por âmbito de grupo)* * *Lê os membros do grupo para resolver os filtros opcionais de âmbito por grupo de dispositivos/utilizadores* * Organization.Read.All *(opcional — funcionalidade: relatório por email / ligação de download)* * *Lê /organization para obter o nome do Tenant usado nos nomes dos ficheiros do relatório, no assunto do email e no rodapé do email; sem isso, o runbook recorre a 'Unknown Tenant'* * Mail.Send *(opcional — funcionalidade: relatório por e-mail)* * *Envia o email do relatório através de Send-RjRbReportEmail quando EmailTo está configurado* #### Notas sobre permissões Azure Storage Account: função 'Storage Account Contributor' para a identidade gerida da Automation Account no Storage Account de destino — o carregamento obtém as chaves da conta através de listKeys (apenas necessário quando CreateDownloadLink é usado) ### Parâmetros #### Android Incluir dispositivos Android nos resultados. | Propriedade | Valor | | -------------------------- | ---------------------------- | | Obrigatório | falso | | Valor predefinido | Verdadeiro | | Tipo | Booleano | | Nome de exibição no portal | Incluir Dispositivos Android | #### iOS Incluir dispositivos iOS e iPadOS nos resultados. | Propriedade | Valor | | -------------------------- | ------------------------------- | | Obrigatório | falso | | Valor predefinido | Verdadeiro | | Tipo | Booleano | | Nome de exibição no portal | Incluir dispositivos iOS/iPadOS | #### Incluir detalhes de rede Adiciona ao resultado o último endereço IP e sub-rede reportados, ICCID, identificador eSIM, tecnologia celular, UDID, saúde da bateria e estado de Shared iPad. Requer um pedido adicional do Graph por dispositivo (enviado em lotes de 20), pelo que o tempo de execução cresce com o número de dispositivos. Desativado por predefinição. | Propriedade | Valor | | -------------------------- | ------------------------------------------------------------------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Nome de exibição no portal | Incluir detalhes de rede/SIM (uma chamada adicional ao Graph por dispositivo — mais lento com muitos dispositivos) | #### Incluir número de telefone Controla se o número de telefone é obtido e mostrado. Quando desativado, a coluna do número de telefone é omitida por completo. Note que o Intune, de qualquer forma, mascara parcialmente o número de telefone dos dispositivos de propriedade pessoal. | Propriedade | Valor | | -------------------------- | ---------------------------------------- | | Obrigatório | falso | | Valor predefinido | Verdadeiro | | Tipo | Booleano | | Nome de exibição no portal | Incluir números de telefone no resultado | #### IncludeDeviceGroup Incluir apenas dispositivos que sejam membros deste grupo de dispositivos do Entra. As associações de grupos aninhados são resolvidas. Deixe em branco para incluir todos os dispositivos móveis. | Propriedade | Valor | | -------------------------- | -------------------------------------------- | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Nome de exibição no portal | Limitar aos dispositivos no grupo (opcional) | #### IncludeUserGroup Incluir apenas dispositivos cujo utilizador primário seja membro deste grupo de utilizadores do Entra. As associações de grupos aninhados são resolvidas. Deixe em branco para incluir todos os dispositivos móveis. | Propriedade | Valor | | -------------------------- | ---------------------------------------------------- | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Nome de exibição no portal | Limitar a utilizadores primários no grupo (opcional) | #### EmailFrom O endereço de email do remetente. Isto precisa de ser configurado na personalização do runbook | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingHeaderImageUrl URL HTTPS pública opcional de uma imagem de cabeçalho personalizada (PNG/JPEG/GIF, máx. 200 KB) para o e-mail do relatório. Obtida da configuração do Tenant RJReport.Branding.HeaderImageUrl. Quando vazio, é usada a imagem de cabeçalho padrão do RealmJoin. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingFooterImageUrl URL HTTPS pública opcional de uma imagem de rodapé personalizada (PNG/JPEG/GIF, máx. 200 KB) para o e-mail do relatório. Obtida da configuração do Tenant RJReport.Branding.FooterImageUrl. Quando vazio, é usada a imagem de rodapé padrão do RealmJoin. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingFooterLink URL opcional para a qual a imagem de rodapé aponta. Obtida da configuração do Tenant RJReport.Branding.FooterLink. Quando vazio, é usada a ligação padrão (). | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingAccentColor Substituição opcional da cor de acento (hex de 6 dígitos, por exemplo '#0052cc') para o modelo de e-mail do relatório. Obtida da configuração do Tenant RJReport.Branding.AccentColor. Quando vazio ou inválido, é usada a cor de acento padrão do RealmJoin. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingTextColor Substituição opcional da cor do texto (hex de 6 dígitos) para o modelo de e-mail do relatório. Obtida da configuração do Tenant RJReport.Branding.TextColor. Quando vazio ou inválido, é usada a cor de texto padrão do RealmJoin. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ReportFileFormat Controla que formatos de ficheiro do relatório são gerados e entregues: "apenas CSV", "CSV & XLSX" ou "apenas XLSX" (predefinição). | Propriedade | Valor | | -------------------------- | ------------------------------- | | Obrigatório | falso | | Valor predefinido | Somente XLSX | | Tipo | Texto | | Nome de exibição no portal | Formato do arquivo do relatório | **Opções do portal** | Opção do portal | Valor | | --------------- | ----- | | CSV e XLSX | | | Somente CSV | | | Somente XLSX | | #### CreateDownloadLink Se ativado, os ficheiros do relatório são carregados para uma Storage Account do Azure e são devolvidos links de download com validade limitada. Desativado por predefinição. | Propriedade | Valor | | -------------------------- | -------------------------------------------------------------------------------- | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Nome de exibição no portal | Criar um link de download do ficheiro (carregar relatório para o armazenamento)? | **Opções do portal** | Opção do portal | Valor | | --------------------------------------------------------- | ---------- | | Sim - carregar o relatório e devolver um link de download | verdadeiro | | Não - não criar um link de download | falso | #### ContainerName Nome do contentor de armazenamento usado para o carregamento. Configurado por runbook (não uma definição global do RJReport). | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | list-mobile-devices | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ResourceGroupName Grupo de recursos que contém a Storage Account. Obtido das definições do Tenant RJReport. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### StorageAccountName Nome da Storage Account usado para o carregamento. Obtido das definições do Tenant RJReport. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### LinkExpiryDays Número de dias até o link de download gerado expirar. Obtido das definições do Tenant RJReport. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | 6 | | Tipo | Int32 | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### EmailTo Se especificado, será enviado um e-mail com o relatório para o(s) endereço(s) fornecido(s). Pode ser um único endereço ou vários endereços separados por vírgulas (string). A função envia e-mails individuais para cada destinatário por motivos de privacidade. | Propriedade | Valor | | -------------------------- | ----------------------------------------------------------------------------------------------- | | Obrigatório | falso | | Valor predefinido | | | Tipo | Texto | | Nome de exibição no portal | Endereço(s) de email do destinatário (opcional - deixe em branco para apenas saída do trabalho) | [Voltar à visão geral da referência do Runbook](/pt/automacao/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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/pt/automacao/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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.