> 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/report-primary-user-mismatch_scheduled.md). # Relatório agendado de discrepância de utilizador principal ### Descrição Para dispositivos geridos por Windows, este relatório agendado compara o utilizador principal registado no Intune com o utilizador principal registado na API do cliente do RealmJoin. Correlaciona os dois conjuntos de dados por dispositivo, assinala qualquer dispositivo em que o utilizador principal difere e envia as diferenças por e-mail com anexos CSV e/ou Excel (xlsx). Os ficheiros do relatório também podem ser carregados para um Azure Storage Account, devolvendo ligações de download com validade limitada. 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 e-mail e "CSV & XLSX" é selecionado, o e-mail recorre apenas ao livro do Excel. ### Configuração relativa ao envio de e-mail Este runbook envia e-mails usando a API do Microsoft Graph. Para enviar e-mails através da API do Microsoft Graph, é necessário configurar um endereço de e-mail existente na personalização do runbook. Este processo é descrito em detalhe na [Configuração de relatórios por e-mail](https://github.com/realmjoin/realmjoin-runbooks/tree/master/docs/general/setup-email-reporting.md) documentação. ### Configuração relativa às credenciais da API do RealmJoin Este runbook consulta a API do cliente do RealmJoin e requer uma credencial dedicada armazenada na Conta de Automação do Azure. **Configuração passo a passo:** 1. **Obtenha as credenciais da API** — Se ainda não tiver credenciais da API do RealmJoin, solicite-as em 2. **Abra a Conta de Automação** — No portal do Azure, navegue até à Conta de Automação usada para runbooks 3. **Vá para Recursos partilhados > Credenciais** — No menu à esquerda, em *Recursos partilhados*, clique em *Credenciais* 4. **Adicione uma nova credencial** — Clique em *Adicionar uma credencial* 5. **Nomeie-o exatamente `RJAPI`** — O runbook procura este nome; qualquer desvio fará com que a pesquisa da credencial falhe 6. **Introduza o nome de utilizador e a palavra-passe da API do RealmJoin** — Utilize as credenciais do passo 1 7. **Guardar** — Clique em *Criar* e execute novamente o runbook ### Localização Organização → Dispositivos → Relatório de incompatibilidade do utilizador principal (Agendado) **Nome completo do runbook** rjgit-org\_devices\_report-primary-user-mismatch\_scheduled ### Permissões #### Permissões da aplicação * **Tipo**: Microsoft Graph * DeviceManagementManagedDevices.Read.All * Directory.Read.All * Mail.Send * Organization.Read.All ### Parâmetros #### SyncThresholdDays Número de dias a recuar para o filtro de última sincronização do Intune. Apenas são avaliados os dispositivos Windows que tenham sincronizado dentro deste número de dias. | Propriedade | Valor | | ----------------- | ----- | | Obrigatório | false | | Valor predefinido | 30 | | Tipo | Int32 | #### DeviceNamePrefix Prefixo opcional do nome do dispositivo para filtrar o relatório para um subconjunto específico de dispositivos. Deixe em branco para incluir todos os dispositivos. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | false | | Valor predefinido | | | Tipo | String | #### IncludeMismatches Incluir no relatório os dispositivos cujo utilizador principal difere entre o Intune e o RealmJoin. Ativado por predefinição. | Propriedade | Valor | | ----------------- | ---------- | | Obrigatório | false | | Valor predefinido | Verdadeiro | | Tipo | Booleano | #### IncludeMissingInRealmJoin Incluir no relatório os dispositivos que existem no Intune mas não têm um dispositivo correspondente no RealmJoin. Desativado por predefinição. | Propriedade | Valor | | ----------------- | -------- | | Obrigatório | false | | Valor predefinido | Falso | | Tipo | Booleano | #### IncludeMissingInIntune Incluir no relatório os dispositivos que existem no RealmJoin mas não têm um dispositivo correspondente no Intune. Desativado por predefinição. | Propriedade | Valor | | ----------------- | -------- | | Obrigatório | false | | Valor predefinido | Falso | | Tipo | Booleano | #### IncludePrimaryUserDeleted Incluir no relatório os dispositivos cujo utilizador principal do Intune foi eliminado do Entra ID. O Intune altera o nome principal do utilizador de um utilizador eliminado ao prefixar o respetivo ID de objeto, o que, de outro modo, apareceria como uma falsa incompatibilidade. Ativado por predefinição. | Propriedade | Valor | | ----------------- | -------- | | Obrigatório | false | | Valor predefinido | Falso | | Tipo | Booleano | #### UseDeviceScope Ative a filtragem do âmbito dos dispositivos para incluir ou excluir dispositivos com base na pertença a grupos de dispositivos do Entra. | Propriedade | Valor | | ----------------- | -------- | | Obrigatório | false | | Valor predefinido | Falso | | Tipo | Booleano | #### IncludeDeviceGroup Incluir no relatório apenas os dispositivos que sejam membros deste grupo de dispositivos do Entra. Requer que a filtragem do âmbito dos dispositivos esteja ativada. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | false | | Valor predefinido | | | Tipo | String | #### ExcludeDeviceGroup Excluir do relatório os dispositivos que sejam membros deste grupo de dispositivos do Entra. Requer que a filtragem do âmbito dos dispositivos esteja ativada. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | false | | Valor predefinido | | | Tipo | String | #### 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. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | false | | Valor predefinido | | | Tipo | String | #### EmailFrom O endereço de e-mail do remetente. Isto é configurado através da definição de personalização do runbook e oculto no portal. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | false | | Valor predefinido | | | Tipo | String | #### ReportFileFormat Controla quais formatos de ficheiro do relatório são gerados e entregues: "apenas CSV", "CSV & XLSX" (predefinição) ou "apenas XLSX". | Propriedade | Valor | | ----------------- | ---------- | | Obrigatório | false | | Valor predefinido | CSV & XLSX | | Tipo | String | #### CreateDownloadLink Se ativado, os ficheiros do relatório são carregados para um Azure Storage Account e são devolvidas ligações de download com validade limitada. Desativado por predefinição. | Propriedade | Valor | | ----------------- | -------- | | Obrigatório | false | | Valor predefinido | Falso | | Tipo | Booleano | #### 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 | false | | Valor predefinido | report-primary-user-mismatch | | Tipo | String | #### ResourceGroupName Grupo de recursos que contém a Storage Account. Obtido das configurações do Tenant do RJReport. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | false | | Valor predefinido | | | Tipo | String | #### StorageAccountName Nome da Storage Account usado para o carregamento. Obtido das configurações do Tenant do RJReport. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | false | | Valor predefinido | | | Tipo | String | #### LinkExpiryDays Número de dias até que a ligação de download gerada expire. Obtido das configurações do Tenant do RJReport. | Propriedade | Valor | | ----------------- | ----- | | Obrigatório | false | | Valor predefinido | 6 | | Tipo | Int32 | [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/report-primary-user-mismatch_scheduled.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.