New-SCACUserRoleScope
Applies To: System Center 2012 R2 App Controller
New-SCACUserRoleScope
Creates a user role scope object.
Syntax
Parameter Set: Azure
New-SCACUserRoleScope [-AzureCloud] <ACAzureSubscriptionCloud[]> [ <CommonParameters>]
Parameter Set: SPF
New-SCACUserRoleScope [-SPFCloudSystem] <ACCloudSystem> [-VMMUserRoleName] <String> [ <CommonParameters>]
Detailed Description
The New-SCACUserRoleScope cmdlet creates a user role scope object that you can use to add scope to a user role.
Parameters
-AzureCloud<ACAzureSubscriptionCloud[]>
Specifies a Windows Azure subscription object. To get a Windows Azure subscription object, use the Get-SCACAzureSubscription cmdlet.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-SPFCloudSystem<ACCloudSystem>
Specifies a Service Provider Foundation cloud system object. To get a cloud system object, use the Get-SCACCloudSystem 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 user role.
Aliases |
none |
Required? |
true |
Position? |
2 |
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.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Create a user role scope object by using a Windows Azure subscription
The first command gets the Windows Azure subscription object named AzureSubscription01 and stores the object in the $Subscription variable.
The second command creates a user role scope that includes the Windows Azure subscription stored in $Subscription and then stores the user role scope in the $UserRoleScope01 variable.
PS C:\> $Subscription = Get-SCACAzureSubscription -Name "AzureSubscription01"
PS C:\> $UserRoleScope01 = New-SCACUserRoleScope -AzureCloud $Subscription