Get-PswaAuthorizationRule

Returns a set of the Windows PowerShell® Web Access authorization rules.

Syntax

Get-PswaAuthorizationRule
   [[-Id] <Int32[]>]
   [<CommonParameters>]
Get-PswaAuthorizationRule
   [-RuleName] <String[]>
   [<CommonParameters>]

Description

The Get-PswaAuthorizationRule cmdlet returns a set of the Windows PowerShell® Web Access authorization rules.

If neither the Id parameter nor the RuleName parameter is specified, then this cmdlet lists all rules. The Id parameter can be used to filter the results.

Examples

EXAMPLE 1

PS C:\> Get-PswaAuthorizationRule

This example gets all of the rules.

EXAMPLE 2

PS C:\> Get-PswaAuthorizationRule -Id 2

This example gets a rule with an ID of 2.

EXAMPLE 3

PS C:\> "rule1",0 | Get-PswaAuthorizationRule

This example illustrates how the cmdlet accepts a value from pipeline. A rule id and a rule name are passed in this cmdlet.

Required Parameters

-RuleName

Specifies the names of authorization rules to retrieve. This parameter returns any rules that exactly match the rule names of the strings in this array.

Type:String[]
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False

Optional Parameters

-Id

Specifies the identifiers (IDs) of the rules that this cmdlet should get. If no IDs are specified, then this cmdlet returns all authorization rules.

Type:Int32[]
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False

Inputs

int[], String[]

This cmdlet accepts an array of integers or an array of string values as input.

Outputs

Microsoft.Management.PowerShellWebAccess.PswaAuthorizationRule[]

This cmdlet produces a PswaAuthorizationRule object as output.