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
このコマンドレットがユーザー ロールクォータを取得するプライベート クラウド オブジェクトを指定します。
| 型: | Cloud |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
| 型: | UserRole |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-QuotaPerUser
このコマンドレットがユーザー レベルのクォータまたはメンバー レベルのクォータを取得するかどうかを示します。 メンバー レベルのクォータを取得するには、$Trueの値を指定します。 ロール レベルのクォータを取得するには、$Falseの値を指定します。 このパラメーターを指定しない場合、コマンドレットは両方の種類のクォータを返します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UserRole
このコマンドレットがユーザー ロール クォータを取得するユーザー ロール オブジェクトを指定します。
| 型: | UserRole |
| 配置: | 0 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMMServer
このコマンドレットがユーザー ロールクォータを取得する VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
UserRoleQuota
このコマンドレットは、UserRoleQuota オブジェクトを返します。