Get-PowerAppsCheckerRules
This topic is pre-release documentation and is subject to change.
Obtains the list of rules for a specific ruleset or rulesets currently supported by the PowerApps checker service.
Syntax
ServiceReqApi
Get-PowerAppsCheckerRules
[-ApiUrl] <Uri>
[-IncludeMessageFormats]
[-Ruleset <Ruleset[]>]
[-TenantId <Guid>]
[-LocaleName <String>]
[-MaxConnectionTimeOutMinutes <Int32>]
[<CommonParameters>]
ServiceReqGeo
Get-PowerAppsCheckerRules
[[-Geography] <ApiGeography>]
[-IncludeMessageFormats]
[-Ruleset <Ruleset[]>]
[-TenantId <Guid>]
[-LocaleName <String>]
[-MaxConnectionTimeOutMinutes <Int32>]
[<CommonParameters>]
Description
The Get-PowerAppsCheckerRulesets cmdlet obtains the list of rules available, but the most common usage is to obtain a list of rules included in a ruleset. An array of Microsoft.PowerApps.Checker.Client.Models.Rule objects is returned.
Examples
Example 1
PS C:\> $rulesets = Get-PowerAppsCheckerRulesets -Geography Europe
PS C:\> $rules = $rulesets | Get-PowerAppsCheckerRules -Geography Europe
Returns the rules available in all available rulesets in the geography.
Example 2
PS C:\> $rulesets = Get-PowerAppsCheckerRulesets -Geography Europe
PS C:\> $rules = $rulesets | Get-PowerAppsCheckerRules -Geography Europe -LocaleName es
Returns the rules available in all available rulesets in the geography with the Description and Summary properties translated in Spanish.
Parameters
-ApiUrl
URL of the PowerApps checker root service endpoint. Unless provided a direct URL from Microsoft, Geography should be used.
Parameter properties
| Type: | Uri |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
ServiceReqApi
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Geography
When executing Invoke-PowerAppsChecker the PowerApps checker service temporarily stores the data that you upload in Azure along with the reports that are generated. By specifying a geography, you can control where the data is stored. If no geography is specified, then the United States preview region is used. It is suggested to specify the same geography that will be provided to Invoke-PowerAppsChecker. Each geography may have a different version at any given point in time and doing this ensures that there is version compatibility. In some cases, it may reduce execution time as the data will not have to travel as far.
Parameter properties
| Type: | ApiGeography |
| Default value: | None |
| Accepted values: | PreviewUnitedStates, UnitedStates, Europe, Asia, Australia, Japan, India, Canada, SouthAmerica, UnitedKingdom, France |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
ServiceReqGeo
| Position: | 0 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-IncludeMessageFormats
When specified, includes all of the issue message variations available for the resulting rules in the Locale specified. This can be used in cases where additional translations are being performed to provide the output in a different language.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-LocaleName
Specifies the language code that determines how the results are listed, such as es, for Spanish. The languages that are supported are included in the validation set of the parameter.
Parameter properties
| Type: | String |
| Default value: | en |
| Accepted values: | bg, ca, cs, da, de, el, en, es, et, eu, fi, fr, gl, hi, hr, hu, id, it, ja, kk, ko, lt, lv, ms, nb, nl, pl, pt-BR, pt-pt, ro, ru, sk, sl, sr-Cyrl-RS, sr-Latn-RS, sv, th, tr, uk, vi, zh-HANS, zh-HANT |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-MaxConnectionTimeOutMinutes
Maximum number in minutes to wait before quitting the operation.
Parameter properties
| Type: | Int32 |
| Default value: | 2 |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Ruleset
A ruleset is a collection of rules that are referenceable by name or Id. The Get-PowerAppsCheckerRulesets cmdlet obtains the list of rulesets currently supported by the PowerApps checker service. The required type is Microsoft.PowerApps.Checker.Client.Models.Ruleset[] The minimal requirement to be included is a valid value for either the Name or Id property.
Parameter properties
| Type: | Ruleset[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-TenantId
Id of the tenant that is requesting the information. For normal usage this is not necessary to provide. It is also referred to as the directory Id.
Parameter properties
| Type: | Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
System.Management.Automation.SwitchParameter
Microsoft.PowerApps.Checker.Client.Models.Ruleset
System.Nullable`1
System.Uri
System.String
Microsoft.PowerApps.Checker.PowerShell.ApiGeography
System.Int32
Outputs
System.Object
Notes
It is suggested that you periodically run this cmdlet to query the service for updates to the list of available rulesets.