Implemente dispositivos Windows utilizando a ferramenta de implementação Microsoft Defender

A ferramenta de implementação do Microsoft Defender é uma aplicação leve e autoatualizável que instala pré-requisitos e integra dispositivos Windows suportados no Microsoft Defender para Endpoint. Execute a ferramenta de forma interativa em dispositivos individuais, ou automatize-a com parâmetros de linha de comandos, ficheiros de configuração, Group Policy, Microsoft Configuration Manager ou outro sistema de implementação de software.

Use a ferramenta de implementação como um método de integração separado. Não se integra com o processo de integração através do Microsoft Intune, do Microsoft Defender para a Cloud ou de outros métodos de implementação. Antes de começar, reveja os sistemas operativos suportados e os pré-requisitos.

A ferramenta de implementação oferece as seguintes funcionalidades:

• Tratamento pré-requisito: Verifica as atualizações necessárias e resolve problemas que bloqueiam a implementação.
• Registo e feedback: Regista as operações num registo local e apresenta descrições de erro em modo interativo.
• Instalação e atualizações: Evita reinstalar componentes existentes e descarrega os componentes atuais quando necessário.
• Automação: Suporta parâmetros de linha de comandos e ficheiros de configuração reutilizáveis para implementações automatizadas.
• Staging: Descarrega ficheiros de instalação para dispositivos alvo que não conseguem descarregar os ficheiros diretamente.
• Modo passivo do servidor: Configura o Microsoft Defender Antivirus para correr em modo passivo no Windows Server.
• Infraestrutura de ambiente de trabalho virtual não persistente (VDI): Ajuda dispositivos recriados com o mesmo nome de host a aparecerem como um único dispositivo no portal Defender.
• Proteções do pacote: Requer uma chave de acesso gerada pelo portal para a configuração inicial e suporta datas de expiração do pacote entre um dia e um ano. Use o período de validade prático mais curto.
• Gestão de pacotes: Lista os pacotes de implementação no portal Microsoft Defender e permite-lhe filtrá-los por propriedades como estado e data de expiração.
• Ajuda incorporada: Mostra as opções disponíveis na linha de comandos quando executa DefenderDT.exe -?.

No modo interativo, a ferramenta solicita a chave de acesso do portal Defender, instala as atualizações necessárias e os componentes do Defender, e liga o dispositivo ao Defender for Endpoint. Se a instalação exigir um reinício, inicia sessão após o reinício para que a ferramenta possa retomar.

Para implementações avançadas e em grande escala, utilize parâmetros de linha de comandos ou um ficheiro de configuração.

Sistemas operativos suportados

A ferramenta de implementação do Defender suporta os seguintes sistemas operativos:

• Windows 11
• Windows 10, versão 1809 (novembro de 2018) ou posterior
• Windows 7 SP1
• Windows Server 2016 ou versões posteriores
• Windows Server 2012 R2
• Windows Server 2008 R2 SP1

Pré-requisitos

Revise os pré-requisitos gerais e os requisitos para Windows 7 SP1 e Windows Server 2008 R2 SP1 antes de implementar a ferramenta.

Pré-requisitos gerais

• A maioria das operações requer privilégios administrativos.

• Permitir o acesso a definitionupdates.microsoft.com. A ferramenta descarrega atualizações e ficheiros de instalação deste domínio. Como os ficheiros estão alojados numa rede de distribuição de conteúdos, os intervalos de endereços IP associados não são estáticos nem previsíveis.

• A ferramenta verifica a conectividade com a sua organização antes da integração. Outras funcionalidades do Defender for Endpoint também exigem acesso a URLs de serviço como *.endpoint.security.microsoft.com. Para os requisitos completos, consulte Configurar o seu ambiente de rede para garantir conectividade com o serviço Defender for Endpoint.

Para uma conectividade sem problemas, exclua o tráfego para *.endpoint.security.microsoft.com da inspeção SSL/TLS, da interceção de HTTPS e do proxy de intermediário (MITM). Se ativar a inspeção SSL, os sensores do Defender for Endpoint podem falhar em comunicar com os serviços de backend, resultando em falhas de integração ou de conectividade.

Pré-requisitos para Windows 7 SP1 e Windows Server 2008 R2 SP1

• Os dispositivos devem executar uma versão x64 do Windows 7 SP1 ou Windows Server 2008 R2 SP1. Instale as atualizações mais recentes disponíveis para reduzir o tempo de instalação e a probabilidade de reiniciar.

• Instale suporte para assinatura de código SHA-2. A ferramenta de implementação exige pelo menos KB4474419.

  • Instala a atualização da pilha de manutenção (SSU) KB4490628. O Windows Update oferece automaticamente o SSU necessário.

  • Instale a atualização SHA-2 KB4474419, lançada a 10 de setembro de 2019. O Windows Update oferece automaticamente a atualização necessária.

• No Windows Server 2008 R2 SP1, instale o .NET Framework 3.5 ou posterior.

Gerar e descarregar um novo pacote de onboarding

Gera um pacote de integração e uma chave de acesso no portal Microsoft Defender. Precisas da chave de acesso quando executas a ferramenta de forma interativa ou com o -Key parâmetro.

1. Na página de Integração do portal Microsoft Defender em https://security.microsoft.com/securitysettings/endpoints/onboarding, configure as seguintes definições:

   • Passo 1: Selecione um sistema operativo para iniciar a implementação: Selecione Windows.
   • Passo 2: Escolha uma opção de implementação: Selecione Onboard em Implementar transferindo e aplicando pacotes ou ficheiros>ferramenta de implementação do Defender.

   

2. No painel Gerar ferramenta de implementação do Defender com uma chave de acesso que é aberto, configure o pacote:

   • Nome: Insira um nome de embalagem único e descritivo.
   • Organização: Verifique a organização apresentada.
   • Validade: Utilize o período de validade mais curto possível para reduzir o risco de utilização não autorizada do pacote:
     • Em 7 dias (padrão)
     • Em 30 dias
     • Personalizado (até um ano)

   Selecione Gerar.

   

3. Quando o pacote estiver pronto, copie e armazene a chave de acesso de forma segura.

   

4. Selecione Download deployment tool e guarde o executável descarregado.

Implementar a segurança de pontos finais do Defender em dispositivos

Executa a ferramenta de implementação do Defender de forma interativa ou não.

Utilização interativa

Use o modo interativo para um dispositivo ou para um pequeno número de dispositivos. Faça duplo clique no executável para usar as predefinições da configuração inicial ou execute a ferramenta na Linha de Comandos para especificar as opções.

Para integrar um dispositivo com as definições padrão:

1. Faça duplo clique no executável para o iniciar.

2. No diálogo que confirma que a integração vai começar, selecione Continuar.

3. Introduza a chave da ferramenta de implementação do Defender que copiou do portal e, em seguida, selecione Continuar.

   

4. Espera que a instalação termine e depois seleciona OK. Se a ferramenta exigir um reinício, inicia sessão após o reinício para que a instalação possa recomeçar.

Utilização não interativa

Use a interface de linha de comandos para automatizar a instalação e integração ou para executar outras operações, como verificações prévias.

Para os parâmetros disponíveis, consulte a referência de comandos da ferramenta de implementação do Defender. Para visualizar a referência do comando da versão da sua ferramenta descarregada, execute DefenderDT.exe -?.

Implementações avançadas e em grande escala

Execute a ferramenta de implementação Defender de forma não interativa a partir do Group Policy, Microsoft Configuration Manager ou outro sistema de implementação de software. Utilize parâmetros da linha de comandos para personalizar a integração, a pré-produção, as atualizações, os reinícios, os servidores proxy e outras operações.

Para implementações recorrentes, use um ficheiro de configuração em vez de repetir parâmetros de linha de comandos. Execute a ferramenta com -MakeConfig para gerar DefenderDTconfig.txt. Edita a configuração e depois carrega-a com -Config:<path>. Se não especificares um caminho, a ferramenta procura por DefenderDTconfig.txt na pasta atual. Para um exemplo, veja Usar um ficheiro de configuração.

Referência de comando da ferramenta de implantação do Defender

A tabela seguinte lista os parâmetros disponíveis na ferramenta de implementação do Defender versão 1.0.0.6 (setembro de 2026). Execute DefenderDT.exe -? para verificar os parâmetros disponíveis na sua versão descarregada.

Utilize um Prompt de Comando com privilégios elevados (uma janela do Prompt de Comando que abriu ao selecionar Executar como administrador) para integração, remoção, desinstalação, atualização e geração de ficheiros de configuração. As operações -Help, -Precheck e -Stage não requerem privilégios administrativos. Um ficheiro de configuração também contorna a verificação do administrador quando especifica apenas precheck ou staging.

Exemplos de utilização

Substitua os caminhos provisórios, chaves e endereços proxy nos exemplos seguintes por valores para o seu ambiente. Utilize um Prompt de Comando com privilégios elevados, exceto nos exemplos de precheck e staging.

• Executa a sequência de integração padrão sem mostrar diálogos. A ferramenta utiliza WindowsDefenderATP.onboarding da pasta atual:

  DefenderDT.exe -Quiet
  

• Integrar usando uma chave de acesso, configurar um proxy, permitir um reinício obrigatório e evitar diálogos:

  DefenderDT.exe -Key:<access-key> -Proxy:https://proxy.contoso.com:8080 -AllowReboot -Quiet
  

• Integrar ao utilizar um ficheiro de integração numa localização de rede sem apresentar caixas de diálogo:

  DefenderDT.exe -File:\\server.contoso.com\share\WindowsDefenderATP.onboarding -Quiet
  

• Desassocie o dispositivo utilizando um ficheiro local de desassociação sem pedir confirmação nem apresentar caixas de diálogo:

  DefenderDT.exe -Offboard -File:C:\Packages\WindowsDefenderATP.offboarding -Yes -Quiet
  

• Verifique pré-requisitos, mostre resultados detalhados e evite diálogos:

  DefenderDT.exe -PreCheck -Verbose -Quiet
  

• Descarregue os ficheiros de instalação para todas as versões suportadas do Windows para um caminho absoluto de preparação:

  DefenderDT.exe -Stage:C:\DefenderDT\StagedFiles
  

Usar um ficheiro de configuração

Gera um ficheiro de configuração quando quiseres reutilizar os mesmos parâmetros em múltiplas implementações.

1. Gerar DefenderDTconfig.txt na pasta atual:

   DefenderDT.exe -MakeConfig
   

2. Abre DefenderDTconfig.txt num editor de texto e configura os parâmetros para a tua implementação. Utilize caminhos absolutos para parâmetros que aceitam um caminho.

3. Execute a ferramenta com o ficheiro de configuração. O exemplo seguinte carrega o ficheiro a partir de uma localização de rede:

   DefenderDT.exe -Config:\\server.contoso.com\share\DefenderDTconfig.txt
   

   Se DefenderDTconfig.txt estiver na pasta atual, execute DefenderDT.exe -Config.

Implementar utilizando a Estratégia de Grupo

Utilize uma tarefa agendada imediata de Política de Grupo para executar a ferramenta de implementação como SYSTEM com permissões elevadas. Para os passos genéricos de criar, configurar, ligar e testar a tarefa agendada, consulte Dispositivos a bordo usando a Estratégia de Grupo.

Utilize estes valores específicos da ferramenta de implementação do Defender:

• Armazene DefenderDT.exe, o .onboarding ficheiro e qualquer DefenderDTconfig.txt ficheiro num local partilhado, só de leitura, onde os dispositivos alvo possam aceder.
• Para Program/script, introduza o caminho completo da Convenção Universal de Nomes (UNC) para DefenderDT.exe. Use o nome de domínio totalmente qualificado (FQDN) do servidor de ficheiros.
• Para Adicionar argumentos, introduza os parâmetros de linha de comandos necessários. Por exemplo, use -File:\\server\share\WindowsDefenderATP.onboarding -Quiet quando o ficheiro de integração não está na pasta de trabalho da ferramenta.
• Execute a tarefa como NT AUTHORITY\SYSTEM, independentemente de o utilizador estar ou não iniciado sessão, e selecione Executar com os privilégios mais altos.
• Teste o objeto de Política de Grupo (GPO) com um grupo limitado de dispositivos antes de uma implementação mais ampla.

Para mais informações sobre a consola de gestão, consulte Consola de Gestão de Políticas de Grupo.

Desativar um dispositivo

Para desligar um dispositivo, descarregue o pacote de offboarding do portal Defender, transfera-o para o dispositivo alvo e execute a ferramenta de implementação com o pacote.

Passo 1: Descarregar o pacote de desativação

1. Na página de desativação no portal do Microsoft Defender em https://security.microsoft.com/securitysettings/endpoints/offboarding, selecione Windows em Selecionar sistema operativo.

2. Na ferramenta de implementação do Defender, selecione Transferir pacote para descarregar o ficheiro .zip que contém o script de desativação.

   

Passo 2: Executar o comando de remoção

Complete estes passos no dispositivo que pretende retirar:

1. Copie o .zip ficheiro para o dispositivo alvo e extraia o .offboarding ficheiro.

2. Execute a ferramenta de implementação numa Linha de Comandos com privilégios elevados com o caminho absoluto para o ficheiro .offboarding extraído. Por exemplo:

   DefenderDT.exe -Offboard -File:C:\Packages\WindowsDefenderATP.offboarding
   

3. Digite Y no diálogo de confirmação para prosseguir.

4. Aguarde a conclusão do processo. Após uma saída bem-sucedida, a ferramenta apresenta a seguinte mensagem:

   Microsoft Defender deployment tool completed, exit code: 0 [Success]
   

Considerações e limitações

Revise as limitações gerais e as limitações do Windows 7 SP1 e do Windows Server 2008 R2 SP1.

Considerações e limitações gerais

• Se a sequência interativa exigir um reinício, inicie sessão novamente após o reinício para que a ferramenta possa retomar. Caso contrário, o dispositivo não está totalmente integrado.

• No Windows Server 2016 e versões posteriores, a etapa de Ativar a Funcionalidade 'Windows-Defender' pode falhar se a funcionalidade Microsoft Defender Antivirus for desinstalada ou removida. A interface de utilizador e o registo local mostram o código 710 de saída e EnableFeatureFailed. O log também pode conter erro 14081 e 0x3701 The referenced assembly could not be found. Abra um pedido de suporte relativo ao Windows Server se encontrar este problema.

Problemas conhecidos e limitações do Windows 7 SP1 e Windows Server 2008 R2 SP1

• Pode receber alertas sobre msmplics.dll, sense1ds.dll, MpCmdRun.exe, MsSense.exe e mpsvc.dll carregados por mpcommu.dll ou mpclient.dll. Os alertas devem ser resolvidos com o tempo.

• No Windows 7 SP1 e no Windows Server 2008 R2 SP1 com o pacote Desktop Experience instalado, o Action Center pode mostrar que o Windows não encontrou antivírus neste computador. A notificação não indica um problema de implantação.

• Use a versão de pré-visualização da ferramenta de analisador de clientes para recolher registos e resolver problemas de conectividade no Windows 7 SP1 e no Windows Server 2008 R2 SP1. O analisador requer PowerShell 5.1 ou posterior.

• O Microsoft Defender Antivirus não fornece uma interface de utilizador local nestes sistemas operativos. Para gerir localmente as definições do Microsoft Defender Antivírus, instale o PowerShell 5.1 ou mais recente.

• A configuração da Estratégia de Grupo requer um Armazenamento Central com modelos atuais de Políticas de Grupo num controlador de domínio. Para utilizar o Editor de Políticas de Grupo Local, atualize manualmente WindowsDefender.admx e WindowsDefender.adml com os modelos mais recentes do Windows 11.

• A solução de segurança endpoint Defender instala-se em C:\Program Files\Microsoft Defender para Endpoint.

• O parâmetro da -Passive ferramenta de implementação aplica-se ao Windows Server. Não é suportado para Windows 7 SP1.

Resolução de Problemas

Consulte o registo da ferramenta de implementação do Defender para problemas durante a instalação e a integração. O registo encontra-se em:

C:\ProgramData\Microsoft\DefenderDeploymentTool\DefenderDeploymentTool-<COMPUTERNAME>.log

A ferramenta também regista eventos nestes registos de eventos do Windows:

• Integração: Registos do Windows > Aplicação > Origem: WDATPOnboarding
• Exclusão: Origem da Aplicação > de Registos > do Windows: WDATPOffboarding

Para verificar se a instalação foi bem-sucedida, complete estas verificações:

1. Verifique se os serviços estão em execução com os seguintes comandos:

   Sc.exe query sense
   
   Sc.exe query windefend
   

   Deverá ver o seguinte resultado:

   SERVICE_NAME: sense
           TYPE               : 10  WIN32_OWN_PROCESS
           STATE              : 4  RUNNING
                                   (STOPPABLE, NOT_PAUSABLE, ACCEPTS_PRESHUTDOWN)
           WIN32_EXIT_CODE    : 0  (0x0)
           SERVICE_EXIT_CODE  : 0  (0x0)
           CHECKPOINT         : 0x0
           WAIT_HINT          : 0x0
   
   SERVICE_NAME: windefend
           TYPE               : 10  WIN32_OWN_PROCESS
           STATE              : 4  RUNNING
                                   (STOPPABLE, NOT_PAUSABLE, ACCEPTS_SHUTDOWN)
           WIN32_EXIT_CODE    : 0  (0x0)
           SERVICE_EXIT_CODE  : 0  (0x0)
           CHECKPOINT         : 0x0
           WAIT_HINT          : 0x0
   

2. Para registos, definições e outras informações de diagnóstico do Defender Antivírus, consulte Recolher dados de diagnóstico do Microsoft Defender Antivírus.

3. Use a ferramenta de análise do cliente para recolher registos e resolver problemas de conectividade no Windows.

Códigos de saída

Para implementações em grande escala através de uma solução de distribuição de software, monitorize os seguintes códigos de saída:

Conteúdos relacionados

• Implementar a solução de segurança de ponto final do Defender para dispositivos Windows 7 SP1 e Windows Server 2008 R2 SP1
• Restringir ações de resposta em ativos de alto valor