Get-SCUserRoleQuota
ユーザー ロールクォータを取得します。
構文
Get-SCUserRoleQuota
[-VMMServer <ServerConnection>]
[[-UserRole] <UserRole>]
[-QuotaPerUser <Boolean>]
[-Cloud <Cloud>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] 説明
Get-SCUserRoleQuota コマンドレットは、Virtual Machine Manager (VMM) ユーザー ロール クォータ オブジェクトを取得します。
このコマンドレットは、プライベート クラウドごとにセルフサービス ユーザー ロールの 2 つのユーザー ロール クォータ オブジェクトを返します。 1 つのオブジェクトには、ロール レベルのクォータに関する情報が含まれています。 もう 1 つのオブジェクトには、メンバー レベルのクォータに関する情報が含まれています。 QuotaPerUser コマンドレットに$Trueの値を指定して、メンバー レベルのクォータ オブジェクトのみを返します。 コマンドレットの$Falseの値を指定して、ロール レベルのクォータ オブジェクトのみを返します。
例
例 1: ユーザーごとの仮想マシン数クォータを取得する
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最初のコマンドは、Cloud01 という名前のプライベート クラウド オブジェクトを取得し、そのオブジェクトを $Cloud 変数に格納します。
2 番目のコマンドは、ContosoSelfServiceUsers という名前のユーザー ロール オブジェクトを取得し、そのオブジェクトを$Role変数に格納します。
3 番目のコマンドは、$Cloudに格納されているプライベート クラウドと、$Roleに格納されているユーザー ロールのユーザー ロール クォータを取得します。 QuotaPerUser パラメーターの値は $True であるため、このコマンドはメンバーのクォータを取得します。
最後のコマンドでは、仮想マシンの数クォータが表示されます。
パラメーター
-Cloud
このコマンドレットがユーザー ロール クォータを取得するプライベート クラウド オブジェクトを指定します。
| Type: | Cloud |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーの代わりに動作します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールの代わりに動作します。
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QuotaPerUser
このコマンドレットがユーザー レベルのクォータまたはメンバー レベルのクォータを取得するかどうかを示します。 メンバー レベルのクォータを取得するには、$Trueの値を指定します。 ロール レベルのクォータを取得するには、$Falseの値を指定します。 このパラメーターを指定しない場合、コマンドレットは両方の種類のクォータを返します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRole
このコマンドレットがユーザー ロール クォータを取得するユーザー ロール オブジェクトを指定します。
| Type: | UserRole |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
このコマンドレットがユーザー ロール クォータを取得する VMM サーバー オブジェクトを指定します。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
出力
UserRoleQuota
このコマンドレットは 、UserRoleQuota オブジェクトを返します。