Export (0) Print
Expand All
Expand Minimize

Get-SCUserRoleQuota

Updated: April 1, 2012

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 $TruePS C:\> Write-Output $Quota.VMCount

Related topics

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft