Get-SCACUserRole

Applies To: System Center 2012 - App Controller

Get-SCACUserRole

Gets the user roles on an App Controller server.

Syntax

Parameter Set: __AllParameterSets
Get-SCACUserRole [-ACServer <ACServer> ] [ <CommonParameters>]

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

Parameter Set: MyRoles
Get-SCACUserRole -MyRoles [ <CommonParameters>]

Detailed Description

The Get-SCACUserRole cmdlet gets the user roles on a System Center 2012 - App Controller server.

Parameters

-ACServer<ACServer>

Specifies an App Controller server object. To retrieve an App Controller server object, use the Get-SCACServer cmdlet.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Managed

Indicates that only managed user roles are returned.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MyRoles

Indicates that the user roles of which the logged-in user is a member are returned.

Aliases

none

Required?

true

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 --------------------------

Description

-----------

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 --------------------------

Description

-----------

This command gets all App Controller user roles that the current user is a member of, and displays information about each user role to the user.

PS C:\> Get-SCACUserRole -MyRoles