Set-SCUserRoleQuota

模組:

VirtualMachineManager

修改使用者角色配額的設定。

Syntax

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>]

Description

Set-SCUserRoleQuota Cmdlet 會修改 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變數中。

第二個命令會取得名為 ContosoSelfServiceUsers 的使用者角色，然後將該物件儲存在$Role變數中。

第三個命令會取得儲存在 $Cloud 雲端的使用者角色配額，以及儲存在 $Role 中的使用者角色。 由於 QuotaPerUser 參數的值為 $False，所以命令會取得使用者角色的配額。

第四個命令會顯示虛擬機器計數配額。

最後一個命令會判斷虛擬機器配額是否小於 20。 如果是，則會將配額設定為 20。

參數

-Cloud

指定此 Cmdlet 修改使用者角色配額的私人雲端物件。

Type:	Cloud
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUCount

指定使用者角色配額的虛擬 CPU 數目。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomQuotaCount

指定使用者角色配額的自訂配額點數目。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JobGroup

指定一系列命令的識別碼，這些命令會在包含相同作業群組識別碼的執行的最後一個命令之前，以集合的形式執行。

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JobVariable

指定追蹤和儲存作業進度的變數。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MemoryMB

指定使用者角色配額的記憶體數量，以 MB 為單位 (MB) 。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OnBehalfOfUser

指定使用者名稱。 此 Cmdlet 代表此參數指定的使用者運作。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OnBehalfOfUserRole

指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 此 Cmdlet 代表此參數所指定的使用者角色運作。

Type:	UserRole
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PROTipID

指定觸發此動作之 PRO 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 PRO 秘訣。

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-QuotaPerUser

表示這會設定成員層級配額。 指定$False表示角色層級配額。 如果未使用 參數，則會設定或傳回這兩個配額。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsynchronously

表示作業會以非同步方式執行，讓控制項立即返回命令殼層。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageGB

指定使用者角色配額的儲存體數量，以 GB (GB) 為單位。 此儲存體數量不包含程式庫儲存體。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseCPUCountMaximum

表示使用者角色允許虛擬 CPU 數目上限。 如果您指定此參數，VMM 不會強制執行虛擬 CPU 維度的使用者角色配額。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseCustomQuotaCountMaximum

表示使用者角色允許自訂配額點的數目上限。 如果您指定此參數，VMM 不會強制執行自訂配額維度的使用者角色配額。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseMaximumQuota

表示所有配額維度都設定為最大值。 如果您指定此參數，VMM 不會強制執行使用者角色配額。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-UseMemoryMBMaximum

表示使用者角色允許記憶體數量上限，以 MB 為單位。 如果您指定此參數，VMM 不會強制執行記憶體維度的使用者角色配額。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserRoleQuota

指定使用者角色配額物件。

Type:	UserRoleQuota
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-UseStorageGBMaximum

表示使用者角色允許儲存體數量上限，以 GB 為單位。 如果您指定此參數，VMM 不會強制執行儲存體維度的使用者角色配額。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseVMCountMaximum

表示使用者角色允許虛擬機器數目上限。 如果您指定參數，VMM 不會強制執行虛擬機器維度的使用者角色配額。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMCount

指定使用者角色配額的虛擬機器數目。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMMServer

指定此 Cmdlet 修改使用者角色配額的 VMM 伺服器。

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸出

UserRoleQuota

此 Cmdlet 會傳回 UserRoleQuota 物件。

相關連結

• Get-SCCloud
• Get-SCUserRole
• Get-SCUserRoleQuota