Get-SCUserRoleQuota
Applies To: System Center 2012 - Virtual Machine Manager
Get-SCUserRoleQuota
Gets a user role quota object.
Syntax
Parameter Set: Default
Get-SCUserRoleQuota [[-UserRole] <UserRole> ] [-Cloud <Cloud> ] [-QuotaPerUser <Boolean> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]
Detailed Description
The Get-SCUserRoleQuota gets a System Center Virtual Machine Manager (VMM) user role quota object. Two user role quota objects are returned for a self-service user role per private cloud: one object contains information about the role-level quota, and the other object contains information about member-level quota. The QuotaPerUser property allows you to return just one of the objects. When QuotaPerUser is set to True, only the member-level quota object is returned. When set to False, only the role-level quota object is returned.
For more information about Get-SCUserRoleQuota, type: "Get-Help Get-SCUserRoleQuota -online".
Parameters
-Cloud<Cloud>
Specifies a private cloud object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-QuotaPerUser<Boolean>
Indicates whether the cmdlet sets or retrieves user level quotas or member level quotas. Specifying $True indicates member level quotas. Specifying $False indicates role level quotas. If the parameter is not used, both quotas are set or returned.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-UserRole<UserRole>
Specifies a user role object.
Aliases |
none |
Required? |
false |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-VMMServer<ServerConnection>
Specifies a VMM server object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
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.
- UserRoleQuota
Examples
1: Get per-user virtual machine count quota for a specific private cloud.
The first command gets the private cloud object named Cloud01 and stores the object in the $Cloud variable.
The second command gets the user role object named ContosoSelfServiceUsers and stores the object in the $Role variable.
The third command gets the user role quota for the private cloud stored in $Cloud (Cloud01) and user role stored in $Role (ContosoSelfServiceUsers). The QuotaPerUser parameter set to true indicates that the quota for members will be returned.
The last command displays the virtual machine count quota to the user.
PS C:\> $Cloud = Get-SCCloud -Name "Cloud01"
PS C:\> $Role = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> $Quota = Get-SCUserRoleQuota -Cloud $Cloud -UserRole $Role -QuotaPerUser $True
PS C:\> Write-Output $Quota.VMCount