Freigeben über


Set-SCUserRoleQuota

Ändert die Einstellungen für ein Benutzerrollenkontingent.

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

Beschreibung

Das Cmdlet Set-SCUserRoleQuota ändert die Einstellungen für ein Benutzerrollenkontingent für virtual Machine Manager (VMM).

Beispiele

Beispiel 1: Erhöhen des Kontingents für virtuelle Computer

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}

Der erste Befehl ruft die Cloud mit dem Namen Cloud01 ab und speichert dieses Objekt dann in der $Cloud Variablen.

Der zweite Befehl ruft die Benutzerrolle "ContosoSelfServiceUsers" ab und speichert dieses Objekt dann in der $Role Variablen.

Der dritte Befehl ruft das In $Cloud gespeicherte Benutzerrollenkontingent für die Cloud ab, die in $Role gespeichert ist. Da der Parameter "QuotaPerUser " einen Wert von $False hat, ruft der Befehl das Kontingent für die Benutzerrolle ab.

Der vierte Befehl zeigt das Kontingent für die Anzahl der virtuellen Computer an.

Der endgültige Befehl bestimmt, ob das Kontingent des virtuellen Computers kleiner als 20 ist. Wenn es sich handelt, legt sie das Kontingent auf 20 fest.

Parameter

-Cloud

Gibt ein privates Cloudobjekt an, in dem dieses Cmdlet Benutzerrollenkontingente ändert.

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

-CPUCount

Gibt die Anzahl der virtuellen CPUs für ein Benutzerrollenkontingent an.

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

-CustomQuotaCount

Gibt die Anzahl der benutzerdefinierten Kontingentpunkte für ein Benutzerrollenkontingent an.

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

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem letzten Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.

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

-JobVariable

Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.

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

-MemoryMB

Gibt den Arbeitsspeicher in Megabyte (MB) für ein Benutzerrollenkontingent an.

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

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

-PROTipID

Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

-QuotaPerUser

Gibt an, dass diese Kontingente auf Memberebene festgelegt werden. Die Angabe $False gibt Rollenebenenkontingente an. Wenn der Parameter nicht verwendet wird, werden beide Kontingente festgelegt oder zurückgegeben.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-StorageGB

Gibt die Speichermenge in Gigabyte (GB) für ein Benutzerrollenkontingent an. Dieser Speicherbetrag umfasst keinen Bibliotheksspeicher.

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

-UseCPUCountMaximum

Gibt an, dass die maximale Anzahl virtueller CPUs für eine Benutzerrolle zulässig ist. Wenn Sie diesen Parameter angeben, erzwingt VMM kein Benutzerrollenkontingent für die virtuelle CPU-Dimension.

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

-UseCustomQuotaCountMaximum

Gibt an, dass die maximale Anzahl benutzerdefinierter Kontingentpunkte für eine Benutzerrolle zulässig ist. Wenn Sie diesen Parameter angeben, erzwingt VMM kein Benutzerrollenkontingent für die benutzerdefinierte Kontingentdimension.

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

-UseMaximumQuota

Gibt an, dass alle Kontingentdimensionen auf maximal festgelegt sind. Wenn Sie diesen Parameter angeben, erzwingt VMM keine Benutzerrollenkontingente.

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

-UseMemoryMBMaximum

Gibt an, dass die maximale Speichermenge in Megabyte für eine Benutzerrolle zulässig ist. Wenn Sie diesen Parameter angeben, erzwingt VMM kein Benutzerrollenkontingent für die Speicherdimension.

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

-UserRoleQuota

Gibt ein Benutzerrollenkontingentobjekt an.

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

-UseStorageGBMaximum

Gibt an, dass die maximale Speichermenge in Gigabyte für eine Benutzerrolle zulässig ist. Wenn Sie diesen Parameter angeben, erzwingt VMM kein Benutzerrollenkontingent für die Speicherdimension.

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

-UseVMCountMaximum

Gibt an, dass die maximale Anzahl virtueller Computer für eine Benutzerrolle zulässig ist. Wenn Sie parameter angeben, erzwingt VMM kein Benutzerrollenkontingent für die virtuelle Computerdimension.

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

-VMCount

Gibt die Anzahl der virtuellen Computer für ein Benutzerrollenkontingent an.

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

-VMMServer

Gibt einen VMM-Server an, auf dem dieses Cmdlet ein Benutzerrollenkontingent ändert.

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

Ausgaben

UserRoleQuota

Dieses Cmdlet gibt ein UserRoleQuota-Objekt zurück.