COMMAND EVERYTHING.

Get-BpaResult

Retrieves and displays the results of the most recent Best Practices Analyzer (BPA) scan for a specific model.

PowerShell · Risk: Low · Documentation Verified

Last verified: 2026-10-26

Microsoft BestPractices reference: Retrieves and displays the results of the most recent Best Practices Analyzer (BPA) scan for a specific model. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.

Get-BpaResult [-ModelId] <String> [-CollectedConfiguration] [-All] [-Filter <FilterOptions>]
 [-RepositoryPath <String>] [<CommonParameters>]

Copied 0 times

Required permissions

Use an account with the target resource permissions documented for Get-BpaResult. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.

Supported environments

Windows / BestPractices · Windows Server 2025 documentation; feature/module prerequisites apply

Parameters

-All: Returns the output type Reports. This parameter can be used to retrieve all of the scanned results for a particular model. If this parameter is not specified, then the most recent results of the particular model are returned.
-CollectedConfiguration: Returns only discovery information that was collected during a BPA scan, not the results of evaluating rules in the model.
-ComputerName: Specifies the target computer from which to retrieve BPA results.
-Context: Scans a submodel in the context of a specific model (one that is different from the parent model of the submodel). For example, an administrator wants to run a scan on the Backend submodel of the SQL model, but only those in the context of a third model, a technology that relies upon SQL Server.
-Filter: Filters the type of result to return. The acceptable values for this parameter are: - All - Compliant - Noncompliant
-ModelId (required): Identifies the model from which results need to be obtained.
-RepositoryPath: Specifies the location of the repository from which to get the results generated by the Invoke-BpaModel. The Invoke-BpaModel cmdlet provides an option to store the results either in the default reports repository location contained in the ReportsRoot registry key or in the custom location supplied as the value of this parameter.
-SubModelId: Identifies the submodel for the model specified by the *ModelId* parameter.For example, the Update Services model (Microsoft/Windows/UpdateServices) has two submodels (UpdateServices-DB, UpdateServices-Services).

Prerequisites

Windows with the BestPractices module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.

Security considerations

This is a read-oriented cmdlet; protect any sensitive results and check the documented effects of your selected parameters.

Examples

Example 1: Get BPA scan results by model ID

Get-BPAResult -ModelId ModelId1

This example returns the most recent BPA scan results for the model that is represented by ModelId1. The short form of the *ModelId* parameter can also be used, *Id*. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.

Sources

https://github.com/MicrosoftDocs/windows-powershell-docs/blob/b7645dd8c687139b28e845119da30ec670526507/docset/winserver2025-ps/BestPractices/Get-BpaResult.md

https://learn.microsoft.com/powershell/module/bestpractices/get-bparesult?view=windowsserver2025-ps

Personal collections

Explain or customize this command with AI

Related commands