Set-SCUserRoleQuota
ユーザー ロール クォータの設定を変更します。
構文
Set-SCUserRoleQuota
[-VMMServer <ServerConnection>]
-UserRoleQuota <UserRoleQuota>
[-CPUCount <Int32>]
[-CustomQuotaCount <Int32>]
[-MemoryMB <Int32>]
[-StorageGB <Int32>]
[-VMCount <Int32>]
[-UseCPUCountMaximum]
[-UseCustomQuotaCountMaximum]
[-UseMemoryMBMaximum]
[-UseStorageGBMaximum]
[-UseVMCountMaximum]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCUserRoleQuota
[-VMMServer <ServerConnection>]
[-UserRoleQuota <UserRoleQuota>]
[-UseMaximumQuota]
[-QuotaPerUser]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCUserRoleQuota
[-VMMServer <ServerConnection>]
-JobGroup <Guid>
-Cloud <Cloud>
[-CPUCount <Int32>]
[-CustomQuotaCount <Int32>]
[-MemoryMB <Int32>]
[-StorageGB <Int32>]
[-VMCount <Int32>]
[-UseCPUCountMaximum]
[-UseCustomQuotaCountMaximum]
[-UseMaximumQuota]
[-UseMemoryMBMaximum]
[-UseStorageGBMaximum]
[-UseVMCountMaximum]
[-QuotaPerUser]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
説明
Set-SCUserRoleQuota コマンドレットは、Virtual Machine Manager (VMM) ユーザー ロール クォータの設定を変更します。
例
例 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 $False
PS C:\> Write-Output $Quota.VMCount
PS C:\> if ($Quota.VMCount -lt 20) {Set-SCUserRoleQuota -UserRoleQuota $Quota -VMCount 20}
最初のコマンドは Cloud01 という名前のクラウドを取得し、そのオブジェクトを $Cloud 変数に格納します。
2 番目のコマンドは、ContosoSelfServiceUsers という名前のユーザー ロールを取得し、そのオブジェクトを $Role 変数に格納します。
3 番目のコマンドは、$Cloudに格納されているクラウドのユーザー ロール クォータと、$Roleに格納されているユーザー ロールを取得します。 QuotaPerUser パラメーターの値は $False であるため、コマンドはユーザー ロールのクォータを取得します。
4 番目のコマンドは、仮想マシンの数クォータを表示します。
最後のコマンドは、仮想マシンのクォータが 20 未満かどうかを判断します。 その場合は、クォータを 20 に設定します。
パラメーター
-Cloud
このコマンドレットがユーザー ロールのクォータを変更するプライベート クラウド オブジェクトを指定します。
型: | Cloud |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CPUCount
ユーザー ロール クォータの仮想 CPU の数を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CustomQuotaCount
ユーザー ロール クォータのカスタム クォータ ポイントの数を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-JobGroup
同じジョブ グループ識別子を含む最後のコマンドが実行される直前に、セットとして実行される一連のコマンドの識別子を指定します。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡して格納する変数を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MemoryMB
ユーザー ロールクォータのメモリ量をメガバイト (MB) 単位で指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
型: | UserRole |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-QuotaPerUser
メンバー レベルのクォータを設定することを示します。 $Falseを指定すると、ロール レベルのクォータが示されます。 パラメーターが使用されていない場合、両方のクォータが設定または返されます。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-StorageGB
ユーザー ロール クォータのストレージの量をギガバイト (GB) 単位で指定します。 このストレージ容量には、ライブラリ ストレージは含まれません。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UseCPUCountMaximum
ユーザー ロールに対して許可される仮想 CPU の最大数を示します。 このパラメーターを指定した場合、VMM は仮想 CPU ディメンションのユーザー ロール クォータを適用しません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UseCustomQuotaCountMaximum
ユーザー ロールに対してカスタム クォータ ポイントの最大数が許可されることを示します。 このパラメーターを指定した場合、VMM はカスタム クォータ ディメンションのユーザー ロール クォータを適用しません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UseMaximumQuota
すべてのクォータ ディメンションが最大に設定されていることを示します。 このパラメーターを指定した場合、VMM はユーザー ロールクォータを適用しません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UseMemoryMBMaximum
ユーザー ロールに対してメモリの最大量 (メガバイト単位) が許可されることを示します。 このパラメーターを指定した場合、VMM はメモリ ディメンションのユーザー ロール クォータを適用しません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserRoleQuota
ユーザー ロール クォータ オブジェクトを指定します。
型: | UserRoleQuota |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-UseStorageGBMaximum
ユーザー ロールに対してストレージの最大量 (ギガバイト単位) が許可されることを示します。 このパラメーターを指定した場合、VMM はストレージ ディメンションのユーザー ロール クォータを適用しません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UseVMCountMaximum
ユーザー ロールに対して許可される仮想マシンの最大数を示します。 パラメーターを指定した場合、VMM は仮想マシン ディメンションのユーザー ロール クォータを適用しません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMCount
ユーザー ロール クォータの仮想マシンの数を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMMServer
このコマンドレットがユーザー ロールクォータを変更する VMM サーバーを指定します。
型: | ServerConnection |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
出力
UserRoleQuota
このコマンドレットは、UserRoleQuota オブジェクトを返します。