Get-MpThreatDetection

Gets active and past malware threats that Windows Defender detected.

Syntax

Get-MpThreatDetection []
Get-MpThreatDetection
   [-ThreatID <Int64[]>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

The Get-MpThreatDetection cmdlet gets active and past malware threats that Windows Defender detected on the computer. If Windows Defender has detected the threat that you specify, this cmdlet returns a list that shows each time Windows Defender detected the threat.

Examples

Example 1: Get threats that Windows Defender detected

PS C:\> Get-MpThreatDetection

This command returns the list of past malware detections for the local computer.

Error codes

The following table lists the hexadecimal and decimal error codes for this cmdlet. Each hexadecimal error code has a 0x8050 prefix. Therefore, an ERROR_MP_BAD_SCANID error corresponds to error code 0x80508012. Additionally, an ERR_MP_REMOVE_FAILED error corresponds to error code 0x80508017.

For a list of error codes, along with possible reasons and resolutions, see Windows Defender Antivirus client error codes in the topic Review event logs and error codes to troubleshoot issues with Windows Defender Antivirus.

Symbolic Name Error Number (hexadecimal) Error number (decimal)
ERROR_MP_UI_CONSOLIDATION_BASE 0x80501000 2142236672
ERROR_MP_ACTIONS_FAILED 0x80501001 2142236671
ERROR_MP_BAD_INIT_MODULES 0x80508001 2142207999
ERROR_MP_BAD_DATABASE 0x80508002 2142207998
ERROR_MP_BAD_UFS 0x80508004 2142207996
ERROR_MP_NO_MEMORY 0x80508007 2142207993
ERROR_MP_BAD_INPUT_DATA 0x8050800C 2142288079
ERROR_MP_BAD_GLOBAL_STORAGE 0x8050800D 2142207987
ERROR_MP_OBSOLETE 0x8050800E 2142207986
ERROR_MP_NOT_SUPPORTED 0x8050800F 2142207985
ERROR_MP_NO_MORE_ITEMS 0x80508010 2142207984
ERROR_MP_DUPLICATE_SCANID 0x80508011 2142207983
ERROR_MP_BAD_SCANID 0x80508012 2142207982
ERROR_MP_BAD_USERDB_VERSION 0x80508013 2142207981
ERROR_MP_RESTORE_FAILED 0x80508014 2142207980
ERROR_MP_FAILED_TO_SPYNET 0x80508015 2142207979
ERROR_MP_BAD_ACTION 0x80508016 2142207978
ERROR_MP_REMOVE_FAILED 0x80508017 2142207977
ERROR_MP_SCAN_ABORTED 0x80508018 2142207976
ERROR_MP_NOT_FOUND 0x80508019 2142207975
ERROR_MP_BAD_CONFIGURATION 0x80508020 2142207968
ERROR_MP_QUARANTINE_FAILED 0x80508021 2142207967
ERROR_MP_REBOOT_REQUIRED 0x80508022 2142207966
ERROR_MP_THREAT_NOT_FOUND 0x80508023 2142207965
ERROR_MP_FULL_SCAN_REQUIRED 0x80508024 2142207964
ERROR_MP_MANUAL_STEPS_REQUIRED 0x80508025 2142207963
ERROR_MP_REMOVE_NOT_SUPPORTED 0x80508026 2142207962
ERROR_MP_REMOVE_LOW_MEDIUM_DISABLED 0x80508027 2142207961
ERR_MP_RESCAN_REQUIRED 0x80508029 2142207959
ERROR_RELO_BAD_EHANDLE 0x80509001 2142203903
ERROR_RELO_KERNEL_NOT_LOADED 0x80509003 2142203901
ERROR_MP_BADDB_OPEN 0x8050A001 2142199807
ERROR_MP_BADDB_HEADER 0x8050A002 2142199806
ERROR_MP_BADDB_OLDENGINE 0x8050A003 2142199805
ERROR_MP_BADDB_CONTENT 0x8050A004 2142199804
ERROR_MP_BADDB_NOTSIGNED 0x8050A005 2142199803

Optional Parameters

-AsJob

Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.

The cmdlet immediately returns an object that represents the job and then displays the command prompt. You can continue to work in the session while the job completes. To manage the job, use the *-Job cmdlets. To get the job results, use the Receive-Job cmdlet.

For more information about Windows PowerShell background jobs, see about_Jobs.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CimSession

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ThreatID

Specifies an array of threat IDs. This cmdlet gets the threats that you specify.

Type:Int64[]
Aliases:ID
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ThrottleLimit

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is entered, then Windows PowerShellĀ® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False