> 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 Retira 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 serão apagados ou apenas removidos do Intune, e se o respetivo registo do Autopilot será removido. Os respetivos objetos do Entra ID podem ser eliminados, desativados ou mantidos. Opcionalmente, os dispositivos são marcados em Microsoft Defender for Endpoint para que regras que usam a etiqueta possam excluí-los 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 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 *Exclua dispositivos de Microsoft Defender for Endpoint* está ativado. Cada dispositivo na lista é procurado pelo respetivo 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** do portal lista apenas etiquetas que foram criadas através do portal. Uma etiqueta definida exclusivamente através da API é associada ao dispositivo e visível na página do dispositivo, mas não **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. Os dispositivos fornecidos por número de série que não são encontrados no Intune não têm ID de dispositivo do 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 obter detalhes. ### Localização Organização → Dispositivos → Dispositivos fora de fase **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 da aplicação * **Tipo**: Microsoft Graph * DeviceManagementManagedDevices.PrivilegedOperations.All * *Aciona a limpeza do dispositivo através de managedDevices/{id}/wipe quando a ação de limpeza é selecionada* * DeviceManagementManagedDevices.ReadWrite.All * *Procura dispositivos do 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 do 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 Cloud * *Necessário para desativar e eliminar objetos de dispositivo do Entra através de /devices/{id}* ### Parâmetros #### DeviceListChoice Se a lista contém IDs de dispositivo do Entra ID ou números de série. | Propriedade | Valor | | -------------------------- | -------------- | | Obrigatório | verdadeiro | | Valor predefinido | 0 | | Tipo | Int32 | | Nome de exibição do 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 predefinido | | | Tipo | Cadeia de caracteres | | Nome de exibição do portal | Lista de dispositivos | #### intuneAction Apagar completamente elimina todos os dados do utilizador e de inscrição nos dispositivos. Eliminar apenas do Intune remove apenas os registos do dispositivo, para dispositivos que já estejam apagados ou destruídos. Não apagar nem remover mantém 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 | 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 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 Alternância legada mantida para compatibilidade. A opção em "Ação do Intune" decide se os dispositivos são apagados. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Verdadeiro | | Tipo | Booleano | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### removeIntuneDevice Alternância legada mantida para compatibilidade. A opção em "Ação do Intune" decide se os registos do Intune são eliminados. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Oculto no portal | sim (predefinido através 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 reimplantação posterior neste tenant. | Propriedade | Valor | | -------------------------- | --------------------------------------- | | Obrigatório | falso | | Valor predefinido | Verdadeiro | | Tipo | Booleano | | Nome de exibição do 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 Alternância legada mantida para compatibilidade. A opção em "Objeto do Entra ID" decide se os objetos do Entra ID são eliminados. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Verdadeiro | | Tipo | Booleano | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### disableAADDevice Alternância legada mantida para compatibilidade. A opção em "Objeto do Entra ID" decide se os objetos do Entra ID são desativados. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### excludeFromDefender Marca os dispositivos em Microsoft Defender for Endpoint com a etiqueta de exclusão para que regras que usam a etiqueta possam excluí-los 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 dispositivos como excluídos em Microsoft Defender for Endpoint | verdadeiro | | Ignorar operações do Defender | falso | #### defenderExclusionTag Nome da etiqueta escrita nos dispositivos em Microsoft 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/org/devices/outphase-devices.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.