Remove-PswaAuthorizationRule
[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