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

# Retirar dispositivos

Borrar y limpiar varios dispositivos a la vez

### Descripción

Saca varios dispositivos del servicio de una sola vez, proporcionados como una lista de ID de dispositivo o números de serie. Tú eliges si los dispositivos se borran o solo se eliminan de Intune, y si se quita su registro de Autopilot. Sus objetos de Entra ID pueden eliminarse, deshabilitarse o conservarse. Opcionalmente, los dispositivos se etiquetan en Microsoft Defender for Endpoint para que las reglas que usan la etiqueta puedan excluirlos de la corrección automatizada. Un borrado elimina todos los datos y no puede deshacerse.

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

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

Como el estado nativo de exclusión no puede automatizarse, este runbook aplica en su lugar una etiqueta personalizada para el dispositivo (predeterminada `ExcludeFromRemediation`) cuando *Excluir dispositivos de Microsoft Defender for Endpoint* está habilitado. Se busca cada dispositivo de la lista por su ID de dispositivo de Entra ID y se etiqueta mediante `POST /api/machines/{id}/tags`, proporcionando un marcador que puede usarse para filtrar y dirigir los dispositivos excluidos.

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

El filtro de **Etiquetas** del portal 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 filtrar en el [Inventario de dispositivos de Defender](https://security.microsoft.com/machines), un cliente debe etiquetarse manualmente 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 se convierte en una etiqueta conocida y filtrable, y este runbook puede aplicarla a dispositivos a escala.

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

Los dispositivos proporcionados por número de serie que no se encuentran en Intune no tienen ID de dispositivo de Entra ID y, por lo tanto, no se etiquetan en Defender.

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

### Ubicación

Organization → Devices → Outphase Devices

**Nombre completo del runbook**

rjgit-org\_devices\_outphase-devices

### Detalles

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

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * DeviceManagementManagedDevices.PrivilegedOperations.All
    * *Inicia el borrado del dispositivo mediante managedDevices/{id}/wipe cuando se selecciona la acción de borrado*
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Busca dispositivos de Intune por número de serie o azureADDeviceId y los elimina*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Busca y elimina el registro Autopilot del dispositivo*
  * Device.Read.All
    * *Busca el objeto de dispositivo de Entra y su propietario registrado para el informe*
* **Tipo**: WindowsDefenderATP
  * Machine.Read.All
    * *Busca el dispositivo en Microsoft Defender for Endpoint mediante /machines filtrado por aadDeviceId*
  * Machine.ReadWrite.All
    * *Agrega la etiqueta de exclusión mediante /machines/{id}/tags cuando excludeFromDefender está habilitado*

#### roles RBAC

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

### Parámetros

#### DeviceListChoice

Si la lista contiene ID de dispositivo de Entra ID o números de serie.

| Propiedad                        | Valor             |
| -------------------------------- | ----------------- |
| Obligatorio                      | true              |
| Valor predeterminado             | 0                 |
| Tipo                             | Int32             |
| Nombre para mostrar en el portal | La lista contiene |

**Opciones del portal**

| Opción del portal | Valor |
| ----------------- | ----- |
| ID de dispositivo | 0     |
| Números de serie  | 1     |

#### DeviceList

ID de dispositivo o números de serie, separados por comas.

| Propiedad                        | Valor                 |
| -------------------------------- | --------------------- |
| Obligatorio                      | true                  |
| Valor predeterminado             |                       |
| Tipo                             | Cadena                |
| Nombre para mostrar en el portal | Lista de dispositivos |

#### intuneAction

Borrar completamente elimina todos los datos de usuario y de inscripción de los dispositivos. Eliminar solo de Intune quita únicamente los registros del dispositivo, para dispositivos que ya están borrados o destruidos. No borrar ni quitar deja Intune intacto.

| Propiedad                        | Valor            |
| -------------------------------- | ---------------- |
| Obligatorio                      | falso            |
| Valor predeterminado             | 2                |
| Tipo                             | Int32            |
| Nombre para mostrar en el portal | Acción de Intune |

**Opciones del portal**

| Opción del portal                                                                      | Valor |
| -------------------------------------------------------------------------------------- | ----- |
| Borrar completamente el dispositivo (sin conservar datos de usuario ni de inscripción) | 2     |
| Eliminar el dispositivo de Intune                                                      | 1     |
| No borrar ni quitar el dispositivo de Intune                                           | 0     |

#### aadAction

Eliminar quita los objetos de dispositivo de Entra ID, Deshabilitar los mantiene pero bloquea los inicios de sesión desde los dispositivos, y Conservar deja Entra ID intacto.

| Propiedad                        | Valor              |
| -------------------------------- | ------------------ |
| Obligatorio                      | falso              |
| Valor predeterminado             | 2                  |
| Tipo                             | Int32              |
| Nombre para mostrar en el 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 que se conserva por compatibilidad. La opción en "Acción de Intune" decide si los dispositivos se borran.

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

#### removeIntuneDevice

Interruptor heredado que se conserva por compatibilidad. La opción en "Acción de Intune" decide si se eliminan los registros de Intune.

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

#### removeAutopilotDevice

Eliminar los dispositivos de la base de datos de Autopilot les permite salir del tenant y registrarse en otro lugar. Conservarlos permite una redistribución posterior en este tenant.

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

**Opciones del portal**

| Opción del portal                  | Valor |
| ---------------------------------- | ----- |
| Quitar el dispositivo de Autopilot | true  |
| Conservar dispositivo              | falso |

#### removeAADDevice

Interruptor heredado que se conserva por compatibilidad. La opción en "Objeto de Entra ID" decide si los objetos de Entra ID se eliminan.

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

#### disableAADDevice

Interruptor heredado que se conserva por compatibilidad. La opción en "Objeto de Entra ID" decide si los objetos de Entra ID se deshabilitan.

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

#### excludeFromDefender

Etiqueta los dispositivos en Microsoft Defender for Endpoint con la etiqueta de exclusión para que las reglas que usan la etiqueta puedan excluirlos de la corrección automatizada. Omitir deja Defender intacto.

| Propiedad                        | Valor                                                         |
| -------------------------------- | ------------------------------------------------------------- |
| Obligatorio                      | falso                                                         |
| Valor predeterminado             | Falso                                                         |
| Tipo                             | Booleano                                                      |
| Nombre para mostrar en el portal | ¿Etiquetar como excluidos en Microsoft Defender for Endpoint? |

**Opciones del portal**

| Opción del portal                                                        | Valor |
| ------------------------------------------------------------------------ | ----- |
| Etiquetar dispositivos como excluidos en Microsoft Defender for Endpoint | true  |
| Omitir operaciones de Defender                                           | falso |

#### defenderExclusionTag

Nombre de la etiqueta escrito en los dispositivos en Microsoft Defender for Endpoint, para usarlo en tus reglas de exclusión.

| Propiedad                        | Valor                             |
| -------------------------------- | --------------------------------- |
| Obligatorio                      | falso                             |
| Valor predeterminado             | ExcludeFromRemediation            |
| Tipo                             | Cadena                            |
| Nombre para mostrar en el portal | Etiqueta de exclusión de Defender |

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