Skip to content

Commit 612acfd

Browse files
committed
Update tune-performance-defender-antivirus.md
1 parent a892686 commit 612acfd

File tree

1 file changed

+23
-25
lines changed

1 file changed

+23
-25
lines changed

defender-endpoint/tune-performance-defender-antivirus.md

Lines changed: 23 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -43,9 +43,9 @@ Microsoft Defender Antivirus performance analyzer has the following prerequisite
4343

4444
## What is the Microsoft Defender Antivirus performance analyzer?
4545

46-
If computers running Microsoft Defender Antivirus are experiencing performance issues, you can use performance analyzer to improve the performance of Microsoft Defender Antivirus. Performance analyzer for Microsoft Defender Antivirus in Windows 10, Windows 11, and Windows Server, is a PowerShell command-line tool that helps you determine files, file extensions, and processes that might be causing performance issues on individual endpoints during antivirus scans. You can use the information gathered by performance analyzer to assess performance issues and apply remediation actions.
46+
If devices running Microsoft Defender Antivirus are experiencing performance issues, you can use the performance analyzer to improve the performance of Microsoft Defender Antivirus. The performance analyzer is a PowerShell command-line tool that helps you determine files, file extensions, and processes that might be causing performance issues on individual endpoints during antivirus scans. You can use the information gathered by performance analyzer to assess performance issues and apply remediation actions.
4747

48-
Similar to the way mechanics perform diagnostics and service on a vehicle that has performance problems, performance analyzer can help you improve Defender Antivirus performance.
48+
Similar to the way mechanics perform diagnostics and service on a vehicle that has performance problems, the performance analyzer can help you improve Microsoft Defender Antivirus performance.
4949

5050
:::image type="content" source="media/performance-analyzer-improve-defender-antivirus-performance.png" alt-text="Conceptual performance analyzer image for Microsoft Defender Antivirus." lightbox="media/performance-analyzer-improve-defender-antivirus-performance.png":::
5151

@@ -64,18 +64,18 @@ Some options to analyze include:
6464

6565
## Running performance analyzer
6666

67-
The high-level process for running performance analyzer involves the following steps:
67+
The high-level process for running the performance analyzer involves the following steps:
6868

69-
1. Run performance analyzer to collect a performance recording of Microsoft Defender Antivirus events on the endpoint.
69+
1. Run the performance analyzer to collect a performance recording of Microsoft Defender Antivirus events on the endpoint.
7070

7171
> [!NOTE]
72-
> Performance of Microsoft Defender Antivirus events of the type **Microsoft-Antimalware-Engine** are recorded through the performance analyzer.
72+
> Performance of Microsoft Defender Antivirus events of the type `Microsoft-Antimalware-Engine` are recorded through the performance analyzer.
7373
7474
2. Analyze the scan results using different recording reports.
7575

7676
## Using performance analyzer
7777

78-
To start recording system events, open PowerShell in administrative mode and perform the following steps:
78+
To start recording system events, open PowerShell in administrator mode and perform the following steps:
7979

8080
1. Run the following command to start the recording:
8181

@@ -94,21 +94,19 @@ To start recording system events, open PowerShell in administrative mode and per
9494
For more information on command-line parameters and options, see the [New-MpPerformanceRecording](#new-mpperformancerecording) and [Get-MpPerformanceReport](#get-mpperformancereport).
9595

9696
> [!NOTE]
97-
> When running a recording, if you get the error "Cannot start performance recording because Windows Performance Recorder is already recording", run the following command to stop the existing trace with the new command:
98-
> **wpr -cancel -instancename MSFT_MpPerformanceRecording**
97+
> When running a recording, if you get the error "Cannot start performance recording because Windows Performance Recorder is already recording", run the following command to stop the existing trace with the new command: `wpr -cancel -instancename MSFT_MpPerformanceRecording`.
9998
10099
## Performance tuning data and information
101100

102-
Based on the query, the user is able to view data for scan counts, duration (total/min/average/max/median), path, process, and **reason for scan**. The following image shows sample output for a simple query of the top 10 files for scan impact.
101+
Based on the query, the user is able to view data for scan counts, duration (total/min/average/max/median), path, process, and reason for scan. The following image shows sample output for a simple query of the top 10 files for scan impact.
103102

104103
:::image type="content" source="media/example-output.png" alt-text="Example output for a basic TopFiles query" lightbox="media/example-output.png":::
105104

106105
## Exporting and converting to CSV and JSON
107106

108-
The results of the performance analyzer can also be exported and converted to a CSV or JSON file.
109-
For examples that describe the process of "export" and "convert" through sample codes, see the following sections.
107+
The results of the performance analyzer can also be exported and converted to a CSV or JSON file. This article includes examples that describe the process of "export" and "convert" through sample code.
110108

111-
Starting with Defender version `4.18.2206.X`, users are able to view scan skip reason information under "SkipReason" column. The possible values are:
109+
Starting with Defender version `4.18.2206.X`, users are able to view scan skip reason information under `SkipReason` column. The possible values are:
112110

113111
- Not Skipped
114112
- Optimization (typically due to performance reasons)
@@ -145,7 +143,7 @@ There are two new PowerShell cmdlets used to tune performance of Microsoft Defen
145143

146144
### New-MpPerformanceRecording
147145

148-
The following section describes the reference for the new PowerShell cmdlet New-MpPerformanceRecording. This cmdlet Collects a performance recording of Microsoft Defender Antivirus scans.
146+
The following section describes the reference for the new PowerShell cmdlet `New-MpPerformanceRecording`. This cmdlet Collects a performance recording of Microsoft Defender Antivirus scans.
149147

150148
#### Syntax: New-MpPerformanceRecording
151149

@@ -157,7 +155,7 @@ New-MpPerformanceRecording -RecordTo <String>
157155

158156
The `New-MpPerformanceRecording` cmdlet collects a performance recording of Microsoft Defender Antivirus scans. These performance recordings contain Microsoft-Antimalware-Engine and NT kernel process events and can be analyzed after collection using the [Get-MpPerformanceReport](#get-mpperformancereport) cmdlet.
159157

160-
This `New-MpPerformanceRecording` cmdlet provides an insight into problematic files that could cause a degradation in the performance of Microsoft Defender Antivirus. This tool is provided "AS IS", and isn't intended to provide suggestions on exclusions. Exclusions can reduce the level of protection on your endpoints. Exclusions, if any, should be defined with caution.
158+
This `New-MpPerformanceRecording` cmdlet provides an insight into problematic files that could cause a degradation in the performance of Microsoft Defender Antivirus. This tool is provided "as is", and isn't intended to provide suggestions on exclusions. Exclusions can reduce the level of protection on your endpoints. Exclusions, if any, should be defined with caution.
161159

162160
For more information on the performance analyzer, see [Performance Analyzer](/windows-hardware/test/wpt/windows-performance-analyzer) docs.
163161

@@ -345,17 +343,17 @@ This flag can accompany all other Top Path options. If missing, a default value
345343

346344
| flag | definition |
347345
|:---|:---|
348-
| -**TopScansPerPath** | Specifies how many top scans to specify for each top path. |
349-
| -**TopFilesPerPath** | Specifies how many top files to specify for each top path. |
350-
| -**TopScansPerFilePerPath** | Specifies how many top scans to output for each top file for each top path, sorted by "Duration" |
351-
| -**TopExtensionsPerPath** | Specifies how many top extensions to output for each top path |
352-
| -**TopScansPerExtensionPerPath** | Specifies how many top scans to output for each top extension for each top path |
353-
| -**TopProcessesPerPath** | Specifies how many top processes to output for each top path |
354-
| -**TopScansPerProcessPerPath** | Specifies how many top scans to output for each top process for each top path |
355-
| -**TopPathsPerExtension** | Specifies how many top paths to output for each top extension |
356-
| -**TopScansPerPathPerExtension** | Specifies how many top scans to output for each top path for each top extension |
357-
| -**TopPathsPerProcess** | Specifies how many top paths to output for each top process |
358-
| -**TopScansPerPathPerProcess** | Specifies how many top scans to output for each top path for each top process |
346+
| -`TopScansPerPath` | Specifies how many top scans to specify for each top path. |
347+
| -`TopFilesPerPath` | Specifies how many top files to specify for each top path. |
348+
| -`TopScansPerFilePerPath` | Specifies how many top scans to output for each top file for each top path, sorted by "Duration" |
349+
| -`TopExtensionsPerPath` | Specifies how many top extensions to output for each top path |
350+
| -`TopScansPerExtensionPerPath` | Specifies how many top scans to output for each top extension for each top path |
351+
| -`TopProcessesPerPath` | Specifies how many top processes to output for each top path |
352+
| -`TopScansPerProcessPerPath` | Specifies how many top scans to output for each top process for each top path |
353+
| -`TopPathsPerExtension` | Specifies how many top paths to output for each top extension |
354+
| -`TopScansPerPathPerExtension` | Specifies how many top scans to output for each top path for each top extension |
355+
| -`TopPathsPerProcess` | Specifies how many top paths to output for each top process |
356+
| -`TopScansPerPathPerProcess` | Specifies how many top scans to output for each top path for each top process |
359357

360358
##### -MinDuration
361359

0 commit comments

Comments
 (0)