Remove-SCACUserRole

Applies To: System Center 2012 - App Controller

Remove-SCACUserRole

Removes the specified user role.

Syntax

Parameter Set: __AllParameterSets
Remove-SCACUserRole [-UserRole] <ACUserRole> [ <CommonParameters>]

Detailed Description

The Remove-SCACUserRole function removes the specified user role.

Parameters

-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

Examples

-------------------------- EXAMPLE 1 --------------------------

Description

-----------

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 –Managed | where { $_.Name –eq “UserRole01” }
PS C:\> Remove-SCACUserRole –UserRole $UserRole

Get-SCACUserRole