add ASR troubleshoot topics

windows/threat-protection/TOC.md

@@ -229,6 +229,7 @@
 #### [Evaluate Attack surface reduction](windows-defender-exploit-guard\evaluate-attack-surface-reduction.md)
 #### [Enable Attack surface reduction](windows-defender-exploit-guard\enable-attack-surface-reduction.md)
 #### [Customize Attack surface reduction](windows-defender-exploit-guard\customize-attack-surface-reduction.md)
+### [Troubleshoot Attack surface reduction rules](windows-defender-exploit-guard\troubleshoot-asr.md)
 ### [Network Protection](windows-defender-exploit-guard\network-protection-exploit-guard.md)
 #### [Evaluate Network Protection](windows-defender-exploit-guard\evaluate-network-protection.md)
 #### [Enable Network Protection](windows-defender-exploit-guard\enable-network-protection.md)

windows/threat-protection/windows-defender-exploit-guard/audit-windows-defender-exploit-guard.md

@@ -71,8 +71,7 @@ You can also use the a custom PowerShell script that enables the features in aud
 
 ## Related topics
 
-Topic | Description 
----|---
+
 - [Protect devices from exploits with Windows Defender Exploit Guard](exploit-protection-exploit-guard.md)
 - [Reduce attack surfaces with Windows Defender Exploit Guard](attack-surface-reduction-exploit-guard.md) 
 - [Protect your network with Windows Defender Exploit Guard](network-protection-exploit-guard.md) 

windows/threat-protection/windows-defender-exploit-guard/collect-cab-files-exploit-guard-submission.md

@@ -0,0 +1,66 @@
+---
+title: Submit cab files related to Windows Defender EG problems
+description: Use the command-line tool to obtain .cab file that can be used to investigate ASR rule issues.
+keywords: troubleshoot, error, fix, asr, windows defender eg, exploit guard, attack surface reduction
+search.product: eADQiWindows 10XVcnh
+ms.pagetype: security
+ms.prod: w10
+ms.mktglfcycl: manage
+ms.sitesec: library
+ms.pagetype: security
+ms.localizationpriority: medium
+author: iaanw
+ms.author: iawilt
+ms.date: 11/01/2017
+---
+
+# Collect diagnostic data for Windows Defender Exploit Guard file submissions
+
+**Applies to:**
+
+- Windows 10, version 1709
+
+**Audience**
+
+- IT administrators
+
+This topic describes how to collect diagnostic data that can be used by Microsoft support and engineering teams to help troubleshoot issues you may encounter when using Windows Defender Exploit Guard. 
+
+In particular, you will be asked to collect and attach this data when using the [Windows Defender Security Intelligence web-based submission form](#) if you indicate that you have encountered a problem with [Attack surface reduction rules](attack-surface-reduction-exploit-guard.md).
+
+Before attempting this process, ensure you have read the [Troubleshoot Windows Defender Exploit Guard ASR rules](troubleshoot-asr.md) topic, met all required pre-requisites, and taken any other suggested troubleshooting steps.
+
+
+1. On the endpoint where the rule is not functioning, obtain the .cab diagnostic file by following this process:
+
+    1. Open an administrator-level version of the command prompt:
+        
+        1. Open the **Start** menu.
+        
+        2. Type **cmd**. Right-click on **Command Prompt** and click **Run as administrator**.
+        
+        3. Enter administrator credentials or approve the prompt.
+        
+    2. Navigate to the Windows Defender directory. By default, this is C:\Program Files\Windows Defender, as in the following example:
+        
+        ```Dos
+        cd c:\program files\windows\defender
+        ```
+    
+    3. Enter the following command and press **Enter**
+        
+        ```Dos
+        mpcmdrun -getfiles
+        ```
+    
+    4. A .cab file will be generated that contains various diagnostic logs. The location of the file will be specified in the output in the command prompt, but by default it will be in C:\ProgramData\Microsoft\Windows Defender\Support\MpSupportFiles.cab.
+
+2. Attach this .cab file to the submission form where indicated.
+
+
+
+
+## Related topics
+
+- [Troubleshoot Windows Defender Antivirus reporting](troubleshoot-reporting.md)
+

windows/threat-protection/windows-defender-exploit-guard/troubleshoot-asr.md

@@ -0,0 +1,120 @@
+---
+title: Troubleshoot problems with Attack surface reduction rules
+description: Check pre-requisites, use audit mode, add exclusions, or collect diagnostic data to help troubleshoot issues
+keywords: troubleshoot, error, fix, windows defender eg, asr, rules, hips, troubleshoot, audit, exclusion, false positive, broken, blocking
+search.product: eADQiWindows 10XVcnh
+ms.pagetype: security
+ms.prod: w10
+ms.mktglfcycl: manage
+ms.sitesec: library
+ms.pagetype: security
+ms.localizationpriority: medium
+author: iaanw
+ms.author: iawilt
+ms.date: 09/06/2017
+---
+
+# Troubleshoot Attack surface reduction rules
+
+**Applies to:**
+
+- Windows 10, version 1709
+
+**Audience**
+
+- IT administrators
+
+When you use [Attack surface reduction rules](attack-surface-reduction-exploit-guard.md) you may encounter issues, such as:
+
+- A rule blocks a file, process, or performs some other action that it should not (false positive)
+- A rule does not work as described, or does not block a file or process that it should (false negative)
+
+
+
+There are four steps to troubleshooting these problems:
+
+1. Confirm that you have met all pre-requisites
+2. Use audit mode to test the rule
+3. Add exclusions for the specified rule (for false positives)
+3. Submit support logs
+
+
+
+## Confirm pre-requisites
+
+Windows Defender Exploit Guard will only work on devices with the following conditions:
+
+>[!div class="checklist"]
+> - Endpoints are running Windows 10, version 1709 (also known as the Fall Creators Update).
+> - Endpoints are using Windows Defender Antivirus as the sole antivirus protection app. [Using any other antivirus app will cause Windows Defender AV to disable itself](../windows-defender-antivirus/windows-defender-antivirus-compatibility.md).
+> - [Real-time protection](../windows-defender-antivirus/configure-real-time-protection-windows-defender-antivirus.md) is enabled.
+> - Audit mode is not enabled. Use Group Policy to set the rule to **Disabled** (value: **0**) as described in the [Enable ASR topic](enable-attack-surface-reduction.md#use-group-policy-to-enable-attack-surface-reduction-rules).
+
+
+If these pre-requisites have all been met, proceed to the next step to test the rule in audit mode.
+
+## Use audit mode to test the rule
+
+There are two ways that you can test if the rule is working. 
+
+You can use a pre-configured demo tool to confirm ASR is generally working on the device, or you can use audit mode, which enables the rule for reporting only. 
+
+The demo tool uses pre-configured scenarios and processes, which can be useful to first see if the ASR feature as a whole is operating correctly.
+
+If you encounter problems when running the demo tool, check that the device you are testing the tool on meets the [pre-requisites listed above](#confirm-pre-requisites).
+
+You should follow the instructions in the section [Use the demo tool to see how ASR works](evaluate-attack-surface-reduction.md#use-the-demo-tool-to-see-how-attack-surface-reduction-works) to test the specific rule you are encountering problems with.
+
+>[!TIP]
+>While the instructions for using the demo tool are intended for evaluating or seeing how ASR works, you can use it to test that the rule works on known scenarios that we have already extensively tested before we released the feature. 
+
+Audit mode allows the rule to report as if it actually blocked the file or process, but will still allow the file to run.
+
+1. Enable audit mode for the specific rule you want to test. Use Group Policy to set the rule to **Audit mode** (value: **2**) as described in the [Enable ASR topic](enable-attack-surface-reduction.md#use-group-policy-to-enable-attack-surface-reduction-rules).
+2. Perform the activity that is causing an issue (for example, open or execute the file or process that should be blocked but is being allowed).
+3. [Review the ASR event logs](attack-surface-reduction-exploit-guard.md#review-attack-surface-reduction-events-in-windows-event-viewer) to see if the rule would have blocked the file or process if the rule had been set to **Enabled**.
+
+
+>[!TIP] 
+>Audit mode will stop the rule from blocking the file or process. 
+>
+>If a rule is not blocking a file or process that you are expecting it should block, first check if audit mode is enabled. 
+>
+>Audit mode may have been enabled for testing another feature in Windows Defender Exploit Guard, or by an automated PowerShell script, and may not have been disabled after the tests were completed.
+
+
+If you've tested the rule with the demo tool and with audit mode, and ASR is working on pre-configured scenarios, but the rule is not working as expected, proceed to either of the following sections based on your situation:
+
+1. If the ASR rule is blocking something that it should not block (also known as a false positive), you can [first add an ASR exclusion](#add-exclusions-for-a-false-positive).
+2. If the ASR rule is not blocking something that it should block (also known as a false negative), you can proceed immeidately to the last step, [collecting diagnostic data and submitting the issue to us](#collect-diagnostic-data).
+
+## Add exclusions for a false positive
+
+You can add exclusions to ASR to prevent ASR rules from evaluating the excluded files or folders.
+
+This is useful if you have enabled a rule, and it is blocking a file, process, or action that you believe it should not block. You can then collect data from an endpoint where the rule is not working correctly and send that information to us.
+
+To add an exclusion, see the [Customize Attack surface reduction](customize-attack-surface-reduction.md) topic.
+
+>[!IMPORTANT]
+>You can specify individual files and folders to be excluded, but you cannot specify individual rules.
+>
+>This means any files or folders that are excluded will be excluded from all ASR rules.
+
+
+If you have followed all previous troubleshooting steps, and you still have a problem (in particular, if you have a false positive), you should proceed to the next step to collect diagnostic information and send it to us.
+
+## Collect diagnostic data
+
+> [!div class="nextstepaction"]
+> [Collect and submit diagnostic data for ASR rules](collect-cab-files-exploit-guard-submission.md)
+
+
+
+
+
+
+## Related topics
+
+- [Windows Defender Exploit Guard](windows-defender-exploit-guard.md)
+- [Attack surface reduction](attack-surface-reduction-exploit-guard.md)