Menghubungkan perangkat Windows ke Microsoft Defender untuk Titik Akhir dengan skrip lokal

Anda dapat menggunakan skrip lokal untuk mengonboarding hingga 10 perangkat klien Windows atau Windows Server yang didukung ke Microsoft Defender untuk Titik Akhir. Metode ini berguna untuk mengevaluasi layanan sebelum Anda memilih metode penerapan untuk lingkungan yang lebih besar. Sebelum memulai, tinjau prasyarat, lalu unduh dan jalankan skrip, konfigurasikan koleksi sampel, verifikasi onboarding, atau perangkat offboarding.

Important

Gunakan skrip lokal di 10 perangkat atau kurang. Untuk penerapan produksi, pilih metode yang dapat diskalakan seperti Group Policy, Microsoft Configuration Manager, Microsoft Intune, atau alat penerapan Defender. Untuk membandingkan metode yang tersedia, lihat Mengidentifikasi arsitektur dan metode penyebaran Defender for Endpoint dan opsi penyebaran lain untuk perangkat klien Windows.

Note

Alat penyebaran Defender dapat digunakan untuk menyebarkan keamanan titik akhir Defender pada perangkat Windows dan Linux. Alat ini merupakan aplikasi ringan dengan pembaruan otomatis yang menyederhanakan proses penerapan. Untuk informasi selengkapnya, lihat Menyebarkan keamanan titik akhir Microsoft Defender ke perangkat Windows menggunakan alat penyebaran Defender dan Menyebarkan keamanan titik akhir Microsoft Defender ke perangkat Linux menggunakan alat penyebaran Defender (pratinjau).

Prasyarat

Tambahkan perangkat dengan skrip lokal

Unduh paket onboarding dari portal Microsoft Defender, lalu jalankan skrip yang disertakan di setiap perangkat.

  1. Pada halaman Onboarding di portal Microsoft Defender di https://security.microsoft.com/securitysettings/endpoints/onboarding, konfigurasikan paket:

    1. Langkah 1: Pilih sistem operasi untuk memulai deployment: Pilih grup versi sistem operasi untuk perangkat. Jangan pilih Windows, yang memulai alur kerja alat penyebaran Defender yang terpisah.
    2. Jika tipe konektivitas tersedia, pilih metode konektivitas untuk lingkungan Anda:
    3. Untuk metode Deployment, pilih Local script (untuk hingga 10 perangkat).
    4. Pilih Unduh paket onboarding untuk mengunduh GatewayWindowsDefenderATPOnboardingPackage.zip.
  2. Ekstrak isi .zip file di perangkat ke lokasi yang mudah ditemukan, seperti Desktop. Paket tersebut berisi WindowsDefenderATPLocalOnboardingScript.cmd.

  3. Buka Command Prompt dengan hak administrator.

  4. Pergi ke folder yang berisi WindowsDefenderATPLocalOnboardingScript.cmd. Sebagai contoh, perintah berikut akan masuk ke folder Desktop:

    if exist "%OneDrive%\Desktop" (cd /d "%OneDrive%\Desktop") else if exist "%USERPROFILE%\Desktop" cd /d "%USERPROFILE%\Desktop"
    
  5. Jalankan skrip onboarding:

    WindowsDefenderATPLocalOnboardingScript.cmd
    
  6. Saat skrip ditampilkan , tekan tombol apa pun untuk melanjutkan..., tekan tombol apa pun untuk menyelesaikan.

Mengonfigurasi pengaturan pengumpulan sampel

Defender for Endpoint dapat mengumpulkan file dari perangkat yang dionboarding ketika analis meminta file untuk analisis mendalam. Nilai AllowSampleCollection registry mengontrol apakah perangkat dapat merespons permintaan berikut:

  • 0 ():00000000 Jangan izinkan berbagi sampel dari perangkat.
  • 1 ():00000001 Izinkan berbagi semua jenis file dari perangkat. Pengaturan ini adalah default jika nilai registry tidak ada.

Untuk mengonfigurasi pengaturan secara manual, salin teks berikut ke Notepad, atur nilainya AllowSampleCollection , simpan file dengan .reg ekstensi, dan jalankan file tersebut di perangkat:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows Advanced Threat Protection]
"AllowSampleCollection"=dword:00000000

Verifikasi penyiapan perangkat

Setelah skrip dijalankan, pastikan perangkat melapor ke Defender untuk Endpoint:

  1. Pada halaman inventaris perangkat di portal Microsoft Defender di https://security.microsoft.com/machines?category=all-devices, cari perangkatnya.

  2. Buka halaman perangkat, dan pastikan perangkat sudah onboarding dan kondisi kesehatan sensornya aktif.

Perangkat biasanya muncul di inventaris dalam beberapa menit. Konektivitas jaringan dan status perangkat dapat menunda pelaporan.

Untuk menghasilkan peringatan uji dan mengonfirmasi pelaporan menyeluruh, lihat Jalankan uji deteksi pada perangkat yang baru ditambahkan. Jika perangkat tidak muncul atau tidak melapor seperti yang diharapkan, lihat Memecahkan masalah proses onboarding Microsoft Defender untuk Titik Akhir.

Hapus perangkat menggunakan skrip lokal

Paket offboarding akan kedaluwarsa tujuh hari setelah Anda mengunduhnya. Defender for Endpoint menolak paket yang kedaluwarsa, dan tanggal kedaluwarsa muncul di nama file paket.

Important

Jangan jalankan skrip onboarding dan offboarding di perangkat yang sama secara bersamaan. Selesaikan onboarding atau offboarding sebelum menjalankan skrip lain.

Untuk menghapus perangkat dari pengelolaan menggunakan skrip lokal, unduh dan jalankan paket penghapusan:

  1. Pada halaman Offboarding di portal Microsoft Defender di https://security.microsoft.com/securitysettings/endpoints/offboarding, konfigurasikan paket:

    1. Pilih grup versi sistem operasi untuk perangkat. Jangan pilih Windows, yang memulai alur kerja alat penyebaran Defender yang terpisah.
    2. Untuk metode Deployment, pilih Local script (untuk hingga 10 perangkat).
    3. Pilih Unduh paket, lalu pilih Unduh di dialog konfirmasi.
  2. Ekstrak WindowsDefenderATPOffboardingPackage_valid_until_YYYY-MM-DD.zip di perangkat ke lokasi yang mudah ditemukan, seperti Desktop. Paket tersebut berisi WindowsDefenderATPOffboardingScript_valid_until_YYYY-MM-DD.cmd.

  3. Buka Command Prompt dengan hak administrator.

  4. Buka folder yang berisi skrip offboarding. Sebagai contoh, perintah berikut akan masuk ke folder Desktop:

    if exist "%OneDrive%\Desktop" (cd /d "%OneDrive%\Desktop") else if exist "%USERPROFILE%\Desktop" cd /d "%USERPROFILE%\Desktop"
    
  5. Jalankan skrip offboarding:

    WindowsDefenderATPOffboardingScript_valid_until_YYYY-MM-DD.cmd
    

Important

Offboarding menghentikan perangkat agar tidak lagi mengirim data deteksi, kerentanan, dan keamanan yang baru ke Defender for Endpoint. Data historis tetap berada di portal Defender sampai masa retensi yang dikonfigurasi berakhir. Profil perangkat, tanpa data, tetap berada dalam inventaris perangkat hingga 180 hari. Untuk informasi lebih lanjut, lihat Perangkat eksternal.