Embarquez les appareils Windows sur Microsoft Defender for Endpoint avec un script local

  • S’applique à: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2

Vous pouvez utiliser un script local pour embarquer jusqu’à 10 clients Windows ou appareils Windows Server supportés vers Microsoft Defender for Endpoint. Cette méthode est utile pour évaluer le service avant de sélectionner une méthode de déploiement pour un environnement plus vaste. Avant de commencer, relisez les prérequis, puis téléchargez et exécutez le script, configurez la collecte d’échantillons, vérifiez l’embarquement ou les appareils externes.

Importante

Utilisez le script local sur 10 appareils ou moins. Pour un déploiement en production, sélectionnez une méthode évolutive telle que Group Policy, Microsoft Configuration Manager, Microsoft Intune ou l’outil de déploiement Defender. Pour comparer les méthodes disponibles, voir Identifier Defender pour l’architecture et les méthodes de déploiement Endpoint ainsi que d’autres options de déploiement pour les appareils clients Windows.

Remarque

L’outil de déploiement Defender peut être utilisé pour déployer la sécurité des points de terminaison Defender sur les appareils Windows et Linux. L’outil est une application légère et auto-mise à jour qui simplifie le processus de déploiement. Pour plus d’informations, consultez Déployer Microsoft Defender sécurité des points de terminaison sur des appareils Windows à l’aide de l’outil de déploiement Defender et Déployer Microsoft Defender sécurité des points de terminaison sur des appareils Linux à l’aide de l’outil de déploiement Defender (préversion).

Prerequisites

Appareils embarqués avec script local

Téléchargez le package d’intégration depuis le portail Microsoft Defender, puis exécutez le script inclus sur chaque appareil.

  1. Sur la page d’intégration du portail Microsoft Defender à https://security.microsoft.com/securitysettings/endpoints/onboarding, configurez le package :

    1. Étape 1 : Sélectionnez un système d’exploitation pour commencer le déploiement : Sélectionnez le groupe de versions du système d’exploitation pour l’appareil. Ne sélectionnez pas Windows, ce qui lance le flux de déploiement séparé de l'outil Defender.
    2. Si le type de connectivité est disponible, sélectionnez la méthode de connectivité adaptée à votre environnement :
    3. Pour la méthode de déploiement, sélectionnez Script local (pour jusqu’à 10 périphériques).
    4. Sélectionnez Télécharger le forfait d’intégration pour télécharger GatewayWindowsDefenderATPOnboardingPackage.zip.

  2. Extraire le contenu du .zip fichier sur l’appareil vers un endroit facile à trouver, comme le bureau. Le paquet contient WindowsDefenderATPLocalOnboardingScript.cmd.

  3. Ouvrez l’invite de commandes en tant qu’administrateur.

  4. Allez dans le dossier qui contient WindowsDefenderATPLocalOnboardingScript.cmd. Par exemple, la commande suivante va dans le dossier Bureau :

    if exist "%OneDrive%\Desktop" (cd /d "%OneDrive%\Desktop") else if exist "%USERPROFILE%\Desktop" cd /d "%USERPROFILE%\Desktop"

  5. Exécutez le script d’intégration :

    WindowsDefenderATPLocalOnboardingScript.cmd

  6. Quand le script s’affiche, appuyez sur n’importe quelle touche, pour continuer..., appuyez sur n’importe quelle touche pour terminer.

Configurer des exemples de paramètres de regroupement

Defender for Endpoint peut collecter des fichiers depuis un appareil embarqué lorsqu’un analyste demande un fichier pour une analyse approfondie. La AllowSampleCollection valeur du registre contrôle si l’appareil peut répondre à ces requêtes :

  • 0 (00000000) : N’autorisez pas le partage d’échantillons depuis l’appareil.
  • 1 (00000001) : Autoriser le partage de tous les types de fichiers depuis l’appareil. Ce paramètre est par défaut si la valeur du registre n’existe pas.

Pour configurer manuellement le paramètre, copiez le texte suivant dans Notepad, définissez la AllowSampleCollection valeur, enregistrez le fichier avec une .reg extension, puis exécutez le fichier sur l’appareil :

Windows Registry Editor Version 5.00

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

Vérifier la mise en service de l’appareil

Après l’exécution du script, vérifiez que l’appareil rapporte à Defender pour Endpoint :

  1. Sur la page d’inventaire des appareils dans le portail Microsoft Defender, https://security.microsoft.com/machines?category=all-devicescherchez l’appareil.

  2. Ouvrez la page de l’appareil et vérifiez que l’appareil est embarqué et que l’état de santé du capteur est actif.

L’appareil apparaît généralement dans l’inventaire en quelques minutes. La connectivité réseau et l’état des appareils peuvent retarder le signalement.

Pour générer une alerte de test et confirmer un rapport de bout en bout, voir Exécuter un test de détection sur un appareil nouvellement embarqué. Si l’appareil n’apparaît pas ou ne signale pas l’état attendu, consultez Résoudre les problèmes d’intégration de Microsoft Defender pour Endpoint.

Retirer des appareils à l'aide d'un script local

Le forfait d’offboarding expire sept jours après le téléchargement. Defender for Endpoint rejette les colis expirés, et la date d’expiration apparaît dans le nom du fichier du paquet.

Importante

Ne lancez pas les scripts d’intégration et de déconnexion sur le même appareil en même temps. Terminez l’intégration ou le délogement avant de lancer l’autre script.

Pour démonter un appareil en utilisant un script local, téléchargez et exécutez le forfait d’offboarding :

  1. Sur la page Offboarding du portail Microsoft Defender à https://security.microsoft.com/securitysettings/endpoints/offboarding, configurez le package :

    1. Sélectionnez le groupe de versions du système d’exploitation pour l’appareil. Ne sélectionnez pas Windows, ce qui lance le flux de déploiement séparé de l'outil Defender.
    2. Pour la méthode de déploiement, sélectionnez Script local (pour jusqu’à 10 périphériques).
    3. Sélectionnez Télécharger forfait, puis Télécharger dans la boîte de dialogue de confirmation.

  2. Extraire WindowsDefenderATPOffboardingPackage_valid_until_YYYY-MM-DD.zip sur l’appareil vers un endroit facile à trouver, comme le bureau. Le paquet contient WindowsDefenderATPOffboardingScript_valid_until_YYYY-MM-DD.cmd.

  3. Ouvrez l’invite de commandes en tant qu’administrateur.

  4. Accédez au dossier qui contient le script de désinstallation. Par exemple, la commande suivante va dans le dossier Bureau :

    if exist "%OneDrive%\Desktop" (cd /d "%OneDrive%\Desktop") else if exist "%USERPROFILE%\Desktop" cd /d "%USERPROFILE%\Desktop"

  5. Exécutez le script de déconnexion :

    WindowsDefenderATPOffboardingScript_valid_until_YYYY-MM-DD.cmd

Importante

Le débranchement empêche l’appareil d’envoyer de nouvelles données de détection, de vulnérabilité et de sécurité à Defender for Endpoint. Les données historiques restent dans le portail Defender jusqu’à l’expiration de la période de rétention configurée. Le profil de l’appareil, sans données, reste dans l’inventaire des appareils jusqu’à 180 jours. Pour plus d’informations, voir Dispositifs hors-bord.

Contenu connexe

  • Dernière mise à jour :