> 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 Tira este dispositivo Windows de serviço. Você escolhe se o dispositivo é apagado ou apenas eliminado do Intune, e se ele sai da base de dados Autopilot. O seu objeto Entra ID pode ser eliminado, desativado ou mantido. Opcionalmente, o dispositivo é marcado em Microsoft Defender for Endpoint para que as regras que usam a etiqueta possam excluí-lo da remediação automatizada. Uma limpeza remove todos os dados do utilizador e de registo do dispositivo e não pode ser desfeita. ### Etiqueta de exclusão do Microsoft Defender for Endpoint Microsoft Defender for Endpoint tem uma nativa **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 de dispositivo personalizada (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 **Etiquetas** o filtro, infelizmente, lista apenas etiquetas que foram criadas através do portal. Uma etiqueta definida apenas via API é associada ao dispositivo e visível na página do dispositivo, mas não o faz **não** aparece por si só no filtro Etiquetas. 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 tem de ser etiquetado manualmente uma vez através do portal (selecione um dispositivo > **Gerir etiquetas** > "Criar nova etiqueta", usando exatamente o mesmo valor de etiqueta). Após esta etapa única, a etiqueta torna-se uma etiqueta conhecida e filtrável, e este runbook pode aplicá-la a dispositivos em grande escala. > **Nota:** 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 do Defender ou uma regra de automatização estiver explicitamente configurado para corresponder a este valor de etiqueta. Essas regras correspondem diretamente ao valor da etiqueta, independentemente do **Etiquetas** filtro, pelo que a etapa manual única 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 obter 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 da aplicação * **Tipo**: Microsoft Graph * DeviceManagementManagedDevices.PrivilegedOperations.All * *Aciona a ação de limpeza do Intune quando a opção de limpeza é selecionada* * DeviceManagementManagedDevices.ReadWrite.All * *Localiza o dispositivo do Intune por azureADDeviceId e elimina-o quando removeIntuneDevice está definido* * DeviceManagementServiceConfig.ReadWrite.All * *Localiza e elimina a identidade do Autopilot quando removeAutopilotDevice está definido* * Device.Read.All * *Resolve o dispositivo Entra e lê os seus 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 Cloud * *Necessário para desativar e eliminar o objeto de dispositivo do Entra ID através de /devices/{id}* ### Parâmetros #### ID do dispositivo ID do dispositivo Entra ID do dispositivo no qual o runbook atua. Definido pelo portal a partir do dispositivo selecionado. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | verdadeiro | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### intuneAction A limpeza completa apaga todos os dados do utilizador e de registo no dispositivo. Eliminar do Intune remove apenas o registo do dispositivo, para dispositivos que já foram limpos ou destruídos. Não limpar nem remover deixa o Intune inalterado. | Propriedade | Valor | | -------------------------- | -------------- | | Obrigatório | falso | | Valor predefinido | 2 | | Tipo | Int32 | | Nome de exibição do 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á tiver sido apagado ou destruído) | 1 | | Não apagar nem remover o dispositivo do Intune | 0 | #### aadAction Eliminar remove o objeto do dispositivo do Entra ID, Desativar mantém-no, mas bloqueia inícios de sessão a partir do dispositivo, e Manter deixa o Entra ID inalterado. | Propriedade | Valor | | -------------------------- | ------------------ | | Obrigatório | falso | | Valor predefinido | 2 | | Tipo | Int32 | | Nome de exibição do portal | Objeto do 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 no Entra ID | 0 | #### wipeDevice Interruptor legado mantido por compatibilidade. A opção em "ação do Intune" decide se o dispositivo é limpo. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Verdadeiro | | Tipo | Booleano | | Oculto no portal | sim (predefinido através 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 é eliminado. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### removeAutopilotDevice Remover o dispositivo da base de dados Autopilot permite-lhe sair do tenant e ser registado noutro local. Mantê-lo permite uma reimplementação posterior neste tenant. | Propriedade | Valor | | -------------------------- | -------------------------------------------------- | | Obrigatório | falso | | Valor predefinido | Verdadeiro | | Tipo | Booleano | | Nome de exibição do portal | Eliminar o dispositivo da base de dados 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 Entra ID" decide se o objeto Entra ID é eliminado. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Verdadeiro | | Tipo | Booleano | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### disableAADDevice Interruptor legado mantido por compatibilidade. A opção em "objeto Entra ID" decide se o objeto Entra ID é desativado. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### excludeFromDefender Marca o dispositivo em Microsoft Defender for Endpoint com a etiqueta de exclusão para que as regras que usam a etiqueta possam excluí-lo da remediação automatizada. Ignorar deixa o Defender inalterado. | Propriedade | Valor | | -------------------------- | -------------------------------------------------------- | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Nome de exibição do portal | Marcar 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 etiqueta escrito no dispositivo no Defender for Endpoint, para uso nas suas regras de exclusão. | Propriedade | Valor | | -------------------------- | -------------------------------- | | Obrigatório | falso | | Valor predefinido | ExcludeFromRemediation | | Tipo | Cadeia de caracteres | | Nome de exibição do portal | Etiqueta de exclusão do Defender | [Voltar à visão geral da referência do Runbook](/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=&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.