Add-SCACUserRoleScope

Article
03/29/2012

Applies To: System Center 2012 - App Controller

Add-SCACUserRoleScope

Adds Windows Azure subscription cloud objects to the scope of objects that a user role can manage.

Syntax

Parameter Set: __AllParameterSets
Add-SCACUserRoleScope [-UserRole] <ACUserRole> [-Scope] <ACAzureSubscriptionCloud> [ <CommonParameters>]

Detailed Description

The Add-SCACUserRoleScope function adds Windows Azure subscription cloud objects to the scope of objects that a user role can manage.

Parameters

-Scope<ACAzureSubscriptionCloud>

Specifies a Windows Azure subscription cloud object. To retrieve a cloud object, use the Get-SCACCloud cmdlet.

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-UserRole<ACUserRole>

Specifies a user role object. 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 gets the cloud object named AzureSubscription01 and stores the object in the $Scope variable.

The last command adds the cloud stored in $Scope to the user role stored in $UserRole.

PS C:\> $UserRole = Get-SCACUserRole –Managed | where { $_.Name –eq “UserRole01” }
PS C:\> $Scope = Get-SCACCloud | where { $_.Name –eq “AzureSubscription01” }
PS C:\> Add-SCACUserRoleScope -UserRole $UserRole -Scope $Scope

Add-SCACUserRoleScope