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

# Descontinuar dispositivos

Limpar e remover vários dispositivos de uma só vez

### Descrição

Tira vários dispositivos de serviço de uma só vez, fornecidos como uma lista de IDs de dispositivo ou números de série. Você escolhe se os dispositivos são apagados ou apenas eliminados do Intune, e se o respetivo registo do Autopilot é removido. Os seus objetos Entra ID podem ser eliminados, desativados ou mantidos. Opcionalmente, os dispositivos são etiquetados em Microsoft Defender for Endpoint para que as regras que usam a etiqueta os possam excluir da remediação automatizada. Um apagamento remove todos os dados 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 dispositivos do Microsoft Defender for Endpoint* está ativado. Cada dispositivo da lista é pesquisado pelo respetivo ID de dispositivo Entra ID e etiquetado 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** aparece por si só no filtro Tags. **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.

Os dispositivos fornecidos por número de série que não são encontrados no Intune não têm ID de dispositivo Entra ID e, por isso, não são etiquetados no Defender.

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

### Localização

Organização → Dispositivos → Outphase Devices

**Nome completo do runbook**

rjgit-org\_devices\_outphase-devices

### Detalhes

| Propriedade         | Valor                               |
| ------------------- | ----------------------------------- |
| Versão              | 1.2.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 o apagamento do dispositivo através de managedDevices/{id}/wipe quando a ação de apagamento é selecionada*
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Procura dispositivos Intune por número de série ou azureADDeviceId e elimina-os*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Encontra e elimina o registo do Autopilot do dispositivo*
  * Device.Read.All
    * *Procura o objeto de dispositivo Entra e o respetivo proprietário registado para o relatório*
* **Tipo**: WindowsDefenderATP
  * Machine.Read.All
    * *Encontra o dispositivo em Microsoft Defender for Endpoint através de /machines filtrado por aadDeviceId*
  * 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 objetos de dispositivo Entra através de /devices/{id}*

### Parâmetros

#### DeviceListChoice

Se a lista contém IDs de dispositivo Entra ID ou números de série.

| Propriedade                | Valor          |
| -------------------------- | -------------- |
| Obrigatório                | verdadeiro     |
| Valor padrão               | 0              |
| Tipo                       | Int32          |
| Nome de exibição no portal | A lista contém |

**Opções do portal**

| Opção do portal    | Valor |
| ------------------ | ----- |
| IDs de dispositivo | 0     |
| Números de série   | 1     |

#### DeviceList

IDs de dispositivo ou números de série, separados por vírgulas.

| Propriedade                | Valor                 |
| -------------------------- | --------------------- |
| Obrigatório                | verdadeiro            |
| Valor padrão               |                       |
| Tipo                       | Texto                 |
| Nome de exibição no portal | Lista de dispositivos |

#### intuneAction

Apagar completamente elimina todos os dados do utilizador e de inscrição dos dispositivos. Eliminar apenas do Intune remove só os registos do dispositivo, para dispositivos que já foram apagados ou destruídos. Não apagar nem remover deixa o Intune inalterado.

| 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                                                      | 1     |
| Não apagar nem remover o dispositivo do Intune                                      | 0     |

#### aadAction

Eliminar remove os objetos de dispositivo do Entra ID, Desativar mantém-nos mas bloqueia os inícios de sessão a partir dos dispositivos, e Manter deixa o Entra ID inalterado.

| 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 para compatibilidade. A escolha em "Ação do Intune" decide se os dispositivos são apagados.

| 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 para compatibilidade. A escolha em "Ação do Intune" decide se os registos do Intune são eliminados.

| 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 os dispositivos da base de dados do Autopilot permite que saiam do tenant e sejam registados noutro local. Mantê-los permite uma implementação posterior neste tenant.

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

**Opções do portal**

| Opção do portal                    | Valor      |
| ---------------------------------- | ---------- |
| Remover o dispositivo do Autopilot | verdadeiro |
| Manter dispositivo                 | falso      |

#### removeAADDevice

Interruptor legado mantido para compatibilidade. A escolha em "Objeto Entra ID" decide se os objetos Entra ID são eliminados.

| 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 para compatibilidade. A escolha em "Objeto Entra ID" decide se os objetos Entra ID são desativados.

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

#### excludeFromDefender

Etiqueta os dispositivos em Microsoft Defender for Endpoint com a etiqueta de exclusão para que as regras que usam a etiqueta os possam excluir da remediação automatizada. Ignorar deixa o Defender inalterado.

| 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      |
| ------------------------------------------------------------------------ | ---------- |
| Etiquetar dispositivos como excluídos em Microsoft Defender for Endpoint | verdadeiro |
| Ignorar operações do Defender                                            | falso      |

#### defenderExclusionTag

Nome da etiqueta escrito nos dispositivos em Microsoft Defender for Endpoint, para استفاده 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/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.
