> 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/user/mail/delegate-full-access.md).

# Delegar acesso total

Conceder ou remover acesso total à caixa de correio deste utilizador

### Descrição

Concede a uma ou mais pessoas acesso total à caixa de correio deste utilizador, ou remove novamente esse acesso. Opcionalmente, a caixa de correio abre automaticamente no Outlook dos delegados. As permissões são apresentadas antes e depois da alteração, e uma falha num delegado não impede os outros.

### Como funciona

Em cada execução, o runbook:

1. Liga-se ao Exchange Online com a identidade gerida da conta de Automação.
2. Verifica se o proprietário da caixa de correio selecionado (`Nome de usuário`) tem efetivamente uma caixa de correio - se não tiver, a execução termina antes de qualquer alteração.
3. Resolve cada delegado selecionado para o respetivo endereço SMTP principal e elimina duplicados e o próprio proprietário da caixa de correio.
4. Lê e apresenta a atual **FullAccess** delegações na caixa de correio (o *estado atual*).
5. Concede ou remove FullAccess para cada delegado restante, um de cada vez.
6. Volta a ler as permissões da caixa de correio e apresenta o estado resultante, além de um resumo por execução.

O runbook apenas altera o **FullAccess** direito na única caixa de correio selecionada. Enviar como, Enviar em nome de e as permissões ao nível da pasta não são afetadas.

#### Selecionar delegados

O **Delegar acesso a** campo é um **seletor múltiplo** seletor de utilizadores. Selecione tantos delegados quantos necessários - todos recebem a mesma ação (*Conceder acesso* ou *Remover acesso*) e a mesma definição de AutoMapping do formulário numa única execução.

O seletor está restringido a contas de membro (`userType eq 'Member'`), pelo que as contas convidadas não são oferecidas. Passa cada delegado selecionado como um **nome principal de utilizador**, pelo que a primeira linha do registo já aparece como uma lista de UPNs em vez de IDs de objeto brutos. Cada valor é então resolvido no Exchange Online e, a partir da etapa de verificação preliminar, toda a saída mostra o endereço SMTP principal do delegado.

Duas entradas do seletor que resolvem para a mesma caixa de correio são desduplicadas, e um delegado que resolve para o proprietário da caixa de correio é eliminado com um aviso - uma caixa de correio não pode ser delegada a si própria.

#### O que é alterado

* **Conceder acesso (`Remover` = false):** `Add-MailboxPermission` com `-AccessRights FullAccess` para cada delegado.
* **Remover acesso (`Remover` = true):** `Remove-MailboxPermission` com `-AccessRights FullAccess -InheritanceType All` para cada delegado.

#### AutoMapping

**`AutoMapping`** só é avaliado ao conceder acesso; o portal oculta o campo quando *Remover acesso* está selecionado. Com o AutoMapping ativado, o Outlook adiciona automaticamente a caixa de correio delegada ao perfil do delegado - mas apenas depois de o cliente recriar o mapeamento, o que pode demorar algum tempo. As concessões existentes não são reescritas para alterar o valor de AutoMapping; remova a delegação e conceda-a novamente se o comportamento do mapeamento tiver de mudar.

#### Idempotente por definição

Nada é feito duas vezes e nada falha só porque já era verdade:

* Conceder acesso a um delegado que já possui FullAccess é apresentado como *inalterado*, e não como um erro.
* Remover o acesso de um delegado que não tem uma entrada FullAccess é apresentado como *inalterado*, e não como um erro.
* Quando a captura instantânea anterior à alteração não consegue classificar uma entrada de permissão existente, o runbook não **não** toma o atalho - chama o Exchange Online e deixa a resposta decidir, pelo que uma delegação removível nunca é ignorada silenciosamente.

#### Resultados parciais

Os delegados são processados de forma independente:

* Um delegado **sem caixa de correio** é ignorado durante a verificação preliminar e contado como *ignorado*; os restantes delegados continuam a ser processados. Se nenhum dos delegados selecionados tiver uma caixa de correio, a execução termina.
* Um delegado cuja alteração **falha** é apresentado com um motivo específico (atraso de replicação do diretório, permissões insuficientes no Exchange Online na identidade gerida, uma permissão herdada de um grupo ou uma caixa de correio partilhada/não licenciada) e o ciclo continua com os restantes.

Cada execução termina com uma linha de resumo no formato `Resumo: <alterado>, <inalterado>, <falhado>, <ignorado (sem caixa de correio)>`, seguido das delegações FullAccess resultantes na caixa de correio.

Se **qualquer** delegado falhar, o próprio runbook reporta uma falha. Isto é deliberado: com um seletor de múltipla seleção, um sucesso parcial reportado como uma execução limpa ocultaria delegados que nunca receberam acesso.

#### Limitações

* **As permissões herdadas não podem ser removidas.** Um direito FullAccess que vem de um grupo de funções ou da pertença a um Security Group é apresentado como *herdado* mas não pode ser revogado aqui - ajuste antes a pertença ao grupo ou a atribuição de função.
* **Apenas concessões Allow explícitas são geridas.** Uma **Deny** entrada na caixa de correio é apresentada por transparência, mas o runbook nunca adiciona nem remove uma.

#### Pré-requisitos

A identidade gerida da conta de Automação liga-se ao Exchange Online através de `Connect-RjRbExchangeOnline` e precisa de:

* o `Exchange.ManageAsApp` permissão de aplicação em *Office 365 Exchange Online*e
* o **Administrador do Exchange** função (ou uma função RBAC equivalente do Exchange Online que inclua `Add-MailboxPermission` e `Remove-MailboxPermission`).

O runbook não faz chamadas ao Microsoft Graph - o seletor de utilizadores é apenas uma anotação do lado do portal, pelo que não são necessárias permissões de aplicação do Graph.

### Localização

Utilizador → Correio → Delegar acesso total

**Nome completo do runbook**

rjgit-user\_mail\_delegate-full-access

### Detalhes

| Propriedade         | Valor                                                                             |
| ------------------- | --------------------------------------------------------------------------------- |
| Versão              | 1.1.3                                                                             |
| Módulos necessários | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>ExchangeOnlineManagement (>= 3.9.2)</p> |
| Agendável           | não                                                                               |

### Permissões

#### Permissões de aplicativo

* **Tipo**Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *Gere delegações de caixa de correio FullAccess na sessão do Exchange Online apenas com aplicação*

#### Funções RBAC

* Administrador do Exchange
  * *Necessária para a sessão do Exchange Online apenas com aplicação que gere permissões FullAccess*

### Parâmetros

#### Nome de usuário

Nome principal do usuário no qual o runbook atua. Definido pelo portal a partir do usuário selecionado.

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

#### delegateTo

Pessoas que obtêm ou perdem acesso total. Pode selecionar várias de uma vez.

| Propriedade                | Valor            |
| -------------------------- | ---------------- |
| Obrigatório                | verdadeiro       |
| Valor padrão               |                  |
| Tipo                       | String\[]        |
| Nome de exibição no portal | Delegar acesso a |

#### Remover

Conceder dá acesso total às pessoas selecionadas, Remover retira-o.

| Propriedade                | Valor    |
| -------------------------- | -------- |
| Obrigatório                | falso    |
| Valor padrão               | Falso    |
| Tipo                       | Booleano |
| Nome de exibição no portal | Ação     |

**Opções do portal**

| Opção do portal | Valor      |
| --------------- | ---------- |
| Conceder acesso | falso      |
| Remover acesso  | verdadeiro |

#### AutoMapping

Faz com que a caixa de correio apareça automaticamente no Outlook dos delegados. Não tem efeito quando o acesso é removido.

| Propriedade                | Valor                                                 |
| -------------------------- | ----------------------------------------------------- |
| Obrigatório                | falso                                                 |
| Valor padrão               | Falso                                                 |
| Tipo                       | Booleano                                              |
| Nome de exibição no portal | Mapear a caixa de correio automaticamente no Outlook? |

[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/user/mail/delegate-full-access.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.
