Configurare e gestire Antivirus Microsoft Defender con lo mpcmdrun.exe da riga di comandoConfigure and manage Microsoft Defender Antivirus with the mpcmdrun.exe command-line tool

Si applica a:Applies to:

È possibile eseguire varie funzioni in Antivirus Microsoft Defender utilizzando lo strumento da riga di comando dedicato mpcmdrun.exe.You can perform various functions in Microsoft Defender Antivirus using the dedicated command-line tool mpcmdrun.exe. Questa utilità è utile quando si desidera automatizzare Antivirus Microsoft Defender attività.This utility is useful when you want to automate Microsoft Defender Antivirus tasks. È possibile trovare l'utilità in %ProgramFiles%\Windows Defender\MpCmdRun.exe .You can find the utility in %ProgramFiles%\Windows Defender\MpCmdRun.exe. Eseguirlo da un prompt dei comandi.Run it from a command prompt.

Suggerimento

Potrebbe essere necessario aprire una versione a livello di amministratore del prompt dei comandi.You might need to open an administrator-level version of the command prompt. Quando si cerca prompt dei comandi nel menu Start, scegliere Esegui come amministratore.When you search for Command Prompt on the Start menu, choose Run as administrator. Se si esegue una versione aggiornata di Microsoft Defender Platform, eseguire MpCmdRun dal percorso seguente: C:\ProgramData\Microsoft\Windows Defender\Platform\<antimalware platform version> .If you're running an updated Microsoft Defender Platform version, run MpCmdRun from the following location: C:\ProgramData\Microsoft\Windows Defender\Platform\<antimalware platform version>. Per ulteriori informazioni sulla piattaforma antimalware, vedere Antivirus Microsoft Defender aggiornamenti e baseline.For more information about the antimalware platform, see Microsoft Defender Antivirus updates and baselines.

L'utilità MpCmdRun utilizza la sintassi seguente:The MpCmdRun utility uses the following syntax:

MpCmdRun.exe [command] [-options]

Di seguito viene riportato un esempio:Here's an example:

MpCmdRun.exe -Scan -ScanType 2

In questo esempio, l'utilità MpCmdRun avvia un'analisi antivirus completa nel dispositivo.In our example, the MpCmdRun utility starts a full antivirus scan on the device.

ComandiCommands

ComandoCommand DescrizioneDescription
-? oppure -h-? or -h Visualizza tutte le opzioni disponibili per lo strumento MpCmdRunDisplays all available options for the MpCmdRun tool
-Scan [-ScanType [<value>]] [-File <path> [-DisableRemediation] [-BootSectorScan] [-CpuThrottling]] [-Timeout <days>] [-Cancel] Esegue la ricerca di software dannoso.Scans for malicious software. I valori per ScanType sono:Values for ScanType are:

0 Impostazione predefinita, in base alla configurazione0 Default, according to your configuration

1 Analisi rapida1 Quick scan

2 Analisi completa2 Full scan

3 Analisi personalizzata di file e directory.3 File and directory custom scan.

CpuThrottling viene eseguito in base alle configurazioni dei criteriCpuThrottling runs according to policy configurations

-Trace [-Grouping #] [-Level #] Avvia l'analisi diagnosticaStarts diagnostic tracing
-GetFiles [-SupportLogLocation <path>] Raccoglie informazioni di supporto.Collects support information. Vedere 'Raccolta di dati di diagnostica'See 'collecting diagnostic data'
-GetFilesDiagTrack Uguale a -GetFiles , ma viene restituito nella cartella Temporanea DiagTrackSame as -GetFiles, but outputs to temporary DiagTrack folder
-RemoveDefinitions [-All] Ripristina l'intelligence per la sicurezza installata su una copia di backup precedente o sul set predefinito originaleRestores the installed Security intelligence to a previous backup copy or to the original default set
-RemoveDefinitions [-DynamicSignatures] Rimuove solo l'intelligence per la sicurezza scaricata dinamicamenteRemoves only the dynamically downloaded Security intelligence
-RemoveDefinitions [-Engine] Ripristina il motore installato precedenteRestores the previous installed engine
-SignatureUpdate [-UNC \| -MMPC] Controlla la disponibilità di nuovi aggiornamenti di Security intelligenceChecks for new Security intelligence updates
-Restore [-ListAll \| [[-Name <name>] [-All] \| [-FilePath <filePath>]] [-Path <path>]] Ripristina o elenca gli elementi in quarantenaRestores or lists quarantined item(s)
-AddDynamicSignature [-Path] Carica l'intelligence dinamica per la sicurezzaLoads dynamic Security intelligence
-ListAllDynamicSignatures Elenca l'intelligence dinamica per la sicurezza caricataLists the loaded dynamic Security intelligence
-RemoveDynamicSignature [-SignatureSetID] Rimuove l'intelligence per la sicurezza dinamicaRemoves dynamic Security intelligence
-CheckExclusion -path <path> Controlla se un percorso è esclusoChecks whether a path is excluded
-ValidateMapsConnection Verifica che la rete sia in grado di comunicare con il Antivirus Microsoft Defender cloud.Verifies that your network can communicate with the Microsoft Defender Antivirus cloud service. Questo comando funziona solo su Windows 10 versione 1703 o successiva.This command will only work on Windows 10, version 1703 or higher.

Errori comuni nell'esecuzione di comandi tramite mpcmdrun.exeCommon errors in running commands via mpcmdrun.exe

Nella tabella seguente sono elencati gli errori comuni che possono verificarsi durante l'utilizzo dello strumento MpCmdRun.The following table lists common errors that can occur while using the MpCmdRun tool.

Messaggio di erroreError message Motivo possibilePossible reason
ValidateMapsConnection non riuscito (800106BA) o 0x800106BAValidateMapsConnection failed (800106BA) or 0x800106BA Il Antivirus Microsoft Defender è disabilitato.The Microsoft Defender Antivirus service is disabled. Abilitare il servizio e riprovare.Enable the service and try again. Se serve aiuto per ri-abilitare Antivirus Microsoft Defender, vedi Reinstallare/abilitareAntivirus Microsoft Defender sugli endpoint.If you need help re-enabling Microsoft Defender Antivirus, see Reinstall/enable Microsoft Defender Antivirus on your endpoints.

SUGGERIMENTO: in Windows 10 1909 o versioni precedenti e Windows Server 2019 o versioni precedenti, il servizio era precedentemente denominato Windows Defender Antivirus.TIP: In Windows 10 1909 or older, and Windows Server 2019 or older, the service was formerly called Windows Defender Antivirus.

0x800706670x80070667 Il comando viene eseguito da un computer Windows 10 versione 1607 o precedente o da Windows Server 2016 -ValidateMapsConnection o meno recente.You're running the -ValidateMapsConnection command from a computer that is Windows 10 version 1607 or older, or Windows Server 2016 or older. Eseguire il comando da un computer Windows 10 versione 1703 o successiva o Windows Server 2019 o versione successiva.Run the command from a machine that is Windows 10 version 1703 or newer, or Windows Server 2019 or newer.
MpCmdRun non viene riconosciuto come comando interno o esterno, programma operabile o file batch.MpCmdRun is not recognized as an internal or external command, operable program, or batch file. Lo strumento deve essere eseguito da uno o (dove potrebbe essere diverso dal momento che gli aggiornamenti della piattaforma %ProgramFiles%\Windows Defender C:\ProgramData\Microsoft\Windows Defender\Platform\4.18.2012.4-0 sono 2012.4-0 mensili ad eccezione di marzo)The tool must be run from either %ProgramFiles%\Windows Defender or C:\ProgramData\Microsoft\Windows Defender\Platform\4.18.2012.4-0 (where 2012.4-0 might differ since platform updates are monthly except for March)
ValidateMapsConnection non è riuscito a stabilire una connessione a MAPS (hr=80070005 httpcode=450)ValidateMapsConnection failed to establish a connection to MAPS (hr=80070005 httpcode=450) Il comando è stato tentato utilizzando privilegi insufficienti.The command was attempted using insufficient privileges. Utilizzare il prompt dei comandi (cmd.exe) come amministratore.Use the command prompt (cmd.exe) as an administrator.
ValidateMapsConnection non è riuscito a stabilire una connessione a MAPS (hr=80070006 httpcode=451)ValidateMapsConnection failed to establish a connection to MAPS (hr=80070006 httpcode=451) Il firewall blocca la connessione o esegue l'ispezione SSL.The firewall is blocking the connection or conducting SSL inspection.
ValidateMapsConnection non è riuscito a stabilire una connessione a MAPS (hr=80004005 httpcode=450)ValidateMapsConnection failed to establish a connection to MAPS (hr=80004005 httpcode=450) Possibili problemi correlati alla rete, come i problemi di risoluzione dei nomiPossible network-related issues, like name resolution problems
ValidateMapsConnection non è riuscito a stabilire una connessione a MAPS (hr=0x80508015ValidateMapsConnection failed to establish a connection to MAPS (hr=0x80508015 Il firewall blocca la connessione o esegue l'ispezione SSL.The firewall is blocking the connection or conducting SSL inspection.
ValidateMapsConnection non è riuscito a stabilire una connessione a MAPS (hr=800722F0DValidateMapsConnection failed to establish a connection to MAPS (hr=800722F0D Il firewall blocca la connessione o esegue l'ispezione SSL.The firewall is blocking the connection or conducting SSL inspection.
ValidateMapsConnection non è riuscito a stabilire una connessione a MAPS (hr=80072EE7 httpcode=451)ValidateMapsConnection failed to establish a connection to MAPS (hr=80072EE7 httpcode=451) Il firewall blocca la connessione o esegue l'ispezione SSL.The firewall is blocking the connection or conducting SSL inspection.

Vedere ancheSee also