Retirar dispositivos
Borrar y limpiar varios dispositivos a la vez
Descripción
Pone fuera de servicio varios dispositivos de una sola vez, proporcionados como una lista de ID de dispositivo o números de serie. Puede elegir si se borran los dispositivos o si solo se eliminan de Intune, y si se elimina su registro de Autopilot. Sus objetos de Entra ID se pueden eliminar, deshabilitar o conservar. De forma opcional, 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 se puede deshacer.
Etiqueta de exclusión de Microsoft Defender for Endpoint
Microsoft Defender for Endpoint tiene un estado de exclusión Estado de exclusión (se muestra en el filtro Inventario de dispositivos como Excluido / No excluido). Este estado solo se puede establecer mediante el portal de Defender; no hay ninguna API para establecer mediante programación el estado de exclusión nativo de un dispositivo.
Dado que el estado de exclusión nativo no se puede automatizar, este runbook aplica en su lugar una etiqueta de dispositivo personalizada (predeterminada ExcludeFromRemediation) cuando Excluir dispositivos de Defender for Endpoint está habilitado. Cada dispositivo de la lista se busca mediante su ID de dispositivo de Entra ID y se etiqueta a través de POST /api/machines/{id}/tags, lo que proporciona un marcador que se puede usar para filtrar y seleccionar dispositivos excluidos.
Configuración única: hacer que la etiqueta se pueda filtrar
El filtro Etiquetas del portal solo enumera las etiquetas creadas mediante el portal. Una etiqueta establecida exclusivamente mediante la API se adjunta al dispositivo y es visible en la página del dispositivo, pero no aparece por sí sola en el filtro Etiquetas.
Para que la etiqueta de exclusión sea visible y se pueda usar para filtrar en el Inventario de dispositivos de Defender, se debe etiquetar manualmente una vez un cliente mediante el portal (seleccione 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 gran escala.
Nota: Esta etiqueta es solo una etiqueta identificativa; no establece el estado de exclusión nativo del dispositivo y no tiene ningún efecto de corrección por sí sola. Solo tiene efecto si un grupo de dispositivos de Defender o una regla de automatización está configurado explícitamente para coincidir con este valor de etiqueta. Estas reglas coinciden directamente con el valor de etiqueta, independientemente del filtro del portal Etiquetas , 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.
Los dispositivos proporcionados por número de serie que no se encuentran en Intune no tienen un ID de dispositivo de Entra ID y, por lo tanto, no se etiquetan en Defender.
Consulte Crear y administrar etiquetas de dispositivos para obtener más información.
Ubicación
Organización → Dispositivos → Retirar dispositivos
Nombre completo del runbook
rjgit-org_devices_outphase-devices
Detalles
Versión
1.2.1
Módulos requeridos
RealmJoin.RunbookHelper (>= 0.8.9)
Programable
no
Permisos
Permisos de aplicación
Tipo: Microsoft Graph
DeviceManagementManagedDevices.PrivilegedOperations.All
Activa 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 de 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 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 de RBAC
Administrador de dispositivos en la nube
Necesario para deshabilitar y eliminar objetos de dispositivo de Entra mediante /devices/{id}
Parámetros
DeviceListChoice
Indica si la lista contiene ID de dispositivo de Entra ID o números de serie.
Requerido
verdadero
Valor predeterminado
0
Tipo
Int32
Nombre para mostrar en el portal
La lista contiene
Opciones del portal
ID de dispositivos
0
Números de serie
1
DeviceList
ID de dispositivos o números de serie, separados por comas.
Requerido
verdadero
Valor predeterminado
Tipo
Cadena
Nombre para mostrar en el portal
Lista de dispositivos
intuneAction
El borrado completo elimina todos los datos de usuario y de inscripción de los dispositivos. Eliminar de Intune solo elimina los registros de dispositivos, para dispositivos que ya se borraron o destruyeron. No borrar ni eliminar deja Intune sin cambios.
Requerido
falso
Valor predeterminado
2
Tipo
Int32
Nombre para mostrar en el portal
Acción de Intune
Opciones del portal
Borrar completamente el dispositivo (sin conservar los datos de usuario ni de inscripción)
2
Eliminar dispositivo de Intune
1
No borrar ni eliminar el dispositivo de Intune
0
aadAction
Eliminar quita los objetos de dispositivo de Entra ID; Deshabilitar los conserva pero bloquea los inicios de sesión desde los dispositivos, y Conservar deja Entra ID sin cambios.
Requerido
falso
Valor predeterminado
2
Tipo
Int32
Nombre para mostrar en el portal
Objeto de Entra ID
Opciones del portal
Eliminar dispositivo en Entra ID
2
Deshabilitar 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" determina si se borran los dispositivos.
Requerido
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" determina si se eliminan los registros de Intune.
Requerido
falso
Valor predeterminado
Falso
Tipo
Booleano
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
removeAutopilotDevice
Quitar los dispositivos de la base de datos de Autopilot les permite salir del inquilino y registrarse en otro lugar. Conservarlos permite una implementación posterior en este inquilino.
Requerido
falso
Valor predeterminado
Verdadero
Tipo
Booleano
Nombre para mostrar en el portal
¿Eliminar de la base de datos de Autopilot?
Opciones del portal
Quitar el dispositivo de Autopilot
verdadero
Conservar dispositivo
falso
removeAADDevice
Interruptor heredado que se conserva por compatibilidad. La opción en "Objeto de Entra ID" determina si se eliminan los objetos de Entra ID.
Requerido
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" determina si se deshabilitan los objetos de Entra ID.
Requerido
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 sin cambios.
Requerido
falso
Valor predeterminado
Falso
Tipo
Booleano
Nombre para mostrar en el portal
¿Etiquetar como excluido en Defender for Endpoint?
Opciones del portal
Etiquetar dispositivos como excluidos en Defender for Endpoint
verdadero
Omitir operaciones de Defender
falso
defenderExclusionTag
Nombre de etiqueta escrito en los dispositivos en Defender for Endpoint, para su uso en las reglas de exclusión.
Requerido
falso
Valor predeterminado
ExcludeFromRemediation
Tipo
Cadena
Nombre para mostrar en el portal
Etiqueta de exclusión de Defender
Última actualización
¿Te fue útil?