Configurer et gérer Microsoft Defender Antivirus avec l’outil en ligne de commande mpcmdrun.exe

S’applique à :

Plateformes

  • Windows

Vous pouvez effectuer différentes fonctions dans Microsoft Defender Antivirus à l’aide de l’outil en ligne de commande dédié mpcmdrun.exe. Cet utilitaire est utile lorsque vous souhaitez automatiser Microsoft Defender tâches antivirus. Vous trouverez l’utilitaire dans %ProgramFiles%\Windows Defender\MpCmdRun.exe. Exécutez-la à partir d’une invite de commandes.

Conseil

Vous devrez peut-être ouvrir une version de niveau administrateur de l’invite de commandes. Lorsque vous recherchez Invite de commandes dans le menu Démarrer, choisissez Exécuter en tant qu’administrateur. Si vous exécutez une version mise à jour Microsoft Defender plateforme anti-programme malveillant, exécutez MpCmdRun à partir de l’emplacement suivant : C:\ProgramData\Microsoft\Windows Defender\Platform\<antimalware platform version>. Pour plus d’informations sur la plateforme anti-programme malveillant, consultez Microsoft Defender mises à jour antivirus et bases de référence.

L’utilitaire MpCmdRun utilise la syntaxe suivante :

MpCmdRun.exe [command] [-options]

Voici un exemple :

MpCmdRun.exe -Scan -ScanType 2

Dans notre exemple, l’utilitaire MpCmdRun démarre une analyse antivirus complète sur l’appareil.

Commandes

Command Description
-?Ou-h Affiche toutes les options disponibles pour l’outil MpCmdRun
-Scan [-ScanType [<value>]] [-File <path> [-DisableRemediation] [-BootSectorScan] [-CpuThrottling]] [-Timeout <days>] [-Cancel] Recherche les logiciels malveillants. Les valeurs de ScanType sont les suivantes :

0 Valeur par défaut, selon votre configuration

1 Analyse rapide

2 Analyse complète

3 Analyse personnalisée des fichiers et des répertoires.

CpuThrottling s’exécute en fonction des configurations de stratégie

-Trace [-Grouping #] [-Level #] Démarre le suivi des diagnostics
-GetFiles [-SupportLogLocation <path>] Collecte des informations de support. Consultez « collecte de données de diagnostic »
-GetFilesDiagTrack Identique à -GetFiles, mais génère des sorties vers le dossier DiagTrack temporaire
-RemoveDefinitions [-All] Restaure l’intelligence de sécurité installée à une copie de sauvegarde précédente ou à l’ensemble par défaut d’origine
-RemoveDefinitions [-DynamicSignatures] Supprime uniquement le renseignement de sécurité téléchargé dynamiquement
-RemoveDefinitions [-Engine] Restaure le moteur installé précédent
-SignatureUpdate [-UNC \|-MMPC] Vérifie les nouvelles mises à jour security intelligence
-Restore [-ListAll \|[[-Name <name>] [-All] \|[-FilePath <filePath>]] [-Path <path>]] Restaure ou répertorie les éléments mis en quarantaine
-AddDynamicSignature [-Path] Charge l’intelligence de sécurité dynamique
-ListAllDynamicSignatures Répertorie les informations de sécurité dynamiques chargées
-RemoveDynamicSignature [-SignatureSetID] Supprime l’intelligence de sécurité dynamique
-CheckExclusion -path <path> Vérifie si un chemin d’accès est exclu
-ValidateMapsConnection Vérifie que votre réseau peut communiquer avec le service cloud Microsoft Defender Antivirus. Cette commande fonctionne uniquement sur Windows 10 version 1703 ou ultérieure.

Erreurs courantes lors de l’exécution de commandes via mpcmdrun.exe

Le tableau suivant répertorie les erreurs courantes qui peuvent se produire lors de l’utilisation de l’outil MpCmdRun.

Message d’erreur Raison possible
ValidateMapsConnection a échoué (800106BA) ou 0x800106BA Le service antivirus Microsoft Defender est désactivé. Activez le service et réessayez. Si vous avez besoin d’aide pour réactiver Microsoft Defender Antivirus, consultez Réinstaller/activer Microsoft Defender Antivirus sur vos points de terminaison.

CONSEIL : Dans Windows 10 version 1909 ou antérieure, et Dans Windows Server 2019 ou une version antérieure, le service s’appelait auparavant antivirus Windows Defender.

0x80070667 Vous exécutez la -ValidateMapsConnection commande à partir d’un ordinateur Windows 10 version 1607 ou antérieure, ou Windows Server 2016 ou une version antérieure. Exécutez la commande à partir d’un ordinateur Windows 10 version 1703 ou ultérieure, ou Windows Server 2019 ou version ultérieure.
MpCmdRun n’est pas reconnu comme une commande interne ou externe, un programme opérable ou un fichier de commandes. L’outil doit être exécuté à partir de %ProgramFiles%\Windows Defender ou C:\ProgramData\Microsoft\Windows Defender\Platform\4.18.2012.4-0 (où 2012.4-0 peut différer, car les mises à jour de plateforme sont mensuelles, à l’exception de mars)
ValidateMapsConnection n’a pas pu établir une connexion à MAPS (hr=80070005 httpcode=450) La commande a été tentée à l’aide de privilèges insuffisants. Utilisez l’invite de commandes (cmd.exe) en tant qu’administrateur.
ValidateMapsConnection n’a pas pu établir une connexion à MAPS (hr=80070006 httpcode=451) Le pare-feu bloque la connexion ou effectue une inspection SSL.
ValidateMapsConnection n’a pas pu établir une connexion à MAPS (hr=80004005 httpcode=450) Problèmes liés au réseau, tels que les problèmes de résolution de noms
ValidateMapsConnection n’a pas pu établir une connexion à MAPS (hr=0x80508015 Le pare-feu bloque la connexion ou effectue une inspection SSL.
ValidateMapsConnection n’a pas pu établir une connexion à MAPS (hr=800722F0D Le pare-feu bloque la connexion ou effectue une inspection SSL.
ValidateMapsConnection n’a pas pu établir une connexion à MAPS (hr=80072EE7 httpcode=451) Le pare-feu bloque la connexion ou effectue une inspection SSL.

Voir aussi