New-SCACUserRole

Applies To: System Center 2012 R2 App Controller

New-SCACUserRole

Creates a user role in App Controller.

Syntax

Parameter Set: Default
New-SCACUserRole [-Name] <String> [[-Description] <String> ] [[-IsReadOnly] <Boolean> ] [ <CommonParameters>]

Detailed Description

The New-SCACUserRole cmdlet creates a user role in App Controller. This cmdlet creates the user role and allows you to set it as read-only. To add or remove members or scope from the user role, use the Set-SCACUserRole cmdlet. The user role is not added to App Controller until you have set the user role.

Parameters

-Description<String>

Provides a description of the user role.

-IsReadOnly<Boolean>

Determines whether the user role is read only.

-Name<String>

Specifies a name for the user role.

<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: Create a user role

This command creates a user role named UserRole01 and stores the user role object in the $UserRole01 variable.

PS C:\> $UserRole01 = New-SCACUserRole -Name "UserRole01" -Description "First user role"

Example 2: Create a read-only user role

This command creates a read-only user role named UserRole02 and stores the user role object in the $UserRole02 variable.

PS C:\> $UserRole02 = New-SCACUserRole -Name "UserRole02" -Description "Read-only user role" -IsReadOnly $True

Related topics

Get-SCACUserRole

Set-SCACUserRole