< Back
Get-BpaResult
Post
NAME Get-BpaResult
SYNOPSIS
Retrieves and displays the results of the most recent Best Practices Analyzer (BPA) scan for a specific model.
SYNTAX
Get-BpaResult [-ModelId] <String> [[-CollectedConfiguration]] [-All] [-Filter <FilterOptions>] [-RepositoryPath <String>] [<CommonParameters>]
Get-BpaResult [-ModelId] <String> [[-CollectedConfiguration]] [-All] [-ComputerName <String[]>] [-Context <String>] [-Filter <FilterOptions>]
[-RepositoryPath <String>] [-SubModelId <String>] [<CommonParameters>]
DESCRIPTION
The Get-BpaResult cmdlet retrieves and displays the results of the latest Best Practices Analyzer (BPA) scan for a specific model that is
installed on a computer. To use this cmdlet, add the ModelId parameter, and specify the model identifier (ID) for which to view the most recent
BPA scan results. The All parameter can be used to retrieve all of the scanned results for a particular model. If the All parameter is not
specified, then the most recent results of the particular model are returned.
This cmdlet can be used to view the results of a BPA scan for a specific model. An administrator specifies a model ID as a parameter and the
latest results for that model are displayed.
Note: This cmdlet does not start a new BPA scan.
PARAMETERS
-All [<SwitchParameter>]
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.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-CollectedConfiguration [<SwitchParameter>]
Returns only discovery information that was collected during a BPA scan, not the results of evaluating rules in the model.
Required? false
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ComputerName <String[]>
Specifies the target computer from which to retrieve BPA results.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Context <String>
Scans a submodel in the context of a specific model (one that is different from the parent model of the submodel). 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.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Filter <FilterOptions>
Filters the type of result to return. The acceptable values for this parameter are:?? ?? All, Compliant, or Noncompliant.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ModelId <String>
Identifies the model from which results need to be obtained.
Required? true
Position? 2
Default value
Accept pipeline input? True (ByValue, ByPropertyName)
Accept wildcard characters? false
-RepositoryPath <String>
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.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SubModelId <String>
Identifies the submodel for the model specified by the ModelId parameter.
Example: The Update Services model (Microsoft/Windows/UpdateServices) has two submodels (UpdateServices-DB, UpdateServices-Services).
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.String
OUTPUTS
Microsoft.BestPractices.CoreInterface.Report
Microsoft.BestPractices.CoreInterface.Result
EXAMPLE 1
PS C:\\> Get-BPAResult -ModelId ModelId1
This example returns the most recent Best Practices Analyzer scan results for the model that is represented by ModelId1. The short form of the
ModelId parameter can also be used, Id.
EXAMPLE 2
PS C:\\> Get-BPAModel | Get-BPAResult
This example, the Get-BpaModel cmdlet is used to return a list of all BPA models that are installed on the computer. The results of the
Get-BpaModel cmdlet are piped to this cmdlet to retrieve the most recent Best Practices Analyzer scan results for all models that are supported by
BPA.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/p/?LinkId=287254
Get-BpaModel
Invoke-BpaModel
Set-BpaResult
SYNOPSIS
Retrieves and displays the results of the most recent Best Practices Analyzer (BPA) scan for a specific model.
SYNTAX
Get-BpaResult [-ModelId] <String> [[-CollectedConfiguration]] [-All] [-Filter <FilterOptions>] [-RepositoryPath <String>] [<CommonParameters>]
Get-BpaResult [-ModelId] <String> [[-CollectedConfiguration]] [-All] [-ComputerName <String[]>] [-Context <String>] [-Filter <FilterOptions>]
[-RepositoryPath <String>] [-SubModelId <String>] [<CommonParameters>]
DESCRIPTION
The Get-BpaResult cmdlet retrieves and displays the results of the latest Best Practices Analyzer (BPA) scan for a specific model that is
installed on a computer. To use this cmdlet, add the ModelId parameter, and specify the model identifier (ID) for which to view the most recent
BPA scan results. The All parameter can be used to retrieve all of the scanned results for a particular model. If the All parameter is not
specified, then the most recent results of the particular model are returned.
This cmdlet can be used to view the results of a BPA scan for a specific model. An administrator specifies a model ID as a parameter and the
latest results for that model are displayed.
Note: This cmdlet does not start a new BPA scan.
PARAMETERS
-All [<SwitchParameter>]
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.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-CollectedConfiguration [<SwitchParameter>]
Returns only discovery information that was collected during a BPA scan, not the results of evaluating rules in the model.
Required? false
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ComputerName <String[]>
Specifies the target computer from which to retrieve BPA results.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Context <String>
Scans a submodel in the context of a specific model (one that is different from the parent model of the submodel). 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.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Filter <FilterOptions>
Filters the type of result to return. The acceptable values for this parameter are:?? ?? All, Compliant, or Noncompliant.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ModelId <String>
Identifies the model from which results need to be obtained.
Required? true
Position? 2
Default value
Accept pipeline input? True (ByValue, ByPropertyName)
Accept wildcard characters? false
-RepositoryPath <String>
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.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SubModelId <String>
Identifies the submodel for the model specified by the ModelId parameter.
Example: The Update Services model (Microsoft/Windows/UpdateServices) has two submodels (UpdateServices-DB, UpdateServices-Services).
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.String
OUTPUTS
Microsoft.BestPractices.CoreInterface.Report
Microsoft.BestPractices.CoreInterface.Result
EXAMPLE 1
PS C:\\> Get-BPAResult -ModelId ModelId1
This example returns the most recent Best Practices Analyzer scan results for the model that is represented by ModelId1. The short form of the
ModelId parameter can also be used, Id.
EXAMPLE 2
PS C:\\> Get-BPAModel | Get-BPAResult
This example, the Get-BpaModel cmdlet is used to return a list of all BPA models that are installed on the computer. The results of the
Get-BpaModel cmdlet are piped to this cmdlet to retrieve the most recent Best Practices Analyzer scan results for all models that are supported by
BPA.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/p/?LinkId=287254
Get-BpaModel
Invoke-BpaModel
Set-BpaResult