Running and Filtering Scans in Best Practices Analyzer

Open Server Manager. To open Server Manager, click Start, point to Administrative Tools, and then click Server Manager.

In the tree pane, open Roles, and then select the role for which you want to open BPA.

In the details pane, open the Summary section, and then open the Best Practices Analyzer area.

Click Scan this Role to start a scan.

Open a Windows PowerShell session with elevated user rights. To do this, click Start, click All Programs, click Accessories, click Windows PowerShell, right-click the Windows PowerShell shortcut, and then click Run as administrator.

Import the Server Manager module into your Windows PowerShell session. To import the Server Manager module, type the following, and then press ENTER.

Import-Module ServerManager

Import the BPA module. Type the following, and then press Enter.

Import-Module BestPractices

Find the model IDs of all role(s) for which BPA scans can be performed by entering the Get-WindowsFeature cmdlet with the qualifier BestPracticesModelId not equal to “null,” as shown in the following example.

Get-WindowsFeature | Where {$_.BestPracticesModelId -ne $null}

In the results of step 4, locate the model ID of the role for which you want to perform a BPA scan.

Enter the following command to start the BPA scan for that role.

Invoke-BPAModel -BestPracticesModelId ModelID_from_Step4

If a BPA scan can be run on a specified role, you can also start a scan by piping the results of the Get-WindowsFeature cmdlet into the Invoke-BPAModel cmdlet as shown in the following example.

Get-WindowsFeature Model_Name | Invoke-BPAModel

Open a Windows PowerShell session with elevated user rights. To do this, click Start, click All Programs, click Accessories, click Windows PowerShell, right-click the Windows PowerShell shortcut, and then click Run as administrator.

Import the Server Manager module into your Windows PowerShell session. To import the Server Manager module, type the following, and then press ENTER.

Import-Module ServerManager

Import the BPA module. Type the following, and then press Enter.

Import-Module BestPractices

Pipe all roles for which BPA scans can be performed into the Invoke-BPAModel cmdlet to start scans.

Get-WindowsFeature | Where {$_.BestPracticesModelId -ne $null} | Invoke-BPAModel

Open Server Manager. To open Server Manager, click Start, point to Administrative Tools, and then click Server Manager.

In the tree pane, open Roles, and then select the role for which you want to open BPA.

In the details pane, open the Summary section, and then open the Best Practices Analyzer area.

Select a result from the Noncompliant, Compliant, or All tabs, and then click Exclude.

To exclude multiple results at one time, hold down the Ctrl key when you select results.

Open a Windows PowerShell session with elevated user rights. To do this, click Start, click All Programs, click Accessories, click Windows PowerShell, right-click the Windows PowerShell shortcut, and then click Run as administrator.

Import the Server Manager module into your Windows PowerShell session. To import the Server Manager module, type the following, and then press ENTER.

Import-Module ServerManager

Import the BPA module. Type the following, and then press Enter.

Import-Module BestPractices

Exclude specific results from a role scan by entering the following cmdlet.

Get-BPAResult -BestPracticesModelId Specified Model Id | Where { $_ Field_Name -eq "Value" } | Set-BPAResult -Id Specified Model Id -Exclude $true

The previous cmdlet retrieves BPA scan result items for the model ID represented by Specified Model Id. The second section of the command filters the results of the Get-BPAResult cmdlet to retrieve only those scan results for which the value for a result field matches the text in quotation marks. The final section of the cmdlet, following the second pipe character, excludes the results filtered by the previous section of the cmdlet.

Open Server Manager. To open Server Manager, click Start, point to Administrative Tools, and then click Server Manager.

In the tree pane, open Roles, and then select the role for which you want to open BPA.

In the details pane, open the Summary section, and then open the Best Practices Analyzer area.

Select a result from the Excluded tab, and then click Include.

To include multiple results at one time, hold down the Ctrl key when you are selecting results.

Open a Windows PowerShell session with elevated user rights. To do this, click Start, click All Programs, click Accessories, click Windows PowerShell, right-click the Windows PowerShell shortcut, and then click Run as administrator.

Import the Server Manager module into your Windows PowerShell session. To import the Server Manager module, type the following, and then press Enter.

Import-Module ServerManager

Import the BPA module. Type the following, and then press Enter.

Import-Module BestPractices

Include specific results from a role scan by typing the following cmdlet, and then pressing Enter.

Get-BPAResult -BestPracticesModelId Specified Model Id | Where { $_Field_Name-eq "Value" } | Set-BPAResult -Id Specified Model Id -Exclude $false

The previous cmdlet retrieves BPA scan result items for the model represented by Specified Model Id. The second part of the cmdlet, after the first pipe character ( | ) filters the results of the Get-BPAResult cmdlet to retrieve only those scan results for which the value of the result field matches the text in quotation marks. The final part of the cmdlet, after the second pipe character, includes results that are filtered by the second part of the cmdlet, by setting the value of the –Exclude parameter to false.