> 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/pt/automatizacao/runbooks/runbook-references/device/general/outphase-device.md).

# Retirar dispositivo

Apagar este dispositivo Windows e limpar o Intune, o Autopilot e o Entra ID

### Descrição

Retira este dispositivo Windows de serviço. Você escolhe se o dispositivo é apagado ou apenas excluído do Intune, e se ele sai da base de dados do Autopilot. O seu objeto do Entra ID pode ser excluído, desativado ou mantido. Opcionalmente, o dispositivo é marcado no Microsoft Defender for Endpoint para que as regras que usam a tag o possam excluir da correção automatizada. Um apagamento remove todos os dados do utilizador e de registo do dispositivo e não pode ser desfeito.

### Etiqueta de exclusão do Microsoft Defender for Endpoint

Microsoft Defender for Endpoint tem uma **Estado de exclusão** (mostrado no filtro de Inventário de Dispositivos como *Excluído* / *Não excluído*). Este estado só pode ser definido através do portal Defender — não existe **nenhuma API** para definir programaticamente o estado de exclusão nativo de um dispositivo.

Como o estado de exclusão nativo não pode ser automatizado, este runbook aplica em vez disso uma etiqueta personalizada do dispositivo (predefinição `ExcludeFromRemediation`) quando *Excluir dispositivo do Defender for Endpoint* está ativado. O dispositivo é localizado pelo seu ID de dispositivo do Entra ID e marcado através de `POST /api/machines/{id}/tags`, fornecendo um marcador que pode ser usado para filtrar e direcionar dispositivos excluídos.

#### Configuração única: tornar a etiqueta filtrável

O filtro Tags do portal só lista etiquetas que foram criadas através do portal. Uma etiqueta definida apenas via API fica associada ao dispositivo e visível na página do dispositivo, mas não **Tags** o filtro, infelizmente, lista apenas tags que foram criadas através do portal. Uma tag definida apenas via API é associada ao dispositivo e visível na página do dispositivo, mas não **não** aparece por si só no filtro Tags.

Para tornar a etiqueta de exclusão visível e utilizável para filtragem no [Inventário de Dispositivos do Defender](https://security.microsoft.com/machines), um cliente deve ser etiquetado manualmente uma vez através do portal (selecionar um dispositivo > **Gerir etiquetas** > "Criar nova etiqueta", usando exatamente o mesmo valor de etiqueta). Após este passo único, a etiqueta torna-se uma etiqueta conhecida e filtrável, e este runbook pode aplicá-la a dispositivos em escala.

> **Observação:** Esta etiqueta é apenas um rótulo — não define o estado de Exclusão nativo do dispositivo e, por si só, não tem qualquer efeito de remediação. Só produz efeito se um grupo de dispositivos Defender ou uma regra de automação estiver explicitamente configurado para corresponder a este valor de etiqueta. Essas regras correspondem diretamente ao valor da etiqueta, independentemente do filtro do portal, pelo que o passo manual único só afeta se a etiqueta pode ser selecionada para filtragem na interface do portal. **Tags** filtro, pelo que o passo manual único só afeta se a etiqueta pode ser selecionada para filtragem na interface do portal.

Consulte [Criar e gerir etiquetas de dispositivos](https://learn.microsoft.com/defender-endpoint/machine-tags#create-tags) para mais detalhes.

### Localização

Dispositivo → Geral → Retirar dispositivo de serviço

**Nome completo do runbook**

rjgit-device\_general\_outphase-device

### Detalhes

| Propriedade         | Valor                               |
| ------------------- | ----------------------------------- |
| Versão              | 1.0.1                               |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.10) |
| Agendável           | não                                 |

### Permissões

#### Permissões de aplicativo

* **Tipo**: Microsoft Graph
  * DeviceManagementManagedDevices.PrivilegedOperations.All
    * *Aciona a ação de apagamento do Intune quando a opção de apagamento é selecionada*
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Encontra o dispositivo do Intune por azureADDeviceId e elimina-o quando removeIntuneDevice está definido*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Encontra e elimina a identidade do Autopilot quando removeAutopilotDevice está definido*
  * Device.Read.All
    * *Localiza o dispositivo no Entra ID e lê os respetivos proprietários registados para a saída de estado*
* **Tipo**: WindowsDefenderATP
  * Machine.Read.All
    * *Procura o dispositivo no Defender for Endpoint quando excludeFromDefender está ativado*
  * Machine.ReadWrite.All
    * *Adiciona a etiqueta de exclusão através de /machines/{id}/tags quando excludeFromDefender está ativado*

#### Funções RBAC

* Administrador de Dispositivos na Nuvem
  * *Necessário para desativar e eliminar o objeto de dispositivo do Entra através de /devices/{id}*

### Parâmetros

#### ID do dispositivo

ID do dispositivo do Entra ID do dispositivo sobre o qual o runbook atua. Definido pelo portal a partir do dispositivo selecionado.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | verdadeiro                                              |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### intuneAction

Apagamento completo remove todos os dados do utilizador e de registo do dispositivo. Excluir do Intune apenas remove o registo do dispositivo, para dispositivos que já estão apagados ou destruídos. Não apagar ou remover deixa o Intune intocado.

| Propriedade                | Valor          |
| -------------------------- | -------------- |
| Obrigatório                | falso          |
| Valor padrão               | 2              |
| Tipo                       | Int32          |
| Nome de exibição no portal | Ação do Intune |

**Opções do portal**

| Opção do portal                                                                          | Valor |
| ---------------------------------------------------------------------------------------- | ----- |
| Apagar completamente o dispositivo (sem manter dados do utilizador ou de inscrição)      | 2     |
| Eliminar dispositivo do Intune (apenas se o dispositivo já estiver apagado ou destruído) | 1     |
| Não apagar nem remover o dispositivo do Intune                                           | 0     |

#### aadAction

Excluir remove o objeto do dispositivo do Entra ID, Desativar mantém-no mas bloqueia os inícios de sessão a partir do dispositivo, e Manter deixa o Entra ID intocado.

| Propriedade                | Valor           |
| -------------------------- | --------------- |
| Obrigatório                | falso           |
| Valor padrão               | 2               |
| Tipo                       | Int32           |
| Nome de exibição no portal | Objeto Entra ID |

**Opções do portal**

| Opção do portal                   | Valor |
| --------------------------------- | ----- |
| Eliminar dispositivo no Entra ID  | 2     |
| Desativar dispositivo no Entra ID | 1     |
| Manter o dispositivo Entra ID     | 0     |

#### wipeDevice

Interruptor legado mantido por compatibilidade. A opção em "Ação do Intune" decide se o dispositivo é apagado.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | Verdadeiro                                              |
| Tipo             | Booleano                                                |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### removeIntuneDevice

Interruptor legado mantido por compatibilidade. A opção em "Ação do Intune" decide se o registo do Intune é excluído.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | Falso                                                   |
| Tipo             | Booleano                                                |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### removeAutopilotDevice

Remover o dispositivo da base de dados do Autopilot permite que ele saia do tenant e seja registado noutro local. Mantê-lo permite uma futura reimplantação neste tenant.

| Propriedade                | Valor                                              |
| -------------------------- | -------------------------------------------------- |
| Obrigatório                | falso                                              |
| Valor padrão               | Verdadeiro                                         |
| Tipo                       | Booleano                                           |
| Nome de exibição no portal | Remover dispositivo da base de dados do Autopilot? |

**Opções do portal**

| Opção do portal                                          | Valor      |
| -------------------------------------------------------- | ---------- |
| Remover do Autopilot (o dispositivo pode sair do tenant) | verdadeiro |
| Manter o dispositivo no Autopilot                        | falso      |

#### removeAADDevice

Interruptor legado mantido por compatibilidade. A opção em "Objeto do Entra ID" decide se o objeto do Entra ID é excluído.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | Verdadeiro                                              |
| Tipo             | Booleano                                                |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### disableAADDevice

Interruptor legado mantido por compatibilidade. A opção em "Objeto do Entra ID" decide se o objeto do Entra ID é desativado.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | Falso                                                   |
| Tipo             | Booleano                                                |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### excludeFromDefender

Marca o dispositivo no Microsoft Defender for Endpoint com a tag de exclusão para que as regras que usam a tag o possam excluir da correção automatizada. Ignorar deixa o Defender intocado.

| Propriedade                | Valor                                                       |
| -------------------------- | ----------------------------------------------------------- |
| Obrigatório                | falso                                                       |
| Valor padrão               | Falso                                                       |
| Tipo                       | Booleano                                                    |
| Nome de exibição no portal | Etiquetar como excluído em Microsoft Defender for Endpoint? |

**Opções do portal**

| Opção do portal                                           | Valor      |
| --------------------------------------------------------- | ---------- |
| Marcar dispositivo como excluído no Defender for Endpoint | verdadeiro |
| Ignorar operações do Defender                             | falso      |

#### defenderExclusionTag

Nome da tag escrito no dispositivo no Defender for Endpoint, para uso nas suas regras de exclusão.

| Propriedade                | Valor                            |
| -------------------------- | -------------------------------- |
| Obrigatório                | falso                            |
| Valor padrão               | ExcludeFromRemediation           |
| Tipo                       | Texto                            |
| Nome de exibição no portal | Etiqueta de exclusão do Defender |

[Voltar à visão geral da referência do runbook](https://docs.realmjoin.com/pt/automatizacao/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/pt/automatizacao/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.
