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

# Apagar dispositivo

Apagar este dispositivo Windows ou macOS e limpar os respetivos registos

### Descrição

Apaga este dispositivo Windows ou macOS. Opcionalmente, também limpa o que resta dele: o registo do Intune, o registo do Autopilot e o objeto do Entra ID podem ser eliminados ou desativados. Para Windows, pode escolher uma limpeza protegida e um período de tolerância de conformidade mais longo após a reinscrição; para macOS, um código de recuperação e a forma como o sistema operativo é apagado. Uma limpeza remove todos os dados do dispositivo e não pode ser desfeita. A limpeza pode ser ignorada quando o Microsoft Defender for Endpoint classifica o dispositivo como de risco médio ou alto.

### Apagar apenas se o dispositivo não estiver em risco

Quando *Apagar apenas se o dispositivo não estiver em risco* (`skipWipeIfAtRisk`) estiver ativado, o runbook verifica a pontuação de risco do dispositivo no Microsoft Defender for Endpoint antes de qualquer objeto de dispositivo ser tocado. A pesquisa usa o ID de dispositivo do Entra e é a mesma consulta que o **Verificar estado do Microsoft Defender** o runbook executa. A verificação está desativada por predefinição e só é executada quando é solicitada uma limpeza; é ignorada quando *Não apagar o dispositivo* é selecionado.

Resultados possíveis:

* **Sem risco elevado** (pontuação de risco `Nenhum`, `Informativo` ou `Baixo`): a limpeza e as ações de limpeza selecionadas são executadas normalmente.
* **Pontuação de risco `Médio` ou `Alto`**: o runbook é interrompido com um aviso antes da limpeza, da pertença ao grupo de exclusão, das alterações no Entra ID e das eliminações no Intune/Autopilot. Um dispositivo com uma pontuação de risco elevada pode estar envolvido num incidente de segurança, e apagá-lo poderá destruir dados forenses (por exemplo, registos). Alinhe primeiro com a sua equipa de segurança; para apagar o dispositivo na mesma, execute o runbook com a opção desativada.
* **Dispositivo não encontrado no Microsoft Defender for Endpoint**: a pontuação de risco não pode ser determinada. O runbook regista isso e prossegue com a limpeza, pelo que os dispositivos que não estão integrados no Defender não são bloqueados.
* **A consulta ao Microsoft Defender for Endpoint falha**: o runbook para sem apagar, pelo que um problema temporário da API nunca contorna a proteção.

#### Ativar a verificação por predefinição

Para impor a verificação em todas as limpezas, predefina o parâmetro e oculte-o, para que não possa ser desativado a partir do portal.

A configuração JSON para isto é a seguinte:

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "skipWipeIfAtRisk": {
            "Default": true,
            "Hide": true
        }
    }
}
```

### Adicionar o dispositivo a um grupo de exclusão de conformidade

Quando *Adicionar dispositivo ao grupo de exclusão de conformidade* (`addToExclusionGroup`) estiver ativado, o dispositivo Windows apagado é adicionado a um grupo de exclusão de conformidade. Os dispositivos desse grupo recebem um período de tolerância de conformidade mais longo depois de serem reinscritos via Autopilot (isto espelha o **Verificar exclusão da integração do dispositivo** runbook).

Por predefinição, o grupo é identificado pelo seu **nome de apresentação** (`exclusionGroupName`). Como os nomes de apresentação não têm garantia de serem exclusivos, pode em alternativa fixar o grupo pelo seu **ID do objeto** (`exclusionGroupId`). Quando é fornecido um ID do objeto, este **sempre substitui** o nome de apresentação, pelo que conflitos de nomes nunca podem levar à utilização do grupo errado. `exclusionGroupId` está oculto por predefinição e destina-se a ser definido através da personalização do runbook.

O grupo é resolvido e validado numa verificação prévia inicial. Se o grupo configurado não existir, o runbook aborta **antes de** qualquer ação de apagar/eliminar/desativar, para que não fique nenhum estado aplicado pela metade. A adição ao grupo é ignorada para dispositivos que não sejam Windows e quando o dispositivo é eliminado do Entra ID (`removeAADDevice`).

#### Fixar o grupo por ID do objeto (recomendado)

Predefina o ID do objeto do grupo e ative o interruptor, mantendo os campos ocultos. Isto evita qualquer ambiguidade causada por nomes de apresentação duplicados.

A configuração JSON para isto é a seguinte:

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "addToExclusionGroup": {
            "Default": true
        },
        "exclusionGroupId": {
            "Default": "00000000-0000-0000-0000-000000000000",
            "Hide": true
        },
        "exclusionGroupName": {
            "Hide": true
        }
    }
}
```

Substitua `00000000-0000-0000-0000-000000000000` com o ID do objeto do seu grupo (EntraID > Groups > *o seu grupo* > **ID do objeto**).

#### Fixar o grupo pelo nome de apresentação

Se preferir trabalhar com o nome de apresentação (e ele for exclusivo no seu tenant), predefina `exclusionGroupName` e deixe `exclusionGroupId` em branco para que o nome seja utilizado.

A configuração JSON para isto é a seguinte:

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "addToExclusionGroup": {
            "Default": true
        },
        "exclusionGroupName": {
            "Default": "cfg - Intune - Windows - Conformidade para dispositivos Autopilot não inscritos (dispositivos)",
            "Hide": true
        }
    }
}
```

### Opções de limpeza do macOS

Os dispositivos macOS são apagados através da ação de apagamento do Intune. Duas opções aplicam-se apenas a eles:

* **Código de recuperação (macOS)** (`macOsRecoveryCode`): os Macs mais antigos precisam de um código de recuperação de seis dígitos para aceitarem a limpeza; os dispositivos mais recentes ignoram-no. O parâmetro está oculto no portal e pode ser predefinido através da personalização do runbook.
* **Comportamento de eliminação completa (macOS)** (`macOsObliterationBehavior`): decide o que acontece quando *Apagar todo o conteúdo e definições* (EACS) não é possível. `predefinição` apaga os dados do utilizador e, se isso falhar, passa a apagar todo o sistema operativo, `doNotObliterate` nunca apaga o sistema operativo, `obliterateWithWarning` avisa e depois apaga o sistema operativo, `sempre` apaga o sistema operativo em qualquer caso.

Opções apenas para Windows (*limpeza protegida*, *base de dados do Autopilot*, *grupo de exclusão de conformidade*) são ignoradas para dispositivos macOS.

### Localização

Dispositivo → Geral → Apagar dispositivo

**Nome completo do runbook**

rjgit-device\_general\_wipe-device

### Detalhes

| Propriedade         | Valor                               |
| ------------------- | ----------------------------------- |
| Versão              | 1.1.0                               |
| 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 wipeDevice é selecionado*
  * 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
    * *Resolve o dispositivo do Entra e lê os respetivos proprietários registados para o relatório*
  * GroupMember.ReadWrite.All
    * *Adiciona o dispositivo ao grupo de exclusão quando addToExclusionGroup está ativado*
* **Tipo**: WindowsDefenderATP
  * Machine.Read.All *(opcional — funcionalidade: verificação de risco do Defender)*
    * *Lê a pontuação de risco do dispositivo no Microsoft Defender for Endpoint na verificação prévia skipWipeIfAtRisk*

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

#### wipeDevice

Apagar completamente remove todos os dados do utilizador e de inscrição do dispositivo. Não apagar deixa o dispositivo inalterado e executa apenas os passos de limpeza selecionados.

| Propriedade                | Valor                    |
| -------------------------- | ------------------------ |
| Obrigatório                | falso                    |
| Valor padrão               | Verdadeiro               |
| Tipo                       | Booleano                 |
| Nome de exibição no portal | Apagar este dispositivo? |

**Opções do portal**

| Opção do portal                                                                              | Valor      |
| -------------------------------------------------------------------------------------------- | ---------- |
| Apagar completamente o dispositivo (Windows: não manter dados do utilizador ou de inscrição) | verdadeiro |
| Não apagar o dispositivo                                                                     | falso      |

#### useProtectedWipe

Continua a tentar apagar mesmo que o dispositivo seja desligado entretanto, para que a limpeza não possa ser evitada desligando-o. Apenas Windows.

| Propriedade                | Valor                             |
| -------------------------- | --------------------------------- |
| Obrigatório                | falso                             |
| Valor padrão               | Falso                             |
| Tipo                       | Booleano                          |
| Nome de exibição no portal | Usar limpeza protegida (Windows)? |

#### removeIntuneDevice

Elimina o registo do dispositivo no Intune. Só faz sentido quando o dispositivo já foi apagado ou destruído.

| Propriedade                | Valor                           |
| -------------------------- | ------------------------------- |
| Obrigatório                | falso                           |
| Valor padrão               | Falso                           |
| Tipo                       | Booleano                        |
| Nome de exibição no portal | Eliminar dispositivo do Intune? |

**Opções do portal**

| Opção do portal                                                                          | Valor      |
| ---------------------------------------------------------------------------------------- | ---------- |
| Eliminar dispositivo do Intune (apenas se o dispositivo já estiver apagado ou destruído) | verdadeiro |
| Manter o registo do Intune                                                               | falso      |

#### removeAutopilotDevice

Remover o dispositivo da base de dados do Autopilot permite que ele saia do tenant e seja registado noutro lugar. Mantê-lo permite uma reimplementação posterior neste tenant. Apenas Windows.

| Propriedade                | Valor                                             |
| -------------------------- | ------------------------------------------------- |
| Obrigatório                | falso                                             |
| Valor padrão               | Falso                                             |
| Tipo                       | Booleano                                          |
| Nome de exibição no portal | Eliminar da base de dados do Autopilot (Windows)? |

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

Se o objeto de dispositivo do Entra ID é eliminado após a limpeza. Predefinido na personalização do runbook.

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

#### disableAADDevice

Desativar bloqueia os inícios de sessão a partir do dispositivo, mas mantém o respetivo objeto no Entra ID. Manter deixa o objeto do Entra ID inalterado.

| Propriedade                | Valor                                        |
| -------------------------- | -------------------------------------------- |
| Obrigatório                | falso                                        |
| Valor padrão               | Falso                                        |
| Tipo                       | Booleano                                     |
| Nome de exibição no portal | Desativar objeto de dispositivo do Entra ID? |

**Opções do portal**

| Opção do portal                             | Valor      |
| ------------------------------------------- | ---------- |
| Desativar dispositivo no Entra ID           | verdadeiro |
| Manter o dispositivo do Entra ID inalterado | falso      |

#### skipWipeIfAtRisk

Ignora a limpeza quando o Microsoft Defender for Endpoint classifica o dispositivo como de risco médio ou alto. Isso mantém as provas intactas num dispositivo que pode fazer parte de um incidente de segurança.

| Propriedade                | Valor                                                |
| -------------------------- | ---------------------------------------------------- |
| Obrigatório                | falso                                                |
| Valor padrão               | Falso                                                |
| Tipo                       | Booleano                                             |
| Nome de exibição no portal | Apagar apenas se o dispositivo não estiver em risco? |

**Opções do portal**

| Opção do portal                                                         | Valor      |
| ----------------------------------------------------------------------- | ---------- |
| Apagar apenas se a pontuação de risco do Defender não for média ou alta | verdadeiro |
| Apagar independentemente da pontuação de risco do Defender              | falso      |

#### addToExclusionGroup

Adiciona o dispositivo ao grupo de exclusão de conformidade para que obtenha um período de tolerância de conformidade mais longo quando for reinscrito através do Autopilot. Apenas Windows.

| Propriedade                | Valor                                                     |
| -------------------------- | --------------------------------------------------------- |
| Obrigatório                | falso                                                     |
| Valor padrão               | Falso                                                     |
| Tipo                       | Booleano                                                  |
| Nome de exibição no portal | Adicionar ao grupo de exclusão de conformidade (Windows)? |

**Opções do portal**

| Opção do portal                                            | Valor      |
| ---------------------------------------------------------- | ---------- |
| Adicionar dispositivo ao grupo de exclusão de conformidade | verdadeiro |
| Não adicionar ao grupo de exclusão                         | falso      |

#### exclusionGroupName

Nome de apresentação do grupo de exclusão ao qual o dispositivo é adicionado. Um ID do objeto predefinido na personalização do runbook tem precedência.

| Propriedade                | Valor                                                                                          |
| -------------------------- | ---------------------------------------------------------------------------------------------- |
| Obrigatório                | falso                                                                                          |
| Valor padrão               | cfg - Intune - Windows - Conformidade para dispositivos Autopilot não inscritos (dispositivos) |
| Tipo                       | Texto                                                                                          |
| Nome de exibição no portal | Nome do grupo de exclusão de conformidade                                                      |

#### exclusionGroupId

ID do objeto do grupo de exclusão. Predefinido na personalização do runbook e usado em vez do nome do grupo para evitar conflitos de nomes.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               |                                                         |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | ID do objeto do grupo de exclusão de conformidade       |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

#### macOsRecoveryCode

Código de recuperação para Macs mais antigos que precisam de um para serem apagados. Os dispositivos mais recentes ignoram-no. Predefinido na personalização do runbook.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               | 123456                                                  |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Código de recuperação (macOS)                           |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

#### macOsObliterationBehavior

Como um Mac é apagado: apagar primeiro os dados do utilizador e, se isso falhar, passar a apagar o sistema operativo, nunca apagar o sistema operativo, avisar antes de apagar o sistema operativo, ou apagar sempre o sistema operativo.

| Propriedade                | Valor                                        |
| -------------------------- | -------------------------------------------- |
| Obrigatório                | falso                                        |
| Valor padrão               | predefinição                                 |
| Tipo                       | Texto                                        |
| Nome de exibição no portal | Comportamento de eliminação completa (macOS) |

**Opções do portal**

| Opção do portal                                                                          | Valor                 |
| ---------------------------------------------------------------------------------------- | --------------------- |
| Apagar os dados do utilizador (EACS), apagar o sistema operativo se isso falhar          | predefinição          |
| Apagar os dados do utilizador (EACS), nunca apagar o sistema operativo                   | doNotObliterate       |
| Apagar os dados do utilizador (EACS), caso contrário avisar e apagar o sistema operativo | obliterateWithWarning |
| Apagar sempre o sistema operativo                                                        | sempre                |

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