> 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/general/offboard-user-permanently.md).

# Dar de baja al usuario permanentemente

Dar de baja permanentemente a este usuario

### Descripción

Dada de baja a este usuario de forma permanente: se revoca el acceso, se deshabilita o elimina la cuenta, se ajustan las licencias y los grupos, y las membresías de grupo pueden exportarse antes de que se cambien. La propiedad de los grupos, los informes directos y las sponsorizaciones de invitados pueden transferirse a un sustituto. Una cuenta eliminada solo puede restaurarse durante 30 días.

### Preconfigurar la directiva de desvinculación mediante la configuración del tenant

La mayoría de los interruptores de este runbook están respaldados por la configuración del tenant, por lo que una organización puede fijar una vez su directiva de desvinculación y ocultar los campos correspondientes a los operadores. El ejemplo siguiente preconfigura todos los interruptores y oculta los campos; mantén solo los campos que los operadores aún deban decidir en cada ejecución.

```json
{
    "Settings": {
        "OffboardUserPermanently": {
            "userTypeRestriction": 0,
            "deleteUser": true,
            "disableUser": true,
            "revokeAccess": true,
            "exportGroupMemberships": true,
            "licensesMode": 0,
            "groupsMode": 0,
            "groupToAdd": "",
            "groupsToRemovePrefix": "",
            "replaceManagerReferences": true,
            "replaceSponsorReferences": true
        },
        "RJReport": {
            "StorageAccount": {
                "ResourceGroup": "rj-test-runbooks-01",
                "StorageAccountName": "rjrbexports01",
                "SubscriptionId": "00000000-0000-0000-0000-000000000000",
                "LinkExpiryDays": 6
            }
        }
    },
    "Runbooks": {
        "rjgit-user_general_offboard-user-permanently": {
            "ParameterList": [
                { "Name": "UserTypeSelector", "Hide": true },
                { "Name": "DisableUser", "Hide": true },
                { "Name": "RevokeAccess", "Hide": true },
                { "Name": "ChangeLicensesSelector", "Hide": true },
                { "Name": "ChangeGroupsSelector", "Hide": true },
                { "Name": "GroupToAdd", "Hide": true },
                { "Name": "GroupsToRemovePrefix", "Hide": true },
                { "Name": "CallerName", "Hide": true }
            ]
        }
    }
}
```

Significado de la configuración:

* `userTypeRestriction`: `0` permite todos los tipos de usuario, `1` solo miembros, `2` solo invitados. Un usuario que no coincida detiene la ejecución antes de cualquier cambio.
* `deleteUser`: eliminar la cuenta (`true`) o conservarla (`falso`).
* `disableUser`, `revokeAccess`: bloquea el inicio de sesión y finaliza las sesiones del usuario.
* `exportGroupMemberships`: exporta las pertenencias a grupos al Storage Account de almacenamiento de informes (consulta `RJReport.StorageAccount`) y devuelve un enlace de descarga antes de que se cambien los grupos y las licencias.
* `licensesMode`: `0` conserva las licencias asignadas directamente, `2` elimina todas ellas.
* `groupsMode`: `0` conserva los grupos, `1` elimina los grupos que comienzan con `groupsToRemovePrefix`, `2` elimina todos los grupos. Ambos `1` y `2` agregar o conservar `groupToAdd`.
* `replaceManagerReferences`, `replaceSponsorReferences`: transfiere los subordinados directos y los patrocinios del usuario a la persona de reemplazo.

Para obtener más información sobre cómo personalizar runbooks, consulte la [Guía de personalización de runbooks](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### Ubicación

Usuario → General → Dada de baja al usuario permanentemente

**Nombre completo del runbook**

rjgit-user\_general\_offboard-user-permanently

### Detalles

| Propiedad          | Valor                                                                                                                                                     |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Versión            | 1.3.0                                                                                                                                                     |
| Módulos requeridos | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)<br>ExchangeOnlineManagement (>= 3.9.2)</p> |
| Programable        | no                                                                                                                                                        |

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * User.ReadWrite.All
    * *Deshabilita el inicio de sesión, revoca las sesiones, elimina las licencias, reemplaza las referencias de administrador y patrocinador y elimina el objeto de usuario*
  * Group.ReadWrite.All
    * *Lee los grupos y transfiere o elimina las pertenencias de grupo del usuario*
  * GroupMember.ReadWrite.All
    * *Agrega y elimina pertenencias a grupos durante la limpieza de grupos*
* **Tipo**: Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *Abre la sesión de Exchange Online solo de aplicación que se usa para quitar al usuario de los grupos de distribución*

#### Notas sobre permisos

Azure Storage Account: rol 'Reader and Data Access' para la identidad administrada de la cuenta de automatización en el Storage Account de destino - la carga obtiene las claves de la cuenta mediante listKeys (solo necesario cuando se usa exportGroupMemberships)

#### roles RBAC

* Administrador de usuarios
  * *Necesario para que la identidad solo de la aplicación pueda bloquear el inicio de sesión, revocar sesiones y eliminar al usuario*
* Administrador de Exchange
  * *Necesario para la sesión de Exchange Online solo de aplicación que elimina las pertenencias a grupos de distribución*

### 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) |

#### UserTypeSelector

Se ejecuta solo para el tipo de usuario elegido: todos los usuarios, solo miembros o solo invitados. Si hay una discrepancia, la ejecución se detiene antes de cualquier cambio.

| Propiedad                        | Valor                           |
| -------------------------------- | ------------------------------- |
| Obligatorio                      | falso                           |
| Valor predeterminado             | 0                               |
| Tipo                             | Int32                           |
| Nombre para mostrar en el portal | Restringir a un tipo de usuario |

**Opciones del portal**

| Opción del portal                                          | Valor |
| ---------------------------------------------------------- | ----- |
| Permitir todos los tipos de usuario (miembros e invitados) | 0     |
| Solo miembros                                              | 1     |
| Solo invitados                                             | 2     |

#### DeleteUser

Eliminar quita el objeto de usuario. Conservar deja la cuenta en su lugar; lo que ocurra con ella sigue a los demás interruptores.

| Propiedad                        | Valor                          |
| -------------------------------- | ------------------------------ |
| Obligatorio                      | falso                          |
| Valor predeterminado             | Falso                          |
| Tipo                             | Booleano                       |
| Nombre para mostrar en el portal | Eliminar o conservar la cuenta |

**Opciones del portal**

| Opción del portal   | Valor |
| ------------------- | ----- |
| Eliminar la cuenta  | true  |
| Conservar la cuenta | falso |

#### Deshabilitar usuario

Bloquea la cuenta para que no pueda iniciar sesión.

| Propiedad            | Valor     |
| -------------------- | --------- |
| Obligatorio          | falso     |
| Valor predeterminado | Verdadero |
| Tipo                 | Booleano  |

#### RevokeAccess

Finaliza las sesiones activas del usuario e invalida sus tokens de actualización.

| Propiedad            | Valor     |
| -------------------- | --------- |
| Obligatorio          | falso     |
| Valor predeterminado | Verdadero |
| Tipo                 | Booleano  |

#### exportGroupMemberships

Exporta las membresías de grupo del usuario a un archivo y devuelve un enlace de descarga antes de que se cambien los grupos y las licencias. Tomado de la configuración de Tenant OffboardUserPermanently.exportGroupMemberships.

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

#### ContainerName

Contenedor de Storage Account al que se carga la exportación. Configurar por runbook.

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

#### ResourceGroupName

Grupo de recursos de la cuenta de almacenamiento para las cargas del informe. Se toma de la configuración del Tenant RJReport.StorageAccount.ResourceGroup.

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

#### StorageAccountName

Cuenta de almacenamiento para las cargas del informe. Se toma de la configuración del Tenant RJReport.StorageAccount.StorageAccountName.

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

#### SubscriptionId

ID de suscripción de la cuenta de almacenamiento para las cargas del informe. Se toma de la configuración del Tenant RJReport.StorageAccount.SubscriptionId; cuando está vacío, se usa la suscripción en la que inicia sesión la identidad administrada.

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

#### LinkExpiryDays

Número de días que un enlace de descarga permanece válido. Se toma de la configuración del Tenant RJReport.StorageAccount.LinkExpiryDays.

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

#### ChangeLicensesSelector

Quitar todo elimina todas las licencias asignadas directamente; las licencias heredadas de grupos permanecen.

| Propiedad                        | Valor                            |
| -------------------------------- | -------------------------------- |
| Obligatorio                      | falso                            |
| Valor predeterminado             | 0                                |
| Tipo                             | Int32                            |
| Nombre para mostrar en el portal | Licencias asignadas directamente |

**Opciones del portal**

| Opción del portal                                 | Valor |
| ------------------------------------------------- | ----- |
| No cambiar las licencias asignadas                | 0     |
| Quitar todas las licencias asignadas directamente | 2     |

#### ChangeGroupsSelector

Quitar grupos con el prefijo elimina los grupos nombrados por el prefijo, Quitar todos los grupos elimina todos los grupos. Ambos agregan o conservan el grupo en "Group to add or keep". Los grupos dinámicos, asignables por rol y locales se omiten y se enumeran.

| Propiedad                        | Valor                 |
| -------------------------------- | --------------------- |
| Obligatorio                      | falso                 |
| Valor predeterminado             | 0                     |
| Tipo                             | Int32                 |
| Nombre para mostrar en el portal | Pertenencias a grupos |

**Opciones del portal**

| Opción del portal               | Valor |
| ------------------------------- | ----- |
| No cambiar los grupos asignados | 0     |
| Quitar grupos con el prefijo    | 1     |
| Quitar todos los grupos         | 2     |

#### GroupToAdd

Grupo que el usuario aún necesita después de la desvinculación, por ejemplo un grupo de licencia para empleados que se van. Se agrega si falta y nunca se elimina.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Obligatorio          | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### GroupsToRemovePrefix

Los grupos cuyo nombre comienza con este texto se eliminan, por ejemplo LIC\_ para todos los grupos de licencias. Solo se usa con "Quitar grupos con el prefijo".

| Propiedad            | Valor  |
| -------------------- | ------ |
| Obligatorio          | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### RevokeGroupOwnership

Quitar o reemplazar quita al usuario la propiedad de sus grupos. Cuando este usuario es el último propietario, el reemplazo asume la propiedad; sin reemplazo, el grupo se enumera para seguimiento manual. Conservar deja las propiedades tal como están.

| Propiedad                        | Valor               |
| -------------------------------- | ------------------- |
| Obligatorio                      | falso               |
| Valor predeterminado             | Verdadero           |
| Tipo                             | Booleano            |
| Nombre para mostrar en el portal | Propiedad de grupos |

**Opciones del portal**

| Opción del portal                            | Valor |
| -------------------------------------------- | ----- |
| Conservar la propiedad del usuario           | falso |
| Quitar o reemplazar la propiedad del usuario | true  |

#### ManagerAsReplacementOwner

Toma el gerente del usuario de Entra ID como propietario de reemplazo, gerente y patrocinador. Si se establece un gerente, se usa en lugar de la "Replacement person".

| Propiedad                        | Valor                            |
| -------------------------------- | -------------------------------- |
| Obligatorio                      | falso                            |
| Valor predeterminado             | Verdadero                        |
| Tipo                             | Booleano                         |
| Nombre para mostrar en el portal | ¿Usar al gerente como reemplazo? |

#### ReplacementOwnerName

Persona que asume la propiedad, los subordinados directos y los patrocinios cuando no se usa al gerente o este usuario no tiene ninguno.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Obligatorio          | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### ReplaceManagerReferences

Establece al reemplazo como gerente de todos los que dependen de este usuario. Sin reemplazo, esos usuarios solo se enumeran.

| Propiedad                        | Valor                                |
| -------------------------------- | ------------------------------------ |
| Obligatorio                      | falso                                |
| Valor predeterminado             | Falso                                |
| Tipo                             | Booleano                             |
| Nombre para mostrar en el portal | Gerente de los subordinados directos |

**Opciones del portal**

| Opción del portal                                                  | Valor |
| ------------------------------------------------------------------ | ----- |
| Conservar a este usuario como gerente de sus subordinados directos | falso |
| Establecer al reemplazo como gerente de los subordinados directos  | true  |

#### ReplaceSponsorReferences

Reemplaza a este usuario como patrocinador dondequiera que esté establecido como tal, normalmente en usuarios invitados. Sin reemplazo, esos usuarios solo se enumeran. Los patrocinios mantenidos a través de un grupo permanecen. Esto examina a todos los usuarios del tenant.

| Propiedad                        | Valor                     |
| -------------------------------- | ------------------------- |
| Obligatorio                      | falso                     |
| Valor predeterminado             | Falso                     |
| Tipo                             | Booleano                  |
| Nombre para mostrar en el portal | Patrocinador de invitados |

**Opciones del portal**

| Opción del portal                                                   | Valor |
| ------------------------------------------------------------------- | ----- |
| Conservar a este usuario como patrocinador                          | falso |
| Reemplazar a este usuario como patrocinador de usuarios (invitados) | true  |

[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/general/offboard-user-permanently.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.
