Add-SCACUserRoleScope

Adds connection cloud objects to the scope of objects that a user role can manage.

Parameter Set: AzureScope
Add-SCACUserRoleScope [-UserRole] <ACUserRole> [-AzureSubscriptionScope] <ACAzureSubscriptionCloud> [ <CommonParameters>]

Parameter Set: SPFScope
Add-SCACUserRoleScope [-UserRole] <ACUserRole> [-ServiceProviderConnectionScope] <ACCloudSystem> [-VmmUserRoleName] <String> [ <CommonParameters>]

The Add-SCACUserRoleScope function adds connection cloud objects to the scope of objects that a user role can manage. This cmdlet only works with Virtual Machine Manager (VMM) clouds.

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

Specifies a cloud system object. To retrieve a cloud system object, use the Get-SCACCloudSystem cmdlet.

Specifies a user role object. To retrieve a user role, use the Get-SCACUserRole cmdlet.

Specifies the name of a Virtual Machine Manager (VMM) user role.

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

The input type is the type of the objects that you can pipe to the cmdlet.

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

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 system object named SvcProvider01.Contoso.com and stores the object in the $CloudSystem variable.

The last command adds the cloud system stored in $CloudSystem to the scope of UserRole01.

PS C:\> $UserRole = Get-SCACUserRole -Managed | where {$_.Name -eq "UserRole01"}
PS C:\> $CloudSystem = Get-SCACCloudSystem -Name "SvcProvider01.Contoso.com"
PS C:\> Add-SCACUserRoleScope -UserRole $UserRole -ServiceProviderConnectionScope $CloudSystem -VMMUserRoleName "TenantSSUserRole01"

Remove-SCACUserRoleScope