> 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/general/report-intune-enrollment-readiness.md).
# Relatório de prontidão para registo no Intune
Reportar que utilizadores podem registar dispositivos no Intune
### Descrição
Verifica um conjunto de utilizadores, fornecidos diretamente ou através de um grupo, para saber se podem inscrever um dispositivo no Intune. Cada utilizador é classificado como Pronto, Pronto com avisos ou Não pronto, com os bloqueadores encontrados. A verificação abrange o estado da conta, a licença Intune, o limite de inscrição, os métodos de autenticação e as políticas de Conditional Access que visam o registo ou a inscrição de dispositivos. Nada é alterado. O relatório pode ser enviado por e-mail ou disponibilizado como link de transferência.
### Notas de interpretação
* Verificações realizadas por utilizador: estado da conta, licença e plano de serviço do Intune, autoridade MDM do tenant, limite de inscrição do dispositivo, restrições de plataforma, métodos de autenticação registados, políticas de Conditional Access e, opcionalmente, associação ao grupo piloto.
* Conditional Access é avaliado como um "What If" estático em relação ao início de sessão de inscrição de cada utilizador `EnrollmentPlatform`; a própria ferramenta What If do Entra continua a ser a autoridade.
* Os requisitos de dispositivo compatível nas políticas de "All resources" não bloqueiam a inscrição (uma isenção documentada do Entra); apenas as políticas que visam o registo de dispositivos ou as aplicações de inscrição do Intune são tratadas como barreiras rígidas.
* Não avaliados estaticamente: localizações nomeadas, filtros de dispositivo, frequência de início de sessão e termos de utilização.
* Os Passes de Acesso Temporário expirados ou já utilizados não são considerados métodos utilizáveis.
### Pré-requisitos
Pelo menos um dos `Nome de utilizador` ou `GroupName` é necessário; as associações a grupos são resolvidas transitivamente.
### Entrega do relatório
Cada execução grava os seus resultados no separador Output Data do portal RealmJoin: um resumo, as principais razões de bloqueio e uma tabela por estado de prontidão (*Não pronto*, *Pronto com avisos*, *Pronto*). Cada tabela pode ser exportada para o Excel lá.
Os ficheiros do relatório só são gerados quando um método de entrega é selecionado através da **Entrega do relatório** opção (email e/ou ligação de transferência). Com *Apenas dados de saída* Selecionado, os resultados são lidos diretamente no separador Output Data. A entrega por e-mail e a geração de link de transferência são independentes e podem ser combinadas.
Para a ligação de transferência, os ficheiros do relatório são carregados para a Storage Account do Azure configurada nas `RJReport.StorageAccount.*` definições de Tenant, e são devolvidos links de download SAS com prazo limitado. O carregamento para o armazenamento autentica-se com a identidade gerida da conta de Automação; essa identidade precisa da **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).
As execuções agendadas que foram guardadas com a opção anterior *Relatório por e-mail* continuam a enviar o e-mail. Quando esse agendamento é aberto para edição, a opção mostra *Apenas dados de saída* embora a entrega por e-mail guardada permaneça ativa; selecione novamente a entrega antes de guardar para que a caixa de diálogo corresponda ao que o agendamento faz.
### Configuração relativa ao envio de emails
O envio de um relatório por email é opcional e só acontece quando *Enviar também o relatório por email* ou *Enviar também email e ligação de transferência* é selecionado como entrega do relatório; nesse caso é 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 → Geral → Relatório Intune Enrollment Readiness
**Nome completo do Runbook**
rjgit-org\_general\_report-intune-enrollment-readiness
### 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
* DeviceManagementServiceConfig.Read.All
* *Lê /deviceManagement/deviceEnrollmentConfigurations?$expand=assignments para avaliar as configurações de limite de inscrição e de restrição de plataforma em relação a cada utilizador alvo*
* Group.Read.All
* *Resolve o grupo de âmbito e o grupo piloto opcional através de /groups?$filter=displayName eq '...' quando é fornecido um nome de grupo*
* GroupMember.Read.All
* *Expande /groups/{id}/transitiveMembers/microsoft.graph.user para enumerar os membros do grupo de âmbito e, quando a verificação de associação ao grupo piloto está ativada, o grupo piloto*
* Organization.Read.All
* *Lê /organization duas vezes: na Connect Part, GET /v1.0/organization?$select=displayName resolve $tenantDisplayName para os nomes de ficheiro do relatório e o assunto do e-mail; na Data Collection, GET /v1.0/organization/{tenantId}?$select=id,displayName,mobileDeviceManagementAuthority determina a autoridade MDM do tenant, sendo o ID do tenant obtido de Get-MgContext como via rápida e, em alternativa, GET /v1.0/organization?$select=id*
* Policy.Read.All
* *Lê /identity/conditionalAccess/policies para identificar políticas de Conditional Access ativadas que possam bloquear a inscrição de dispositivos*
* RoleManagement.Read.Directory
* *Preenche o roleTemplateId dos objetos directoryRole devolvidos por /users/{id}/transitiveMemberOf/microsoft.graph.directoryRole, com os quais o âmbito includeRoles/excludeRoles de Conditional Access é comparado. User.Read.All autoriza a própria chamada, mas deixa as propriedades directoryRole nulas, o que faria silenciosamente com que todas as políticas com âmbito por função parecessem não se aplicar*
* User.Read.All
* *Lê /users/{id} com accountEnabled, assignedLicenses, usageLocation e department para cada utilizador selecionado ou resolvido por grupo, /users/{id}/ownedDevices para contar os dispositivos registados para a verificação de prontidão, /users/{id}/transitiveMemberOf/microsoft.graph.directoryRole para resolver as funções de diretório de cada utilizador para o âmbito includeRoles/excludeRoles de Conditional Access, e /subscribedSkus para determinar quais licenças incluem um plano de serviço Intune*
* UserAuthenticationMethod.Read.All
* *Lê /users/{id}/authentication/methods para verificar se cada utilizador alvo tem um método de autenticação registado antes da inscrição*
* Mail.Send *(opcional — funcionalidade: Relatório por email)*
* *Envia o e-mail do relatório de prontidão com os respetivos anexos CSV/XLSX através de Send-RjRbReportEmail quando a entrega por e-mail é selecionada*
#### 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
#### Nome de utilizador
Cada utilizador selecionado é verificado individualmente. Deixe em branco para verificar apenas os membros do grupo.
| Propriedade | Valor |
| -------------------------- | ------------------------ |
| Obrigatório | falso |
| Valor predefinido | @() |
| Tipo | String\[] |
| Nome de exibição do portal | Utilizadores a verificar |
#### GroupName
Grupo cujos membros são verificados, incluindo grupos aninhados. Pode ser combinado com utilizadores individuais.
| Propriedade | Valor |
| -------------------------- | -------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Grupo a verificar |
#### EnrollmentPlatform
Plataforma do dispositivo que os utilizadores querem inscrever. As políticas de Conditional Access abrangidas por outras plataformas são ignoradas; Todas as plataformas verifica todas as plataformas e apresenta cada uma.
| Propriedade | Valor |
| -------------------------- | ---------------------- |
| Obrigatório | falso |
| Valor predefinido | Windows |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Plataforma a inscrever |
**Opções do portal**
| Opção do portal | Valor |
| -------------------- | ------- |
| Windows | Windows |
| iOS / iPadOS | iOS |
| Android | Android |
| macOS | macOS |
| Todas as plataformas | Todos |
#### CheckPilotGroupMembership
Adiciona uma coluna com a associação ao grupo piloto; os não membros são reportados como Não pronto.
| Propriedade | Valor |
| -------------------------- | ------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Verificar associação ao grupo piloto? |
#### PilotGroupDisplayName
Os membros deste grupo contam como utilizadores piloto. O grupo é localizado pelo respetivo nome de apresentação.
| Propriedade | Valor |
| -------------------------- | --------------------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | col - Todos os utilizadores - Piloto (utilizadores) |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Nome do grupo piloto |
#### 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) |
#### 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) |
#### ReportFileFormat
Entregar o relatório como CSV, como uma pasta de trabalho do Excel ou ambos.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | CSV e 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 | report-intune-enrollment-readiness |
| 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) |
[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/general/report-intune-enrollment-readiness.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.