Remove-PswaAuthorizationRule

Article
06/29/2012

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Remove-PswaAuthorizationRule

Removes a specified authorization rule from Windows PowerShell® Web Access.

Syntax

Parameter Set: ID
Remove-PswaAuthorizationRule [-Id] <Int32> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Rule
Remove-PswaAuthorizationRule [-Rule] <PswaAuthorizationRule> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

Removes a specified authorization rule from Windows PowerShell® Web Access.

Parameters

-Force

Runs the cmdlet without prompting for confirmation. By default the cmdlet will ask for confirmation from the user before proceeding.

Aliases	none
Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Id<Int32>

Specifies the identifiers (IDs) of one or more rules to remove.

Aliases	none
Required?	true
Position?	2
Default Value	false
Accept Pipeline Input?	true (ByValue, ByPropertyName)
Accept Wildcard Characters?	false

-Rule<PswaAuthorizationRule>

Specifies the rules to remove.

Aliases	none
Required?	true
Position?	2
Default Value	false
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

None

Outputs

The output type is the type of the objects that the cmdlet emits.

None

Examples

EXAMPLE 1

This example removes the authorization rule with an ID of 2.

PS C:\> Remove-PswaAuthorizationRule –Id 2

EXAMPLE 2

This example removes all authorization rules and also requires confirmation by the user.

PS C:\> Get-PswaAuthorizationRule | Remove-PswaAuthorizationRule -Confirm

Add-PswaAuthorizationRule

Get-PswaAuthorizationRule

Test-PswaAuthorizationRule

Install-PswaWebApplication

Remove-PswaAuthorizationRule