> 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 Otorga a una o más personas acceso total al buzón de este usuario, o elimina ese acceso nuevamente. 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 error para un delegado 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 que se cambie 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 estado actual de **FullAccess** delegaciones en el buzón (el *estado actual*). 5. Otorga o elimina FullAccess para cada delegado restante, uno a la vez. 6. Vuelve a leer los permisos del buzón e imprime el estado resultante más un resumen por ejecución. El runbook solo toca el **FullAccess** derecho en 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 El **campo de acceso delegado a** es un **selector múltiple** de usuarios. Selecciona tantos delegados como sean necesarios: todos reciben la misma acción (*Otorgar acceso* o *Eliminar acceso*) y la misma configuración 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 invitadas. Pasa 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 IDs de objeto sin procesar. Luego, cada valor se resuelve frente a 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 se resuelven en el mismo buzón se desduplican, y un delegado que se resuelve al propietario del buzón se descarta con una advertencia: un buzón no puede delegarse a sí mismo. #### Qué se cambia * **Otorgar acceso (`Quitar` = false):** `Add-MailboxPermission` con `-AccessRights FullAccess` para cada delegado. * **Eliminar acceso (`Quitar` = true):** `Remove-MailboxPermission` con `-AccessRights FullAccess -InheritanceType All` para cada delegado. #### AutoMapping **`AutoMapping`** solo se evalúa al otorgar acceso; el portal oculta el campo cuando *Eliminar acceso* está seleccionado. Con AutoMapping habilitado, Outlook agrega el buzón delegado al perfil del delegado automáticamente, pero solo después de que el cliente recrea la asignación, lo que puede tardar un poco. Los otorgamientos existentes no se vuelven a escribir para cambiar su valor de AutoMapping; elimine la delegación y otorgúela 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: * Otorgar acceso a un delegado que ya tiene FullAccess se informa como *sin cambios*, no como un error. * Eliminar el acceso a un delegado que no tiene una 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 eliminable nunca se omite en silencio. #### Resultados parciales Los delegados se procesan de forma independiente: * Un delegado **sin buzón** se omite durante la comprobación previa y se contabiliza 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 del 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 con el formato `Resumen: , , , `, seguido por las delegaciones FullAccess resultantes en el buzón. Si **algún** delegado falló, el propio runbook informa un fallo. Esto es deliberado: con un selector múltiple, un éxito parcial informado como una ejecución limpia ocultaría delegados que nunca recibieron acceso. #### Limitaciones * **No se pueden quitar los permisos heredados.** 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 puede revocarse aquí; ajuste la pertenencia al grupo o la asignación de rol en su lugar. * **Solo se administran los otorgamientos explícitos de Allow.** Un **Deny** explícito en el buzón se muestra por transparencia, pero el runbook nunca agrega ni elimina uno. #### Requisitos previos La identidad administrada de la cuenta de Automation se conecta a Exchange Online a través de `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 equivalente de Exchange Online RBAC 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 portal, por lo que no se requieren permisos de aplicación de Graph. ### Ubicación Usuario → Correo → Delegar acceso total **Nombre completo del runbook** rjgit-user\_mail\_delegate-full-access ### Detalles | Propiedad | Valor | | ------------------ | --------------------------------------------------------------------------------- | | Versión | 1.1.3 | | Módulos requeridos |

RealmJoin.RunbookHelper (>= 0.8.10)
ExchangeOnlineManagement (>= 3.9.2)

| | Programable | no | ### Permisos #### Permisos de aplicación * **Tipo**: Office 365 Exchange Online * Exchange.ManageAsApp * *Administra delegaciones de buzón FullAccess en la sesión de Exchange Online solo para aplicación* #### roles de RBAC * Administrador de Exchange * *Necesario para la sesión de Exchange Online solo para 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 | | -------------------- | ----------------------------------------------------------- | | Requerido | verdadero | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### delegateTo Personas que obtienen o pierden acceso total. Puede elegir varias a la vez. | Propiedad | Valor | | ------------------------------ | -------------------------- | | Requerido | verdadero | | Valor predeterminado | | | Tipo | Cadena\[] | | Nombre para mostrar del portal | campo de acceso delegado a | #### Quitar Grant otorga acceso total a las personas seleccionadas, Remove lo quita. | Propiedad | Valor | | ------------------------------ | -------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar del portal | Acción | **Opciones del portal** | Opción del portal | Valor | | ----------------- | --------- | | Otorgar acceso | falso | | Eliminar acceso | verdadero | #### AutoMapping Hace que el buzón aparezca automáticamente en Outlook de los delegados. No tiene efecto cuando se elimina el acceso. | Propiedad | Valor | | ------------------------------ | -------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar del portal | ¿Mapear el buzón automáticamente en Outlook? | [Volver a la vista general de referencia del runbook](/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=&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.