Sumber daya untuk Microsoft Defender untuk Titik Akhir di macOS

Berlaku untuk: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2

Gunakan mdatp alat baris perintah untuk mengonfigurasi Microsoft Defender untuk Titik Akhir, menjalankan pemindaian, mengelola ancaman yang terdeteksi, dan memeriksa kesehatan produk pada perangkat macOS. Anda juga dapat mengumpulkan informasi diagnostik, mengaktifkan pelengkapan otomatis perintah, mengelola file yang dikarantina, dan mencopot pemasangan Defender for Endpoint.

Untuk persyaratan produk dan metode penerapan, lihat Prasyarat untuk Microsoft Defender untuk Titik Akhir di macOS dan Microsoft Defender untuk Titik Akhir di macOS.

Mengumpulkan informasi diagnostik

Jika Anda dapat mereproduksi suatu masalah, tingkatkan level logging, jalankan sistem selama beberapa saat, lalu kembalikan level logging ke defaultnya.

Atur tingkat pencatatan ke debug:

mdatp log level set --level debug

Log level configured successfully

Reproduksi masalah tersebut.
Buat arsip .zip yang berisi log diagnostik Defender for Endpoint. Perintah menampilkan jalur arsip setelah berhasil:

Tip

Secara default, log diagnostik disimpan ke /Library/Application Support/Microsoft/Defender/wdavdiag/. Untuk menggunakan direktori lain, tambahkan --path [directory] ke perintah dan ganti [directory] dengan tujuan.
```
sudo mdatp diagnostic create
```
```
Diagnostic file created: "/Library/Application Support/Microsoft/Defender/wdavdiag/932e68a8-8f2e-4ad0-a7f2-65eb97c0de01.zip"
```

Kembalikan tingkat logging ke nilai default, info:

mdatp log level set --level info

Log level configured successfully

Tinjau log instalasi

Jika instalasi gagal, pemasang mungkin hanya melaporkan kegagalan umum. Informasi rinci tersedia di ./Library/Logs/Microsoft/mdatp/install.log Sertakan file ini saat Anda membuka kasus dukungan Microsoft.

Untuk panduan pemecahan masalah lebih lanjut, lihat Memecahkan masalah instalasi Microsoft Defender untuk Titik Akhir di macOS.

Mengonfigurasi dari baris perintah

Atur format keluaran

Alat baris perintah mendukung output tabel dan JSON. Gunakan salah satu opsi global berikut dengan sebuah perintah:

--output json
--output table

Perintah yang didukung

Tabel berikut mencantumkan perintah untuk skenario umum. Untuk melihat daftar lengkap perintah yang didukung oleh versi produk yang Anda terpasang, jalankan mdatp help di Terminal.

Group	Skenario	Command
Configuration	Aktifkan atau nonaktifkan mode pasif	`mdatp config passive-mode --value [enabled/disabled]`
Configuration	Aktifkan atau nonaktifkan perlindungan waktu nyata	`mdatp config real-time-protection --value [enabled/disabled]`
Configuration	Aktifkan atau nonaktifkan pemantauan perilaku	`mdatp config behavior-monitoring --value [enabled/disabled]`
Configuration	Aktifkan atau nonaktifkan perlindungan cloud	`mdatp config cloud --value [enabled/disabled]`
Configuration	Aktifkan atau nonaktifkan diagnostik cloud	`mdatp config cloud-diagnostic --value [enabled/disabled]`
Configuration	Aktifkan atau nonaktifkan pengiriman sampel otomatis	`mdatp config cloud-automatic-sample-submission --value [enabled/disabled]`
Configuration	Blokir, audit, atau matikan perlindungan aplikasi yang berpotensi tidak diinginkan	`mdatp threat policy set --type potentially_unwanted_application --action [block\\|audit\\|off]`
Configuration	Tambahkan atau hapus pengecualian antivirus untuk sebuah proses	`mdatp exclusion process [add\\|remove] --path [path-to-process]` `mdatp exclusion process [add\\|remove] --name [process-name]`
Configuration	Tambahkan atau hapus pengecualian antivirus untuk sebuah file	`mdatp exclusion file [add/remove] --path [path-to-file]`
Configuration	Tambahkan atau hapus pengecualian antivirus untuk direktori	`mdatp exclusion folder [add/remove] --path [path-to-directory]`
Configuration	Tambahkan atau hapus pengecualian antivirus untuk ekstensi file	`mdatp exclusion extension [add/remove] --name [extension]`
Configuration	Mencantumkan semua pengecualian antivirus	`mdatp exclusion list`
Configuration	Mengonfigurasi tingkat paralelisme untuk pemindaian sesuai permintaan	`mdatp config maximum-on-demand-scan-threads --value [numerical-value-between-1-and-64]`
Configuration	Aktifkan atau nonaktifkan pemindaian setelah pembaruan intelijen keamanan	`mdatp config scan-after-definition-update --value [enabled/disabled]`
Configuration	Aktifkan atau nonaktifkan pemindaian arsip untuk pemindaian sesuai permintaan	`mdatp config scan-archives --value [enabled/disabled]`
Configuration	Aktifkan atau nonaktifkan komputasi hash file	`mdatp config enable-file-hash-computation --value [enabled/disabled]`
Perlindungan	Memindai jalur	`mdatp scan custom --path [path] [--ignore-exclusions]`
Perlindungan	Menjalankan pemindaian cepat	`mdatp scan quick`
Perlindungan	Menjalankan pemindaian penuh	`mdatp scan full`
Perlindungan	Membatalkan pemindaian sesuai permintaan yang sedang berlangsung	`mdatp scan cancel`
Perlindungan	Meminta pembaruan inteligensi keamanan	`mdatp definitions update`
Configuration	Menambahkan nama ancaman ke daftar yang diizinkan	`mdatp threat allowed add --name [threat-name]`
Configuration	Menghapus nama ancaman dari daftar yang diizinkan	`mdatp threat allowed remove --name [threat-name]`
Configuration	Mencantumkan semua nama ancaman yang diizinkan	`mdatp threat allowed list`
Riwayat perlindungan	Mencetak riwayat perlindungan penuh	`mdatp threat list`
Riwayat perlindungan	Dapatkan detail ancaman	`mdatp threat get --id [threat-id]`
Manajemen karantina	Mencantumkan semua file yang dikarantina	`mdatp threat quarantine list`
Manajemen karantina	Menghapus semua file dari karantina	`mdatp threat quarantine remove-all`
Manajemen karantina	Menambahkan file yang terdeteksi sebagai ancaman ke karantina	`mdatp threat quarantine add --id [threat-id]`
Manajemen karantina	Menghapus file yang terdeteksi sebagai ancaman dari karantina	`mdatp threat quarantine remove --id [threat-id]`
Manajemen karantina	Pulihkan file dari karantina. Tersedia di Defender untuk versi Endpoint sebelum `101.23092.0012`.	`mdatp threat quarantine restore --id [threat-id] --path [destination-folder]`
Manajemen karantina	Pulihkan file dari karantina menggunakan ID ancaman. Tersedia di Defender for Endpoint versi `101.23092.0012` atau yang lebih baru.	`mdatp threat quarantine restore threat-id --id [threat-id] --destination-path [destination-folder]`
Manajemen karantina	Pulihkan file dari karantina menggunakan jalur aslinya. Tersedia di Defender for Endpoint versi `101.23092.0012` atau yang lebih baru.	`mdatp threat quarantine restore threat-path --path [threat-original-path] --destination-path [destination-folder]`
Konfigurasi perlindungan jaringan	Konfigurasikan tingkat penegakan perlindungan jaringan	`mdatp config network-protection enforcement-level --value [block\\|audit\\|disabled]`
Manajemen perlindungan jaringan	Verifikasi bahwa perlindungan jaringan telah berhasil dimulai	`mdatp health --field network_protection_status`
Manajemen Kontrol Perangkat	Lihat apakah Kontrol Perangkat diaktifkan dan tingkat penegakan defaultnya	`mdatp device-control policy preferences list`
Manajemen Kontrol Perangkat	Lihat aturan Kontrol Perangkat yang aktif	`mdatp device-control policy rules list`
Manajemen Kontrol Perangkat	Lihat grup yang dirujuk oleh kebijakan Kontrol Perangkat	`mdatp device-control policy groups list`
Configuration	Aktifkan atau nonaktifkan pencegahan kehilangan data	`mdatp config data_loss_prevention --value [enabled/disabled]`
Diagnostics	Mengubah tingkat log	`mdatp log level set --level [error\\|warning\\|info\\|debug]`
Diagnostics	Hasilkan log diagnostik	`mdatp diagnostic create --path [directory]`
Health	Periksa kesehatan produk	`mdatp health`
Health	Periksa atribut produk tertentu, seperti `healthy`, `licensed`, atau `engine_version`	`mdatp health --field [attribute]`
EDR	Tetapkan tag perangkat. Hanya `GROUP` yang didukung.	`mdatp edr tag set --name GROUP --value [name]`
EDR	Hapus tag grup dari perangkat	`mdatp edr tag remove --tag-name [name]`
EDR	Tambahkan ID grup	`mdatp edr group-ids --group-id [group]`

Aktifkan pelengkapan otomatis baris perintah

Untuk mengaktifkan autocompletion di Bash, tambahkan skrip Defender for Endpoint completion ke profil Bash Anda, lalu restart sesi Terminal:

echo "source /Applications/Microsoft\ Defender.app/Contents/Resources/Tools/mdatp_completion.bash" >> ~/.bash_profile

Untuk mengaktifkan autocompletion dalam Z shell (zsh), ikuti langkah-langkah berikut:

Periksa apakah pelengkapan otomatis diaktifkan di perangkat Anda:
```
cat ~/.zshrc | grep autoload
```
Jika perintah tidak menghasilkan output apa pun, aktifkan autocompletion di profil zsh Anda:
```
echo "autoload -Uz compinit && compinit" >> ~/.zshrc
```

Buat direktori penyelesaian dan tautkan skrip penyelesaian Defender for Endpoint:

sudo mkdir -p /usr/local/share/zsh/site-functions

sudo ln -svf "/Applications/Microsoft Defender.app/Contents/Resources/Tools/mdatp_completion.zsh" /usr/local/share/zsh/site-functions/_mdatp

Kelola direktori karantina klien

Defender for Endpoint menyimpan file yang dikarantina di /Library/Application Support/Microsoft/Defender/quarantine/. Nama file menggunakan ID pelacakan ancaman. Untuk melihat ID pelacakan saat ini, jalankan mdatp threat list. Gunakan perintah mdatp threat quarantine untuk mengelola file karantina alih-alih memodifikasi file secara langsung.

Copot instalasi Defender untuk Endpoint

Sebelum Anda menghapus Defender for Endpoint, lepaskan perangkat tersebut dan hapus atau perbarui kebijakan yang mengelolanya. Untuk tag penghentian penggunaan perangkat opsional, persyaratan perlindungan terhadap perusakan, paket pelepasan, dan pembersihan kebijakan ekstensi sistem, lihat Melepas perangkat Mac.

Anda dapat menghapus aplikasi secara interaktif atau dari baris perintah. Jika Anda mengelola perangkat dengan Jamf Pro, sebarkan profil offboarding sebelum menghapus aplikasi. Penghapusan terpusat saat ini tidak tersedia di Microsoft Intune.

Copot instalasi secara interaktif

Di Finder, buka Aplikasi, klik Control-klik Microsoft Defender, lalu pilih Pindah ke Sampah.

Copot pemasangan dari baris perintah

Jalankan sudo '/Library/Application Support/Microsoft/Defender/uninstall/uninstall' di Terminal.

Hapus pendaftaran dari Jamf Pro sebelum menghapus instalan

Jamf Pro adalah produk pihak ketiga terpisah yang bukan bagian dari Defender for Endpoint dan tidak termasuk dalam langganan Defender for Endpoint. Untuk menggunakan Jamf Pro, organisasi Anda memerlukan langganan Jamf Pro terpisah. Untuk informasi produk dan langganan, lihat Jamf Pro. Jika organisasi Anda tidak menggunakan Jamf Pro, gunakan metode konfigurasi lain dalam artikel ini, jika tersedia.

Untuk mengalihkan perangkat melalui Jamf Pro sebelum Anda menghapus aplikasi, ikuti petunjuk Jamf untuk mengunggah profil konfigurasi. Unggah profil offboarding Defender for Endpoint tanpa memodifikasinya, dan atur Preference Domain ke com.microsoft.wdav.atp.offboarding.

Note

Jika Anda mengalami kesulitan menghapus Defender for Endpoint dan laporan berisi item untuk Microsoft Defender Endpoint Security Extension, ikuti langkah-langkah berikut:

Instal ulang aplikasi Microsoft Defender.
Seret Microsoft Defender.app ke Tong Sampah.

Jalankan perintah berikut di Terminal:

sudo '/Library/Application Support/Microsoft/Defender/uninstall/install_helper' execute --path '/Library/Application Support/Microsoft/Defender/uninstall/uninstall' --args --post-uninstall-hook

Mulai ulang perangkat.

Menggunakan portal Pertahanan Microsoft

Gunakan portal Microsoft Defender untuk meninjau deteksi dan mengambil tindakan respons pada perangkat. Untuk informasi selengkapnya, lihat sumber daya berikut ini:

Saran dan Komentar

Apakah halaman ini membantu?

Terakhir diperbarui pada 2026-09-19