> 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/device/general/wipe-device.md).

# Borrar dispositivo

Borra este dispositivo Windows o macOS y limpia sus registros

### Descripción

Borra este dispositivo Windows o macOS. Opcionalmente, también limpia lo que queda de él: el registro de Intune, el registro de Autopilot y el objeto de Entra ID pueden eliminarse o deshabilitarse. Para Windows, puede elegir un borrado protegido y un período de gracia de cumplimiento más largo después del re-registro; para macOS, un código de recuperación y cómo se borra el SO. Un borrado elimina todos los datos del dispositivo y no se puede deshacer. El borrado se puede omitir cuando Microsoft Defender for Endpoint clasifica el dispositivo como de riesgo medio o alto.

### Borrar solo si el dispositivo no tiene riesgo

Cuando *Borrar solo si el dispositivo no tiene riesgo* (`skipWipeIfAtRisk`) está habilitada, el runbook comprueba la puntuación de riesgo del dispositivo en Microsoft Defender for Endpoint antes de tocar cualquier objeto de dispositivo. La búsqueda usa el ID de dispositivo de Entra y es la misma consulta que el **Comprobar el estado de Defender** realiza el runbook. La comprobación está desactivada de forma predeterminada y solo se ejecuta cuando se solicita un borrado; se omite cuando *No borrar el dispositivo* está seleccionado.

Posibles resultados:

* **Sin riesgo elevado** (puntuación de riesgo `Ninguno`, `Informativa` o `Bajo`): el borrado y las acciones de limpieza seleccionadas se ejecutan con normalidad.
* **Puntuación de riesgo `Medio` o `Alto`**: el runbook se detiene con una advertencia antes del borrado, de la pertenencia al grupo de exclusión, de los cambios en Entra y de las eliminaciones de Intune/Autopilot. Un dispositivo con una puntuación de riesgo elevada podría estar implicado en un incidente de seguridad, y borrarlo podría destruir datos forenses (por ejemplo, registros). Consulte primero con su equipo de seguridad; para borrar el dispositivo de todos modos, ejecute el runbook con la opción deshabilitada.
* **Dispositivo no encontrado en Microsoft Defender for Endpoint**: no se puede determinar la puntuación de riesgo. El runbook lo indica y continúa con el borrado, por lo que los dispositivos que no están incorporados a Microsoft Defender for Endpoint no se bloquean.
* **La consulta de Defender falla**: el runbook se detiene sin borrar, por lo que un problema temporal de la API nunca elude la protección.

#### Habilitar la comprobación de forma predeterminada

Para imponer la comprobación en cada borrado, preconfigure el parámetro y oculte lo, de modo que no pueda desactivarse desde el portal.

La configuración JSON para esto es la siguiente:

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "skipWipeIfAtRisk": {
            "Default": true,
            "Hide": true
        }
    }
}
```

### Agregar el dispositivo a un grupo de exclusión de cumplimiento

Cuando *Agregar dispositivo al grupo de exclusión de cumplimiento* (`addToExclusionGroup`) está habilitada, el dispositivo Windows borrado se agrega a un grupo de exclusión de cumplimiento. Los dispositivos de ese grupo reciben un período de gracia de cumplimiento más largo después de volver a inscribirse mediante Autopilot (esto refleja el **Comprobar la exclusión de incorporación del dispositivo** runbook).

De forma predeterminada, el grupo se identifica por su **nombre para mostrar** (`exclusionGroupName`). Como los nombres para mostrar no están garantizados como únicos, en su lugar puede fijar el grupo por su **ID de objeto** (`exclusionGroupId`). Cuando se proporciona un ID de objeto, este **siempre reemplaza** el nombre para mostrar, por lo que los conflictos de nombres nunca pueden hacer que se use el grupo incorrecto. `exclusionGroupId` está oculto de forma predeterminada y está pensado para configurarse mediante la personalización del runbook.

El grupo se resuelve y valida en una comprobación previa inicial. Si el grupo configurado no existe, el runbook se aborta **antes de** cualquier acción de borrar/eliminar/deshabilitar, por lo que no queda ningún estado aplicado a medias. La adición al grupo se omite para dispositivos que no son Windows y cuando el dispositivo se elimina de Entra ID (`removeAADDevice`).

#### Fije el grupo mediante ID de objeto (recomendado)

Preconfigure el ID de objeto del grupo y habilite el interruptor, manteniendo los campos ocultos. Esto evita cualquier ambigüedad por nombres para mostrar duplicados.

La configuración JSON para esto es la siguiente:

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "addToExclusionGroup": {
            "Default": true
        },
        "exclusionGroupId": {
            "Default": "00000000-0000-0000-0000-000000000000",
            "Hide": true
        },
        "exclusionGroupName": {
            "Hide": true
        }
    }
}
```

Reemplace `00000000-0000-0000-0000-000000000000` con el ID de objeto de su grupo (Entra ID > Grupos > *su grupo* > **ID de objeto**).

#### Fije el grupo mediante nombre para mostrar

Si prefiere trabajar con el nombre para mostrar (y es único en su Tenant), preconfigure `exclusionGroupName` y deje `exclusionGroupId` vacío para que se use el nombre.

La configuración JSON para esto es la siguiente:

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "addToExclusionGroup": {
            "Default": true
        },
        "exclusionGroupName": {
            "Default": "cfg - Intune - Windows - Cumplimiento para dispositivos Autopilot no inscritos (devices)",
            "Hide": true
        }
    }
}
```

### Opciones de borrado de macOS

Los dispositivos macOS se borran mediante la acción de borrado de Intune. Solo se aplican dos opciones a ellos:

* **Código de recuperación (macOS)** (`macOsRecoveryCode`): los Macs antiguos necesitan un código de recuperación de seis dígitos para aceptar el borrado; los dispositivos más nuevos lo ignoran. El parámetro está oculto en el portal y puede preconfigurarse mediante la personalización del runbook.
* **Comportamiento de obliteración (macOS)** (`macOsObliterationBehavior`): decide qué sucede cuando *Borrar todo el contenido y la configuración* (EACS) no es posible. `predeterminado` borra los datos del usuario y, si falla, recurre a borrar todo el SO, `doNotObliterate` nunca borra el SO, `obliterateWithWarning` advierte y luego borra el SO, `siempre` borra el SO en cualquier caso.

Las opciones exclusivas de Windows (*borrado protegido*, *base de datos de Autopilot*, *grupo de exclusión de cumplimiento*) se ignoran para los dispositivos macOS.

### Ubicación

Dispositivo → General → Borrar dispositivo

**Nombre completo del runbook**

rjgit-device\_general\_wipe-device

### Detalles

| Propiedad          | Valor                               |
| ------------------ | ----------------------------------- |
| Versión            | 1.1.0                               |
| Módulos requeridos | RealmJoin.RunbookHelper (>= 0.8.10) |
| Programable        | no                                  |

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * DeviceManagementManagedDevices.PrivilegedOperations.All
    * *Activa la acción de borrado de Intune cuando se selecciona wipeDevice*
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Busca el dispositivo de Intune por azureADDeviceId y lo elimina cuando se establece removeIntuneDevice*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Busca y elimina la identidad de Autopilot cuando se establece removeAutopilotDevice*
  * Device.Read.All
    * *Resuelve el dispositivo de Entra y lee sus propietarios registrados para el informe*
  * GroupMember.ReadWrite.All
    * *Agrega el dispositivo al grupo de exclusión cuando addToExclusionGroup está habilitado*
* **Tipo**: WindowsDefenderATP
  * Machine.Read.All *(opcional — característica: comprobación de riesgo de Defender)*
    * *Lee la puntuación de riesgo de Defender del dispositivo en la comprobación previa skipWipeIfAtRisk*

#### roles RBAC

* Administrador de dispositivos en la nube
  * *Necesario para deshabilitar y eliminar el objeto de dispositivo de Entra mediante /devices/{id}*

### Parámetros

#### DeviceId

ID de dispositivo de Entra ID del dispositivo sobre el que actúa el runbook. Establecido por el portal a partir del dispositivo seleccionado.

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

#### wipeDevice

Borrado completo elimina todos los datos de usuario y de inscripción del dispositivo. No borrar deja el dispositivo intacto y solo ejecuta los pasos de limpieza seleccionados.

| Propiedad                        | Valor                     |
| -------------------------------- | ------------------------- |
| Obligatorio                      | falso                     |
| Valor predeterminado             | Verdadero                 |
| Tipo                             | Booleano                  |
| Nombre para mostrar en el portal | ¿Borrar este dispositivo? |

**Opciones del portal**

| Opción del portal                                                                              | Valor |
| ---------------------------------------------------------------------------------------------- | ----- |
| Borrar completamente el dispositivo (Windows: no conservar datos de usuario ni de inscripción) | true  |
| No borrar el dispositivo                                                                       | falso |

#### useProtectedWipe

Sigue intentando borrar incluso si el dispositivo se apaga entre medias, de modo que el borrado no puede esquivarse apagándolo. Solo Windows.

| Propiedad                        | Valor                              |
| -------------------------------- | ---------------------------------- |
| Obligatorio                      | falso                              |
| Valor predeterminado             | Falso                              |
| Tipo                             | Booleano                           |
| Nombre para mostrar en el portal | ¿Usar borrado protegido (Windows)? |

#### removeIntuneDevice

Elimina el registro del dispositivo en Intune. Solo tiene sentido cuando el dispositivo ya ha sido borrado o destruido.

| Propiedad                        | Valor                            |
| -------------------------------- | -------------------------------- |
| Obligatorio                      | falso                            |
| Valor predeterminado             | Falso                            |
| Tipo                             | Booleano                         |
| Nombre para mostrar en el portal | ¿Eliminar dispositivo de Intune? |

**Opciones del portal**

| Opción del portal                                                                      | Valor |
| -------------------------------------------------------------------------------------- | ----- |
| Eliminar dispositivo de Intune (solo si el dispositivo ya ha sido borrado o destruido) | true  |
| Conservar el registro de Intune                                                        | falso |

#### removeAutopilotDevice

Quitar el dispositivo de la base de datos de Autopilot le permite salir del Tenant y registrarse en otro lugar. Mantenerlo permite una redistribución posterior en este Tenant. Solo Windows.

| Propiedad                        | Valor                                                 |
| -------------------------------- | ----------------------------------------------------- |
| Obligatorio                      | falso                                                 |
| Valor predeterminado             | Falso                                                 |
| Tipo                             | Booleano                                              |
| Nombre para mostrar en el portal | ¿Eliminar de la base de datos de Autopilot (Windows)? |

**Opciones del portal**

| Opción del portal                                           | Valor |
| ----------------------------------------------------------- | ----- |
| Quitar de Autopilot (el dispositivo puede salir del Tenant) | true  |
| Conservar el dispositivo en Autopilot                       | falso |

#### removeAADDevice

Indica si el objeto de dispositivo de Entra ID se elimina después del borrado. Se preconfigura en la personalización del runbook.

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

#### disableAADDevice

Deshabilitar bloquea los inicios de sesión desde el dispositivo, pero conserva su objeto en Entra ID. Conservar deja el objeto de Entra ID sin cambios.

| Propiedad                        | Valor                                               |
| -------------------------------- | --------------------------------------------------- |
| Obligatorio                      | falso                                               |
| Valor predeterminado             | Falso                                               |
| Tipo                             | Booleano                                            |
| Nombre para mostrar en el portal | ¿Deshabilitar el objeto de dispositivo de Entra ID? |

**Opciones del portal**

| Opción del portal                                | Valor |
| ------------------------------------------------ | ----- |
| Deshabilitar el dispositivo en Entra ID          | true  |
| Conservar sin cambios el dispositivo de Entra ID | falso |

#### skipWipeIfAtRisk

Omite el borrado cuando Microsoft Defender for Endpoint clasifica el dispositivo como de riesgo medio o alto. Eso mantiene intactas las pruebas en un dispositivo que podría formar parte de un incidente de seguridad.

| Propiedad                        | Valor                                           |
| -------------------------------- | ----------------------------------------------- |
| Obligatorio                      | falso                                           |
| Valor predeterminado             | Falso                                           |
| Tipo                             | Booleano                                        |
| Nombre para mostrar en el portal | ¿Borrar solo si el dispositivo no tiene riesgo? |

**Opciones del portal**

| Opción del portal                                                      | Valor |
| ---------------------------------------------------------------------- | ----- |
| Borrar solo si la puntuación de riesgo de Defender no es media ni alta | true  |
| Borrar independientemente de la puntuación de riesgo de Defender       | falso |

#### addToExclusionGroup

Agrega el dispositivo al grupo de exclusión de cumplimiento para que obtenga un período de gracia de cumplimiento más largo cuando se vuelva a inscribir mediante Autopilot. Solo Windows.

| Propiedad                        | Valor                                                     |
| -------------------------------- | --------------------------------------------------------- |
| Obligatorio                      | falso                                                     |
| Valor predeterminado             | Falso                                                     |
| Tipo                             | Booleano                                                  |
| Nombre para mostrar en el portal | ¿Agregar al grupo de exclusión de cumplimiento (Windows)? |

**Opciones del portal**

| Opción del portal                                         | Valor |
| --------------------------------------------------------- | ----- |
| Agregar dispositivo al grupo de exclusión de cumplimiento | true  |
| No agregar al grupo de exclusión                          | falso |

#### exclusionGroupName

Nombre para mostrar del grupo de exclusión al que se agrega el dispositivo. Un ID de objeto preconfigurado en la personalización del runbook tiene prioridad.

| Propiedad                        | Valor                                                                                    |
| -------------------------------- | ---------------------------------------------------------------------------------------- |
| Obligatorio                      | falso                                                                                    |
| Valor predeterminado             | cfg - Intune - Windows - Cumplimiento para dispositivos Autopilot no inscritos (devices) |
| Tipo                             | Cadena                                                                                   |
| Nombre para mostrar en el portal | Nombre del grupo de exclusión de cumplimiento                                            |

#### exclusionGroupId

ID de objeto del grupo de exclusión. Se preconfigura en la personalización del runbook y se usa en lugar del nombre del grupo para evitar conflictos de nombres.

| Propiedad                        | Valor                                                       |
| -------------------------------- | ----------------------------------------------------------- |
| Obligatorio                      | falso                                                       |
| Valor predeterminado             |                                                             |
| Tipo                             | Cadena                                                      |
| Nombre para mostrar en el portal | ID de objeto del grupo de exclusión de cumplimiento         |
| Oculto en el portal              | sí (preestablecido mediante la personalización del runbook) |

#### macOsRecoveryCode

Código de recuperación para Macs antiguos que lo necesitan para ser borrados. Los dispositivos más nuevos lo ignoran. Se preconfigura en la personalización del runbook.

| Propiedad                        | Valor                                                       |
| -------------------------------- | ----------------------------------------------------------- |
| Obligatorio                      | falso                                                       |
| Valor predeterminado             | 123456                                                      |
| Tipo                             | Cadena                                                      |
| Nombre para mostrar en el portal | Código de recuperación (macOS)                              |
| Oculto en el portal              | sí (preestablecido mediante la personalización del runbook) |

#### macOsObliterationBehavior

Cómo se borra un Mac: borrar primero los datos de usuario y, si falla, borrar el SO; no borrar nunca el SO; advertir antes de borrar el SO; o borrar siempre el SO.

| Propiedad                        | Valor                                  |
| -------------------------------- | -------------------------------------- |
| Obligatorio                      | falso                                  |
| Valor predeterminado             | predeterminado                         |
| Tipo                             | Cadena                                 |
| Nombre para mostrar en el portal | Comportamiento de obliteración (macOS) |

**Opciones del portal**

| Opción del portal                                                       | Valor                 |
| ----------------------------------------------------------------------- | --------------------- |
| Borrar datos de usuario (EACS), borrar el SO si eso falla               | predeterminado        |
| Borrar datos de usuario (EACS), no borrar nunca el SO                   | doNotObliterate       |
| Borrar datos de usuario (EACS), de lo contrario advertir y borrar el SO | obliterateWithWarning |
| Borrar siempre el SO                                                    | siempre               |

[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/device/general/wipe-device.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.
