Distribuera Windows-enheter genom att använda Microsoft Defender-verktyget

Microsoft Defender-distributionsverktyget är ett lättviktigt, självuppdaterande program som installerar förkunskaper och integrerar Windows-stödda enheter i Microsoft Defender för Endpoint. Kör verktyget interaktivt på enskilda enheter, eller automatisera det med kommandoradsparametrar, konfigurationsfiler, grupppolicy, Microsoft Configuration Manager eller något annat program för utrullning.

Använd distributionsverktyget som en separat onboardingmetod. Det integreras inte med onboarding via Microsoft Intune, Microsoft Defender för molnet eller andra distributionsmetoder. Innan du börjar, granska de stödda operativsystemen och förkunskapskraven.

Distributionsverktyget erbjuder dessa funktioner:

• Förkunskapshantering: Kontrollerar nödvändiga uppdateringar och löser problem som blockerar distribution.
• Loggning och återkoppling: Registrerar operationer i en lokal logg och visar felbeskrivningar i interaktivt läge.
• Installation och uppdateringar: Undviker att installera om befintliga komponenter och laddar ner nuvarande komponenter vid behov.
• Automation: Stöder kommandoradsparametrar och återanvändbara konfigurationsfiler för automatiserade distributioner.
• Staging: Laddar ner installationsfiler för målenheter som inte kan ladda ner filerna direkt.
• Serverpassivt läge: Konfigurerar Microsoft Defender Antivirus för att köras i passivt läge på Windows Server.
• Icke-persistent virtuell skrivbordsinfrastruktur (VDI): Hjälper enheter som återskapats med samma värdnamn att visas som en enhet i Defender-portalen.
• Paketskydd: Kräver en portalgenererad åtkomstnyckel för registrering och stöder paket med utgångsdatum från en dag upp till ett år. Använd den kortaste praktiska giltighetsperioden.
• Pakethantering: Listar distributionspaket i Microsoft Defender-portalen och låter dig filtrera dem efter egenskaper som status och utgångsdatum.
• Inbyggd hjälp: Visar tillgängliga kommandoradsalternativ när du kör DefenderDT.exe -?.

I interaktivt läge ber verktyget om åtkomstnyckeln från Defender-portalen, installerar nödvändiga uppdateringar och Defender-komponenter och kopplar enheten till Defender for Endpoint. Om installationen kräver omstart, logga in efter omstarten så att verktyget kan återupptas.

För avancerade och storskaliga distributioner, använd kommandoradsparametrar eller en konfigurationsfil.

Operativsystem som stöds

Distributionsverktyget för Defender stöder följande operativsystem:

• Windows 11
• Windows 10, version 1809 (november 2018) eller senare
• Windows 7 SP1
• Windows Server 2016 eller senare
• Windows Server 2012 R2
• Windows Server 2008 R2 SP1

Förhandskrav

Gå igenom de allmänna förutsättningarna och förutsättningarna för Windows 7 SP1 och Windows Server 2008 R2 SP1 innan du distribuerar verktyget.

Allmänna krav

• De flesta verksamheter kräver administrativa rättigheter.

• Tillåt åtkomst till definitionupdates.microsoft.com. Verktyget laddar ner uppdateringar och installationsfiler från denna domän. Eftersom filerna är värda på ett innehållsdistributionsnätverk är de tillhörande IP-adressintervallen inte statiska eller förutsägbara.

• Verktyget kontrollerar anslutningen till din organisation innan onboarding. Andra funktioner i Defender for Endpoint kräver också åtkomst till tjänste-URL:er såsom *.endpoint.security.microsoft.com. För fullständiga krav, se Konfigurera din nätverksmiljö för att säkerställa anslutning till Defender for Endpoint-tjänsten.

För smidig anslutning undantar du trafik till *.endpoint.security.microsoft.com från SSL/TLS-inspektion, HTTPS-interceptering och proxyering via man-in-the-middle (MITM). Om du aktiverar SSL-inspektion kan Defender för slutpunktssensorer misslyckas med att kommunicera med serverdelstjänster, vilket resulterar i registrerings- eller anslutningsfel.

Förutsättningar för Windows 7 SP1 och Windows Server 2008 R2 SP1

• Enheter måste köra en x64-version av Windows 7 SP1 eller Windows Server 2008 R2 SP1. Installera de senaste tillgängliga uppdateringarna för att minska installationstiden och risken för omstart.

• Installera SHA-2 kodsigneringsstöd. Distributionsverktyget kräver minst KB4474419.

  • Installera servicestack-uppdateringen (SSU) KB4490628. Windows Update erbjuder automatiskt den nödvändiga SSU:n.

  • Installera SHA-2-uppdateringen KB4474419, släppt den 10 september 2019. Windows Update erbjuder automatiskt den nödvändiga uppdateringen.

• På Windows Server 2008 R2 SP1, installera .NET Framework 3.5 eller senare.

Generera och ladda ned ett nytt registreringspaket

Generera ett onboardingpaket och en åtkomstnyckel i Microsoft Defender-portalen. Du behöver åtkomstnyckeln när du kör verktyget interaktivt eller med parametern -Key .

1. På introduktionssidan i Microsoft Defender-portalen på https://security.microsoft.com/securitysettings/endpoints/onboarding, konfigurera följande inställningar:

   • Steg 1: Välj ett operativsystem för att starta distributionen: Välj Windows.
   • Steg 2: Välj ett distributionsalternativ: Välj Onboard i Deploy genom att ladda ner och använda paket eller filer>Defender-distributionsverktyget.

   

2. I den utfällbara menyn Generera Defender-distributionsverktyget med en åtkomstnyckel som öppnas konfigurerar du paketet:

   • Namn: Ange ett unikt, beskrivande paketnamn.
   • Organisation: Verifiera den visade organisationen.
   • Utgång: Använd den kortaste praktiska giltighetsperioden för att minska risken för obehörig användning av paket:
     • Om 7 dagar (standard)
     • Om 30 dagar
     • Custom (upp till ett år)

   Välj Generera.

   

3. När paketet är klart, kopiera och lagra åtkomstnyckeln säkert.

   

4. Välj Ladda ner distributionsverktyget och spara den nedladdade körbara filen.

Distribuera Defender Endpoint Security på enheter

Kör Defender-distributionsverktyget interaktivt eller icke-interaktivt.

Interaktiv användning

Använd interaktivt läge för en enhet eller ett litet antal enheter. Dubbelklicka på den körbara filen för att använda standardinställningarna för introduktion, eller kör verktyget från kommandotolken för att ange alternativ.

För att starta en enhet med standardinställningarna:

1. Dubbelklicka på den körbara filen för att starta den.

2. I dialogen som bekräftar att onboarding startar, välj Fortsätt.

3. Ange nyckeln för Defender-distributionsverktyget som du kopierade från portalen och välj sedan Fortsätt.

   

4. Vänta tills installationen är klar och välj sedan OK. Om verktyget kräver omstart, logga in efter omstarten så att installationen kan återupptas.

Icke-interaktiv användning

Använd kommandoradsgränssnittet för att automatisera installation och onboarding eller för att köra andra operationer, såsom förkunskapskontroller.

För tillgängliga parametrar, se kommandoreferens för Defender deployment tool. För att se kommandoreferensen för din nedladdade verktygsversion, kör DefenderDT.exe -?.

Avancerade och storskaliga distributioner

Kör Defender-distributionsverktyget icke-interaktivt från Group Policy, Microsoft Configuration Manager eller något annat program för utrullning. Använd kommandoradsparametrar för att anpassa onboarding, staging, uppdateringar, omstarter, proxyer och andra operationer.

För återkommande distributioner, använd en konfigurationsfil istället för att upprepa kommandoradsparametrar. Kör verktyget med -MakeConfig för att generera DefenderDTconfig.txt. Redigera konfigurationen och ladda sedan in den med -Config:<path>. Om du inte anger en sökväg letar verktyget efter DefenderDTconfig.txt i den aktuella mappen. För ett exempel, se Använd en konfigurationsfil.

Kommandoreferens för Defender deployment tool

Följande tabell listar parametrarna som finns tillgängliga i Defender-distributionsverktyget version 1.0.0.6 (september 2026). Kör DefenderDT.exe -? för att verifiera parametrarna som finns tillgängliga i din nedladdade version.

Använd en upphöjd kommandoprompt (ett kommandopromptfönster du öppnade genom att välja Kör som administratör) för onboarding, avlastning, avinstallation, uppdatering och generering av konfigurationsfiler. , -Help-Precheck, och -Stage operationer kräver inga administrativa rättigheter. En konfigurationsfil kringgår också administratörskontrollen när den endast anger precheck eller staging.

Användningsexempel

Byt ut platshållarvägar, nycklar och proxyadresser i följande exempel mot värden för din miljö. Använd en upphöjd kommandoprompt förutom för precheck- och staging-exemplen.

• Kör standardintroduktionssekvensen utan att visa dialoger. Verktyget använder WindowsDefenderATP.onboarding från den aktuella mappen:

  DefenderDT.exe -Quiet
  

• Anslut med en åtkomstnyckel, konfigurera proxy, tillåt den omstart som krävs och förhindra att dialogrutor visas:

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

• Registrera med hjälp av en onboarding-fil på en nätverksplats utan att visa dialogrutor:

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

• Avboarda enheten genom att använda en lokal avslutningsfil utan att be om bekräftelse eller visa dialoger:

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

• Kontrollera förkunskaper, visa detaljerad utdata och förhindra dialoger:

  DefenderDT.exe -PreCheck -Verbose -Quiet
  

• Ladda ned installationsfiler för alla Windows-versioner som stöds till en absolut mellanlagringssökväg:

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

Använda en konfigurationsfil

Generera en konfigurationsfil när du vill återanvända samma parametrar i flera distributioner.

1. Generera DefenderDTconfig.txt i den aktuella mappen:

   DefenderDT.exe -MakeConfig
   

2. Öppna DefenderDTconfig.txt i en textredigerare och konfigurera parametrarna för din utplacering. Använd absoluta sökvägar för parametrar som tar emot en sökväg.

3. Kör verktyget med konfigurationsfilen. Följande exempel laddar filen från en nätverksplats:

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

   Om DefenderDTconfig.txt finns i den aktuella mappen, kör DefenderDT.exe -Config.

Distribuera genom att använda Group Policy

Använd en omedelbar schemalagd aktivitet i grupprincipen för att köra distribueringsverktyget som SYSTEM med förhöjda behörigheter. För de generiska stegen för att skapa, konfigurera, länka och testa den schemalagda uppgiften, se Omslutna enheter med hjälp av Grupppolicy.

Använd dessa Defender-implementeringsverktygsspecifika värden:

• Lagra DefenderDT.exe, .onboarding-filen och eventuella DefenderDTconfig.txt-filer på en delad skrivskyddad plats som målenheter kan komma åt.
• För Program/skript, ange hela Universal Naming Convention (UNC)-vägen till DefenderDT.exe. Använd filserverns fullt kvalificerade domännamn (FQDN).
• För Lägg till argument, ange de nödvändiga kommandoradsparametrarna. Till exempel, använd -File:\\server\share\WindowsDefenderATP.onboarding -Quiet när onboardingfilen inte finns i verktygets arbetskatalog.
• Kör uppgiften som NT AUTHORITY\SYSTEM, oavsett om en användare är inloggad eller inte, och välj Kör med högst behörighet.
• Testa Group Policy-objektet (GPO) med en begränsad enhetsgrupp innan bredare implementering.

För mer information om hanteringskonsolen, se Group Policy Management Console.

Avregistrera en enhet

För att ta bort en enhet, ladda ner offboarding-paketet från Defender-portalen, överför paketet till målenheten och kör distributionsverktyget med paketet.

Steg 1: Ladda ned offboarding-paketet

1. På sidan Offboarding i Microsoft Defender-portalen på https://security.microsoft.com/securitysettings/endpoints/offboarding, välj Windows under Välj operativsystem.

2. Under Defender deployment tool, välj Download package för att ladda ner .zip filen som innehåller offboarding-skriptet.

   

Steg 2: Kör offboardingkommandot

Utför dessa steg på den enhet som du vill ta bort från hantering:

1. Kopiera .zip filen till målenheten och extrahera filen .offboarding .

2. Kör distributionsverktyget i en upphöjd kommandoprompt med den absoluta vägen till den extraherade .offboarding filen. Till exempel:

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

3. Skriv in Y i bekräftelsedialogen för att fortsätta.

4. Vänta tills åtgärden har slutförts. Efter en lyckad avboardning visar verktyget följande meddelande:

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

Överväganden och begränsningar

Gå igenom de allmänna begränsningarna och begränsningarna för Windows 7 SP1 och Windows Server 2008 R2 SP1.

Allmänna överväganden och begränsningar

• Om den interaktiva sekvensen kräver omstart, logga in igen efter omstarten så att verktyget kan återupptas. Annars har enheten inte onboardats fullt ut.

• På Windows Server 2016 och senare kan steget Aktivering av funktionen 'Windows-Defender' misslyckas om Microsoft Defender Antivirus-funktionen avinstalleras eller tas bort. Användargränssnittet och den lokala loggen visar exitkoden 710 och EnableFeatureFailed. Loggen kan också innehålla felet 14081 och 0x3701 The referenced assembly could not be found. Öppna ett supportärende för Windows Server om du stöter på detta problem.

Kända problem och begränsningar för Windows 7 SP1 och Windows Server 2008 R2 SP1

• Du kan få aviseringar om msmplics.dll, sense1ds.dll, MpCmdRun.exe, MsSense.exe och mpsvc.dll som lästs in av antingen mpcommu.dll eller mpclient.dll. Aviseringarna bör försvinna med tiden.

• På Windows 7 SP1 och Windows Server 2008 R2 SP1 med Desktop Experience Pack installerat kan Action Center visa att Windows inte hittade antivirusprogram på denna dator. Notisen indikerar inte ett problem med distributionen.

• Använd förhandsversionen av klientanalysverktyget för att samla in loggar och felsöka anslutningen på Windows 7 SP1 och Windows Server 2008 R2 SP1. Analysatorn kräver PowerShell 5.1 eller senare.

• Microsoft Defender Antivirus tillhandahåller inget lokalt användargränssnitt på dessa operativsystem. För att hantera Microsoft Defender Antivirus-inställningar lokalt, installera PowerShell 5.1 eller senare.

• Konfiguration av grupppolicy kräver en central lagring med aktuella mallar för gruppolicyn på en domänkontrollant. För att använda Redigeraren för lokal grupprincip uppdaterar du WindowsDefender.admx och WindowsDefender.adml manuellt med de aktuella Windows 11-mallarna.

• Slutpunktssäkerhetslösningen Defender installeras på C:\Program Files\Microsoft Defender för Endpoint.

• Distributionsverktygets -Passive parameter gäller för Windows Server. Det stöds inte för Windows 7 SP1.

Felsökning

Gå igenom loggen över Defender-utrullningsverktyget för problem under installation och onboarding. Loggen finns på:

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

Verktyget registrerar också händelser i dessa Windows-händelseloggar:

• Onboarding: Windows-loggar > Program > Källa: WDATPOnboarding
• Avregistrering: Windows-loggar > Program > Källa: WDATPOffboarding

För att verifiera att installationen lyckades, gör dessa kontroller:

1. Kontrollera att tjänsterna körs med följande kommandon:

   Sc.exe query sense
   
   Sc.exe query windefend
   

   Du bör se följande utdata:

   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. För Defender Antivirus-loggar, inställningar och annan diagnostisk information, se Samla Microsoft Defender Antivirus-diagnostikdata.

3. Använd klientanalysverktyget för att samla loggar och felsöka anslutningen på Windows.

Avslutningskoder

För storskaliga distributioner via en mjukvarudistributionslösning, övervaka följande exitkoder:

Relaterat innehåll

• Distribuera Defender Endpoint Security-lösningen för Windows 7 SP1- och Windows Server 2008 R2 SP1-enheter
• Begränsa svarsåtgärder på värdefulla tillgångar