Remove-SCACUserRole
Applies To: System Center 2012 R2 App Controller
Remove-SCACUserRole
Removes the specified user role.
Syntax
Parameter Set: Default
Remove-SCACUserRole [-UserRole] <ACUserRole> [-PassThru] [ <CommonParameters>]
Detailed Description
The Remove-SCACUserRole cmdlet removes the specified user role.
Parameters
-PassThru
Returns a user role object. By default, this cmdlet does not generate output.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-UserRole<ACUserRole>
Specifies the user role object to remove. To retrieve a user role, use the Get-SCACUserRole cmdlet.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
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.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Remove a user role
The first command gets the user role object named UserRole01 and stores the object in the $UserRole variable.
The second command removes the user role stored in $UserRole.
PS C:\> $UserRole = Get-SCACUserRole -Name "UserRole01" –Managed
PS C:\> Remove-SCACUserRole –UserRole $UserRole