> 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: se pueden eliminar o deshabilitar el registro de Intune, el registro de Autopilot y el objeto de Entra ID. Para Windows puede elegir un borrado protegido y un período de gracia de cumplimiento más largo después de la reinscripción; 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 califica el dispositivo como de riesgo medio o alto.

### Borrar solo si el dispositivo no presenta riesgo

Cuando *Borrar solo si el dispositivo no presenta riesgo* (`skipWipeIfAtRisk`) está habilitado, el runbook comprueba la puntuación de riesgo del dispositivo en Microsoft Defender for Endpoint antes de tocar cualquier objeto del dispositivo. La búsqueda usa el ID de dispositivo de Entra ID y es la misma consulta que el **Comprobar estado de Defender** runbook realiza. 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`, `Informativo` o `Bajo`): el borrado y las acciones de limpieza seleccionadas se ejecutan normalmente.
* **Puntuación de riesgo `Medio` o `Alto`**: el runbook se detiene con una advertencia antes del borrado, la pertenencia al grupo de exclusión, los cambios en Entra y las eliminaciones de Intune/Autopilot. Un dispositivo con una puntuación de riesgo elevada puede estar implicado en un incidente de seguridad, y borrarlo podría destruir datos forenses (p. ej., registros). Alinee 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 registra y continúa con el borrado, por lo que los dispositivos que no están incorporados a Defender no se bloquean.
* **Falla la consulta de Defender**: 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 aplicar la comprobación en cada borrado, preestablezca el parámetro y ocúltelo, 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á habilitado, 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 replica el **Comprobar 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, también 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 borrado/eliminación/deshabilitación, 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 por ID de objeto (recomendado)

Preestablezca 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 por nombre para mostrar

Si prefiere trabajar con el nombre para mostrar (y es único en su Tenant), preestablezca `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 - Compliance for unenrolled Autopilot devices (devices)",
            "Hide": true
        }
    }
}
```

### Opciones de borrado de macOS

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

* **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 preestablecerse mediante la personalización del runbook.
* **Comportamiento de obliteración (macOS)** (`macOsObliterationBehavior`): decide qué ocurre cuando *Borrar todo el contenido y la configuración* (EACS) no es posible. `predeterminado` borra los datos del usuario y 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.

Opciones solo para 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
    * *Desencadena la acción de borrado de Intune cuando se selecciona wipeDevice*
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Encuentra el dispositivo de Intune por azureADDeviceId y lo elimina cuando removeIntuneDevice está establecido*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Encuentra y elimina la identidad de Autopilot cuando removeAutopilotDevice está establecido*
  * 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 de RBAC

* Cloud Device Administrator
  * *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. Lo establece el portal a partir del dispositivo seleccionado.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | verdadero                                                   |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado 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                     |
| ------------------------------ | ------------------------- |
| Requerido                      | falso                     |
| Valor predeterminado           | Verdadero                 |
| Tipo                           | Booleano                  |
| Nombre para mostrar del 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) | verdadero |
| No borrar el dispositivo                                                                       | falso     |

#### useProtectedWipe

Sigue intentando borrar incluso si el dispositivo se apaga entre medias, por lo que no se puede evitar el borrado apagándolo. Solo Windows.

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

#### removeIntuneDevice

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

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

**Opciones del portal**

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

#### removeAutopilotDevice

Eliminar el dispositivo de la base de datos de Autopilot le permite salir del Tenant y registrarse en otro lugar. Conservarlo permite un nuevo despliegue posterior en este Tenant. Solo Windows.

| Propiedad                      | Valor                                                 |
| ------------------------------ | ----------------------------------------------------- |
| Requerido                      | falso                                                 |
| Valor predeterminado           | Falso                                                 |
| Tipo                           | Booleano                                              |
| Nombre para mostrar del 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) | verdadero |
| Conservar el dispositivo en Autopilot                       | falso     |

#### removeAADDevice

Si el objeto de dispositivo de Entra ID se elimina después del borrado. Preestablecido en la personalización del runbook.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado | Falso                                                       |
| Tipo                 | Booleano                                                    |
| Oculto en el portal  | sí (preconfigurado 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                                               |
| ------------------------------ | --------------------------------------------------- |
| Requerido                      | falso                                               |
| Valor predeterminado           | Falso                                               |
| Tipo                           | Booleano                                            |
| Nombre para mostrar del portal | ¿Deshabilitar el objeto de dispositivo de Entra ID? |

**Opciones del portal**

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

#### skipWipeIfAtRisk

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

| Propiedad                      | Valor                                              |
| ------------------------------ | -------------------------------------------------- |
| Requerido                      | falso                                              |
| Valor predeterminado           | Falso                                              |
| Tipo                           | Booleano                                           |
| Nombre para mostrar del portal | ¿Borrar solo si el dispositivo no presenta riesgo? |

**Opciones del portal**

| Opción del portal                                                      | Valor     |
| ---------------------------------------------------------------------- | --------- |
| Borrar solo si la puntuación de riesgo de Defender no es media ni alta | verdadero |
| 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 reinscriba mediante Autopilot. Solo Windows.

| Propiedad                      | Valor                                                     |
| ------------------------------ | --------------------------------------------------------- |
| Requerido                      | falso                                                     |
| Valor predeterminado           | Falso                                                     |
| Tipo                           | Booleano                                                  |
| Nombre para mostrar del 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 | verdadero |
| No agregar al grupo de exclusión                          | falso     |

#### exclusionGroupName

Nombre para mostrar del grupo de exclusión al que se agrega el dispositivo. Tiene prioridad un ID de objeto preestablecido en la personalización del runbook.

| Propiedad                      | Valor                                                                          |
| ------------------------------ | ------------------------------------------------------------------------------ |
| Requerido                      | falso                                                                          |
| Valor predeterminado           | cfg - Intune - Windows - Compliance for unenrolled Autopilot devices (devices) |
| Tipo                           | Cadena                                                                         |
| Nombre para mostrar del portal | Nombre del grupo de exclusión de cumplimiento                                  |

#### exclusionGroupId

ID de objeto del grupo de exclusión. Preestablecido en la personalización del runbook y usado en lugar del nombre del grupo para evitar conflictos de nombres.

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

#### macOsRecoveryCode

Código de recuperación para Macs antiguos que necesitan uno para poder borrarse. Los dispositivos más nuevos lo ignoran. Preestablecido en la personalización del runbook.

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

#### macOsObliterationBehavior

Cómo se borra un Mac: borrar primero los datos del 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                                  |
| ------------------------------ | -------------------------------------- |
| Requerido                      | falso                                  |
| Valor predeterminado           | predeterminado                         |
| Tipo                           | Cadena                                 |
| Nombre para mostrar del portal | Comportamiento de obliteración (macOS) |

**Opciones del portal**

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

[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/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.