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

# Dar de baja dispositivo

Borra este dispositivo Windows y limpia Intune, Autopilot y Entra ID

### Descripción

Saca este dispositivo Windows de servicio. Usted elige si el dispositivo se borra o solo se elimina de Intune, y si sale de la base de datos de Autopilot. Su objeto de Entra ID puede eliminarse, deshabilitarse o conservarse. Opcionalmente, el dispositivo se etiqueta en Microsoft Defender for Endpoint para que las reglas que usan la etiqueta puedan excluirlo de la corrección automática. Un borrado elimina todos los datos de usuario y de inscripción del dispositivo y no se puede deshacer.

### Etiqueta de exclusión de Microsoft Defender for Endpoint

Microsoft Defender for Endpoint tiene una **estado de exclusión** (se muestra en el filtro de Inventario de dispositivos como *Excluido* / *No excluido*). Este estado solo se puede configurar a través del portal de Defender; no existe **ninguna API** para establecer programáticamente el estado de exclusión nativo de un dispositivo.

Como el estado de exclusión nativo no se puede automatizar, este runbook aplica en su lugar una etiqueta personalizada del dispositivo (valor predeterminado `ExcludeFromRemediation`) cuando *Excluir dispositivo de Defender for Endpoint* está habilitado. El dispositivo se busca mediante su ID de dispositivo de Entra ID y se etiqueta a través de `POST /api/machines/{id}/tags`, proporcionando un marcador que se puede usar para filtrar y dirigir dispositivos excluidos.

#### Configuración única: hacer que la etiqueta sea filtrable

El filtro del portal **Etiquetas** filtro, por desgracia, solo muestra las etiquetas que se crearon a través del portal. Una etiqueta establecida únicamente mediante la API se adjunta al dispositivo y es visible en la página del dispositivo, pero no **no** aparece por sí sola en el filtro de Etiquetas.

Para hacer que la etiqueta de exclusión sea visible y utilizable para el filtrado en el [Inventario de dispositivos de Defender](https://security.microsoft.com/machines), se debe etiquetar manualmente un dispositivo una vez a través del portal (selecciona un dispositivo > **Administrar etiquetas** > "Crear nueva etiqueta", usando exactamente el mismo valor de etiqueta). Después de este paso único, la etiqueta pasa a ser una etiqueta conocida y filtrable, y este runbook puede aplicarla a dispositivos a escala.

> **Nota:** Esta etiqueta es solo una etiqueta: no establece el estado nativo de exclusión del dispositivo y, por sí sola, no tiene ningún efecto de remediación. Solo surte efecto si un grupo de dispositivos de Defender o una regla de automatización se configura explícitamente para coincidir con este valor de etiqueta. Estas reglas coinciden directamente con el valor de la etiqueta, independientemente del portal **Etiquetas** filtro, por lo que el paso manual único solo afecta a si la etiqueta se puede seleccionar para filtrar en la interfaz de usuario del portal.

Consulta [Crear y administrar etiquetas de dispositivo](https://learn.microsoft.com/defender-endpoint/machine-tags#create-tags) para más detalles.

### Ubicación

Dispositivo → General → Retirar dispositivo

**Nombre completo del runbook**

rjgit-dispositivo\_general\_retirar-dispositivo

### Detalles

| Propiedad          | Valor                               |
| ------------------ | ----------------------------------- |
| Versión            | 1.0.1                               |
| 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 la opción de borrado*
  * 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 ID y lee sus propietarios registrados para la salida de estado*
* **Tipo**: WindowsDefenderATP
  * Machine.Read.All
    * *Busca el dispositivo en Defender for Endpoint cuando excludeFromDefender está habilitado*
  * Machine.ReadWrite.All
    * *Agrega la etiqueta de exclusión mediante /machines/{id}/tags cuando excludeFromDefender está habilitado*

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

#### intuneAction

Borrado completo elimina todos los datos de usuario y de inscripción del dispositivo. Eliminar de Intune solo quita el registro del dispositivo, para dispositivos que ya están borrados o destruidos. No borrar ni quitar deja Intune intacto.

| Propiedad                      | Valor            |
| ------------------------------ | ---------------- |
| Requerido                      | falso            |
| Valor predeterminado           | 2                |
| Tipo                           | Int32            |
| Nombre para mostrar del portal | Acción de Intune |

**Opciones del portal**

| Opción del portal                                                                         | Valor |
| ----------------------------------------------------------------------------------------- | ----- |
| Borrar completamente el dispositivo (sin conservar los datos de usuario o de inscripción) | 2     |
| Eliminar el dispositivo de Intune (solo si el dispositivo ya está borrado o destruido)    | 1     |
| No borrar ni eliminar el dispositivo de Intune                                            | 0     |

#### aadAction

Eliminar quita el objeto del dispositivo de Entra ID, Deshabilitar lo conserva pero bloquea los inicios de sesión desde el dispositivo, y Conservar deja Entra ID intacto.

| Propiedad                      | Valor              |
| ------------------------------ | ------------------ |
| Requerido                      | falso              |
| Valor predeterminado           | 2                  |
| Tipo                           | Int32              |
| Nombre para mostrar del portal | Objeto de Entra ID |

**Opciones del portal**

| Opción del portal                       | Valor |
| --------------------------------------- | ----- |
| Eliminar el dispositivo en Entra ID     | 2     |
| Deshabilitar el dispositivo en Entra ID | 1     |
| Conservar el dispositivo de Entra ID    | 0     |

#### wipeDevice

Interruptor heredado mantenido por compatibilidad. La opción bajo "Acción de Intune" decide si el dispositivo se borra.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado | Verdadero                                                   |
| Tipo                 | Booleano                                                    |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### removeIntuneDevice

Interruptor heredado mantenido por compatibilidad. La opción bajo "Acción de Intune" decide si se elimina el registro de Intune.

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

#### removeAutopilotDevice

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

| Propiedad                      | Valor                                                      |
| ------------------------------ | ---------------------------------------------------------- |
| Requerido                      | falso                                                      |
| Valor predeterminado           | Verdadero                                                  |
| Tipo                           | Booleano                                                   |
| Nombre para mostrar del portal | ¿Eliminar el dispositivo de la base de datos de Autopilot? |

**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

Interruptor heredado mantenido por compatibilidad. La opción bajo "Objeto de Entra ID" decide si se elimina el objeto de Entra ID.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado | Verdadero                                                   |
| Tipo                 | Booleano                                                    |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### disableAADDevice

Interruptor heredado mantenido por compatibilidad. La opción bajo "Objeto de Entra ID" decide si se deshabilita el objeto de Entra ID.

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

#### excludeFromDefender

Etiqueta el dispositivo en Microsoft Defender for Endpoint con la etiqueta de exclusión para que las reglas que usan la etiqueta puedan excluirlo de la corrección automática. Omitir deja Defender intacto.

| Propiedad                      | Valor                                                        |
| ------------------------------ | ------------------------------------------------------------ |
| Requerido                      | falso                                                        |
| Valor predeterminado           | Falso                                                        |
| Tipo                           | Booleano                                                     |
| Nombre para mostrar del portal | ¿Etiquetar como excluido en Microsoft Defender for Endpoint? |

**Opciones del portal**

| Opción del portal                                            | Valor     |
| ------------------------------------------------------------ | --------- |
| Etiquetar dispositivo como excluido en Defender for Endpoint | verdadero |
| Omitir operaciones de Defender                               | falso     |

#### defenderExclusionTag

Nombre de etiqueta escrito en el dispositivo en Defender for Endpoint, para usarlo en sus reglas de exclusión.

| Propiedad                      | Valor                             |
| ------------------------------ | --------------------------------- |
| Requerido                      | falso                             |
| Valor predeterminado           | ExcludeFromRemediation            |
| Tipo                           | Cadena                            |
| Nombre para mostrar del portal | Etiqueta de exclusión de Defender |

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