Get-SCACUserRole

Applies To: System Center 2012 R2 App Controller

Get-SCACUserRole

Gets user roles on the App Controller server.

Syntax

Parameter Set: Default
Get-SCACUserRole [-Managed] [-Name <String> ] [ <CommonParameters>]

Detailed Description

The Get-SCACUserRole cmdlet gets user roles on the App Controller server.

Parameters

-Managed

Indicates that only managed user roles are returned.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of a user role.

Aliases

none

Required?

false

Position?

named

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.

  • System.Management.Automation.SwitchParameter, System.Management.Automation.SwitchParameter

Outputs

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

  • Microsoft.SystemCenter.CloudManager.PowerShell.ACUserRole

Examples

Example 1: Get all managed user roles

This command gets all managed App Controller user roles on the App Controller server, and displays information about each user role to the user.

PS C:\> Get-SCACUserRole -Managed

Example 2: Get a user role by name

This command gets the user role named “UserRole01”.

PS C:\> Get-SCACUserRole –Name “UserRole01”

New-SCACUserRole

Set-SCACUserRole