> 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/es/automatizacion/runbooks/runbook-references/user/mail/delegate-full-access.md).

# Delegar acceso total

Conceder o quitar acceso total al buzón de este usuario

### Descripción

Concede a una o más personas acceso completo al buzón de este usuario, o vuelve a quitar ese acceso. Opcionalmente, el buzón se abre automáticamente en Outlook de los delegados. Los permisos se muestran antes y después del cambio, y un fallo de uno de los delegados no detiene a los demás.

### Cómo funciona

En cada ejecución, el runbook:

1. Se conecta a Exchange Online con la identidad administrada de la cuenta de Automation.
2. Verifica que el propietario del buzón seleccionado (`Nombre de usuario`) realmente tenga un buzón; si no, la ejecución se detiene antes de cambiar nada.
3. Resuelve cada delegado seleccionado a su dirección SMTP principal y elimina duplicados y al propio propietario del buzón.
4. Lee e imprime el **FullAccess** delegaciones en el buzón (el *estado actual*).
5. Concede o quita FullAccess para cada delegado restante, uno por uno.
6. Vuelve a leer los permisos del buzón e imprime el estado resultante junto con un resumen de la ejecución.

El runbook solo toca el **FullAccess** derecho sobre el único buzón seleccionado. Send As, Send on Behalf y los permisos a nivel de carpeta no se ven afectados.

#### Selección de delegados

Los **El acceso de delegado a** el campo es un **selector de usuarios de selección múltiple.** Seleccione tantos delegados como necesite: todos reciben la misma acción (*Conceder acceso* o *Quitar acceso*) y el mismo ajuste de AutoMapping del formulario en una sola ejecución.

El selector está restringido a cuentas de miembro (`userType eq 'Member'`), por lo que no se ofrecen cuentas de invitado. Entrega cada delegado seleccionado como un **nombre principal de usuario**, de modo que la primera línea del registro ya se lee como una lista de UPN en lugar de identificadores de objeto en bruto. Luego, cada valor se resuelve contra Exchange Online y, a partir del paso de comprobación previa, toda la salida muestra la dirección SMTP principal del delegado.

Dos entradas del selector que resuelven al mismo buzón se desduplican, y un delegado que resuelve al propietario del buzón se elimina con una advertencia: un buzón no puede delegarse a sí mismo.

#### Qué se cambia

* **Conceder acceso (`Quitar` = false):** `Add-MailboxPermission` con `-AccessRights FullAccess` para cada delegado.
* **Quitar acceso (`Quitar` = true):** `Remove-MailboxPermission` con `-AccessRights FullAccess -InheritanceType All` para cada delegado.

#### AutoMapping

**`AutoMapping`** solo se evalúa cuando se concede acceso; el portal oculta el campo cuando *Quitar acceso* está seleccionado. Con AutoMapping habilitado, Outlook agrega automáticamente el buzón delegado al perfil del delegado, pero solo después de que el cliente vuelva a crear la asignación, lo que puede tardar un poco. Las concesiones existentes no se reescriben para cambiar su valor de AutoMapping; quite la delegación y concédala de nuevo si debe cambiar el comportamiento de la asignación.

#### Idempotente por diseño

No se hace nada dos veces y nada falla solo porque ya era cierto:

* Conceder acceso a un delegado que ya tiene FullAccess se informa como *sin cambios*, no como un error.
* Quitar acceso a un delegado que no tiene ninguna entrada FullAccess se informa como *sin cambios*, no como un error.
* Cuando la instantánea previa al cambio no puede clasificar una entrada de permiso existente, el runbook no **no** toma el atajo: llama a Exchange Online y deja que su respuesta decida, de modo que una delegación que sí se puede quitar nunca se omite silenciosamente.

#### Resultados parciales

Los delegados se procesan de forma independiente:

* Un delegado **sin buzón** se omite durante la comprobación previa y se cuenta como *omitido*; los demás delegados siguen procesándose. Si ninguno de los delegados seleccionados tiene buzón, la ejecución se detiene.
* Un delegado cuyo cambio **falla** se informa con un motivo específico (retraso de replicación de directorio, permisos insuficientes de Exchange Online en la identidad administrada, un permiso heredado de un grupo o un buzón compartido/sin licencia) y el bucle continúa con el resto.

Cada ejecución termina con una línea de resumen en la forma `Resumen: <cambiado>, <sin cambios>, <fallido>, <omitido (sin buzón)>`, seguida de las delegaciones FullAccess resultantes en el buzón.

Si **algún** delegado falló, el propio runbook informa un error. Esto es deliberado: con un selector de selección múltiple, un éxito parcial informado como una ejecución limpia ocultaría delegados que nunca recibieron acceso.

#### Limitaciones

* **Los permisos heredados no se pueden quitar.** Un derecho FullAccess que proviene de un grupo de roles o de la pertenencia a un grupo de seguridad se muestra como *heredado* pero no se puede revocar aquí; ajuste en su lugar la pertenencia al grupo o la asignación de rol.
* **Solo se administran las concesiones explícitas Allow.** Una entrada explícita **Deny** en el buzón se muestra por transparencia, pero el runbook nunca añade ni quita una.

#### Requisitos previos

La identidad administrada de la cuenta de Automation se conecta a Exchange Online mediante `Connect-RjRbExchangeOnline` y necesita:

* el `Exchange.ManageAsApp` permiso de aplicación en *Office 365 Exchange Online*, y
* el **Administrador de Exchange** rol (o un rol RBAC equivalente de Exchange Online que incluya `Add-MailboxPermission` y `Remove-MailboxPermission`).

El runbook no realiza llamadas a Microsoft Graph: el selector de usuarios es solo una anotación del lado del portal, por lo que no se requieren permisos de aplicación de Graph.

### Ubicación

Usuario → Correo → Delegar acceso completo

**Nombre completo del runbook**

rjgit-user\_mail\_delegate-full-access

### Detalles

| Propiedad          | Valor                                                                             |
| ------------------ | --------------------------------------------------------------------------------- |
| Versión            | 1.1.3                                                                             |
| Módulos requeridos | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>ExchangeOnlineManagement (>= 3.9.2)</p> |
| Programable        | no                                                                                |

### Permisos

#### Permisos de aplicación

* **Tipo**: Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *Administra delegaciones FullAccess de buzones en la sesión de Exchange Online solo de aplicación*

#### roles RBAC

* Administrador de Exchange
  * *Necesario para la sesión de Exchange Online solo de aplicación que administra permisos FullAccess*

### Parámetros

#### Nombre de usuario

Nombre principal de usuario del usuario sobre el que actúa el runbook. Lo establece el portal a partir del usuario seleccionado.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | true                                                        |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### delegateTo

Personas que obtienen o pierden acceso completo. Puede seleccionar varias a la vez.

| Propiedad                        | Valor                   |
| -------------------------------- | ----------------------- |
| Obligatorio                      | true                    |
| Valor predeterminado             |                         |
| Tipo                             | String\[]               |
| Nombre para mostrar en el portal | El acceso de delegado a |

#### Quitar

Conceder otorga acceso completo a las personas seleccionadas; Quitar se lo retira.

| Propiedad                        | Valor    |
| -------------------------------- | -------- |
| Obligatorio                      | falso    |
| Valor predeterminado             | Falso    |
| Tipo                             | Booleano |
| Nombre para mostrar en el portal | Acción   |

**Opciones del portal**

| Opción del portal | Valor |
| ----------------- | ----- |
| Conceder acceso   | falso |
| Quitar acceso     | true  |

#### AutoMapping

Hace que el buzón aparezca automáticamente en Outlook de los delegados. No tiene efecto cuando se quita el acceso.

| Propiedad                        | Valor                                        |
| -------------------------------- | -------------------------------------------- |
| Obligatorio                      | falso                                        |
| Valor predeterminado             | Falso                                        |
| Tipo                             | Booleano                                     |
| Nombre para mostrar en el portal | ¿Mapear automáticamente el buzón en Outlook? |

[Volver al resumen de referencia de Runbook](https://docs.realmjoin.com/es/automatizacion/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/es/automatizacion/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.
