Add-SCACUserRoleScope
Add-SCACUserRoleScope
Adds connection cloud objects to the scope of objects that a user role can manage.
Syntax
Parameter Set: AzureScope
Add-SCACUserRoleScope [-UserRole] <ACUserRole> [-AzureSubscriptionScope] <ACAzureSubscriptionCloud> [ <CommonParameters>]
Parameter Set: SPFScope
Add-SCACUserRoleScope [-UserRole] <ACUserRole> [-ServiceProviderConnectionScope] <ACCloudSystem> [-VmmUserRoleName] <String> [ <CommonParameters>]
Detailed Description
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.
Parameters
-AzureSubscriptionScope<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 |
-ServiceProviderConnectionScope<ACCloudSystem>
Specifies a cloud system object. To retrieve a cloud system object, use the Get-SCACCloudSystem 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 |
-VmmUserRoleName<String>
Specifies the name of a Virtual Machine Manager (VMM) user role.
Aliases |
none |
Required? |
true |
Position? |
3 |
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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
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 --------------------------
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"