Felsök systemtillägg för Microsoft Defender för Endpoint på macOS

Gäller för: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2

Microsoft Defender för Endpoint använder endpoint-säkerhet och nätverkssystemtillägg för att skydda macOS-enheter. Om macOS inte godkänner eller startar en tillägg kan realtidsskydd, nätverkshändelseinspektion eller relaterade funktioner vara otillgängliga.

Använd symtomen och kommandona i denna artikel för att identifiera problem med extension och profil. Använd sedan den distributionsspecifika vägledningen för att korrigera konfigurationen.

Identifiera symtom på systemförlängning

Microsoft Defender-skölden i macOS-menyfältet kan visa ett x-märke när Defender for Endpoint kräver uppmärksamhet.

Välj skölden för att öppna Defender-menyn. Alternativet Åtgärd behövs anger att Defender kräver konfiguration eller godkännande av användaren.

Välj åtgärd som behövs för att öppna sidan för virus- och hotskydd . Sidan kan visa att Microsoft Defender behöver uppmärksamhet och en Fix-knapp.

Kör följande kommando i Terminal för att granska det övergripande hälsotillståndet för Defender:

mdatp health

När tillägg eller behörigheter inte är redo kan utdata rapportera ett ohälsosamt tillstånd, otillgängligt skydd eller saknad Full Disk Access:

healthy                            : false
health_issues                    : ["no active event provider", "network event provider not running", "full disk access has not been granted"]
...
real_time_protection_enabled    : true
real_time_protection_available: false
...
full_disk_access_enabled        : false

Följande skärmdump visar ett ohälsosamt resultat med otillgängliga skyddssubsystem och Full Disk Access avstängt:

För beskrivningar av hälsofälten, se Felsök agentens hälsoproblem med Defender for Endpoint på macOS.

Diagnostisera systemutvidgningarna

På stödda macOS-versioner måste en mobil enhetshantering (MDM)-profil eller en lokal administratör godkänna systemtillägg innan de kan köras. Defender for Endpoint använder Microsoft Team ID UBF8T346G9 och följande systemtillägg:

Slutpunktssäkerhetstillägg: com.microsoft.wdav.epsext.
Nätverksförlängning: com.microsoft.wdav.netext.

Använd följande kommandon för att avgöra om tilläggen är installerade, godkända och körs:

Lista de registrerade systemtilläggen:
```
systemextensionsctl list
```
Delstaten [activated waiting for user] anger att macOS installerade tilläggen men väntar på lokalt godkännande. Ett fungerande aktivt tillägg rapporterar [activated enabled].

Gå igenom hälsoinformationen för Defender-specifika systemförlängningar:

mdatp health --details system_extensions

När tilläggen är installerade men inte godkända eller klara, kan utgången likna följande exempel:

network_extension_enabled                 : false
network_extension_installed                 : true
endpoint_security_extension_ready           : false
endpoint_security_extension_installed        : true

Följande skärmdump visar båda tilläggen installerade, men nätverkstillägget är inte aktiverat och ändpunktssäkerhetstillägget är inte klart:

Tilläggets hälsoresultat identifierar inte alla nödvändiga macOS-behörigheter. Till exempel kan mdatp health separat rapportera att Full Disk Access inte har beviljats. Granska systemtillägg och macOS-behörigheter som krävs för dina aktiverade Defender- och Microsoft Purview-funktioner.

Lös utvidgnings- och behörighetsproblem

Använd proceduren för din distributionsmetod för att godkänna tilläggen och ge de nödvändiga behörigheterna:

Microsoft Intune: Godkänn Defender för Endpoint-systemtillägg i Intune. Nya policyer måste använda inställningskatalogen eftersom den äldre mallen för macOS-tillägg är föråldrad. För allmän vägledning i inställningskatalogen, se Använd Intune inställningskatalog för att konfigurera inställningar. För hela distributionssekvensen, se Godkänn systemtillägg.
Jamf Pro: Konfigurera Defender för endpoint-systemtillägg med Jamf Pro.
En annan MDM-lösning: Distribuera Defender for Endpoint med en annan MDM-lösning.
Manuell distribution: Godkänn systemtillägg och behörigheter manuellt.

För hanterade distributioner, distribuera systemkonfigurationsprofiler före Defender-applikationspaketet. Denna sekvens gör att macOS kan godkänna tillägg och behörigheter utan att behöva använda användarens promptar.

Kontrollera leverans av profil

Innan du felsöker individuella profiler, granska de delade förkunskaperna för Defender for Endpoint på macOS.

Kontrollera leveransen av MDM-profilen

Använd din MDM-lösning för att bekräfta att de nödvändiga enhetsnivåprofilerna är tilldelade och framgångsrikt levererade till den berörda Mac-enheten. På enheten, öppna Systeminställningar, välj Allmänt och välj sedan Správa zariadení för att granska installerade profiler.

Om du använder Jamf Pro utlöser sudo jamf policy tillämpliga policyer. För information om Jamfs policyutlösare och genomförande, se Policy Management.

Obs!

Använd igenkännbara namn för Defender-konfigurationsprofiler så att du kan identifiera deras syfte och distributionsring. Använd till exempel FullDiskAccess (piloting) - macOS - Default - MDE.

Verifiera de nödvändiga profilerna

Ladda ner aktuella profiler som Microsoft underhåller istället för att manuellt återskapa nyttolaster. Denna metod förhindrar skrivfel i paketidentifierare, Team-ID:n, kodkrav och nyttolastvärden.

För profillistan och syftet med varje nyttolast, se Review maintained Defender profiles.

I Terminal, använd följande syntax för att ladda ner en profil till den aktuella katalogen:

curl -O https://URL

Ladda till exempel ner profilen för systemtillägg som underhålls:

curl -O https://raw.githubusercontent.com/microsoft/mdatp-xplat/master/macos/mobileconfig/profiles/sysext.mobileconfig

Granska underhållna Defender-profiler

Defender for Endpoint macOS-profilarkivet innehåller dessa relevanta profiler:

Systemförlängningsgodkännande: sysext.mobileconfig godkänner com.microsoft.wdav.epsext och com.microsoft.wdav.netext för Team ID UBF8T346G9.
Nätverksfilter: netfilter.mobileconfig konfigurerar nätverkstillägget som Microsoft Defender Content Filter.
Full diskåtkomst: fulldisk.mobileconfig ger tillgång till de nödvändiga Defender-komponenterna.
Bakgrundstjänster: background_services.mobileconfig tillåter Defender-tjänster att köras i bakgrunden.
Notiseringar: notif.mobileconfig konfigurerar Defender- och Microsoft AutoUpdate-notiser.
Tillgänglighet: accessibility.mobileconfig ger åtkomst till Microsoft Purview dataförlustskyddsdaemonen när den funktionen används.

Använd inte närvaron av filer under /Library/Managed Preferences som enda test för dessa Apple-payloads. Verifiera profilleverans via MDM-lösningen, inspektera de installerade konfigurationsprofilerna och granska Defender-hälsoutdatan.

Analysera installerade profiler

Microsoft-skriptet analyze_profiles.py jämför installerade konfigurationspayloads med den underhållna Defender-profilmallen. Den rapporterar saknade, dubbla eller felmatchade nyttolaster och kontrollerar onboardingprofiler och Defender-preferensprofiler.

Gå igenom skriptet i Defender for Endpoint macOS MDM-verktygskatalog.
Välj Raw för att öppna https://raw.githubusercontent.com/microsoft/mdatp-xplat/master/macos/mdm/analyze_profiles.py.
Från katalogen där du vill spara analyze_profiles.py, ladda ner skriptet genom att köra följande kommando i Terminal:
```
curl -O https://raw.githubusercontent.com/microsoft/mdatp-xplat/master/macos/mdm/analyze_profiles.py
```

Kör skriptet med förhöjda behörigheter genom att använda en av följande metoder:

Kör det nedladdade skriptet:

cd ~/Downloads

sudo python3 analyze_profiles.py

Kör skriptet direkt från webben:

curl -sS https://raw.githubusercontent.com/microsoft/mdatp-xplat/master/macos/mdm/analyze_profiles.py | sudo python3 -

Gå igenom varje rapporterat problem i samband med din utplacering. Skriptet kan rapportera avsiktliga profilval som inte kräver ändringar.

Skicka feedback

För att skicka produktfeedback från Defender-appen, öppna Hjälp och välj sedan Skicka feedback.

På Microsoft Defender-portalen på https://security.microsoft.com, välj Ge feedback.

Feedback

Var den här sidan till hjälp?

Uppdaterades senast 2026-09-19