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 VMM-Benutzerrollenkontingent (Virtual Machine Manager).
Beispiele
Beispiel 1: Erhöhen des Kontingents für die Anzahl virtueller 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 variablen $Cloud.
Der zweite Befehl ruft die Benutzerrolle "ContosoSelfServiceUsers" ab und speichert dieses Objekt dann in der variablen $Role.
Der dritte Befehl ruft das Benutzerrollenkontingent für die Cloud ab, die in $Cloud und in $Role gespeicherten Benutzerrolle 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 virtueller Computer an.
Der letzte Befehl bestimmt, ob das Kontingent des virtuellen Computers kleiner als 20 ist. Wenn dies der Grund ist, wird das Kontingent auf 20 festgelegt.
Parameter
-Cloud
Gibt ein privates Cloudobjekt an, in dem dieses Cmdlet Benutzerrollenkontingente ändert.
| Typ: | Cloud |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CPUCount
Gibt die Anzahl der virtuellen CPUs für ein Benutzerrollenkontingent an.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CustomQuotaCount
Gibt die Anzahl der benutzerdefinierten Kontingentpunkte für ein Benutzerrollenkontingent an.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-JobGroup
Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.
| Typ: | Guid |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-JobVariable
Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MemoryMB
Gibt die Arbeitsspeichermenge in Megabyte (MB) für ein Benutzerrollenkontingent an.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OnBehalfOfUser
Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | UserRole |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PROTipID
Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.
| Typ: | Guid |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-QuotaPerUser
Gibt an, dass dadurch Kontingente auf Memberebene festgelegt werden. Gibt $False an, dass Kontingente auf Rollenebene angegeben werden. Wenn der Parameter nicht verwendet wird, werden beide Kontingente festgelegt oder zurückgegeben.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-StorageGB
Gibt die Speichermenge in Gigabyte (GB) für ein Benutzerrollenkontingent an. Dieser Speicherbetrag enthält keinen Bibliotheksspeicher.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseCustomQuotaCountMaximum
Gibt an, dass die maximale Anzahl von benutzerdefinierten Kontingentpunkten für eine Benutzerrolle zulässig ist. Wenn Sie diesen Parameter angeben, erzwingt VMM kein Benutzerrollenkontingent für die benutzerdefinierte Kontingentdimension.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseMaximumQuota
Gibt an, dass alle Kontingentabmessungen auf maximal festgelegt sind. Wenn Sie diesen Parameter angeben, erzwingt VMM keine Benutzerrollenkontingente.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseMemoryMBMaximum
Gibt an, dass die maximale Arbeitsspeichermenge in Megabyte für eine Benutzerrolle zulässig ist. Wenn Sie diesen Parameter angeben, erzwingt VMM kein Benutzerrollenkontingent für die Speicherdimension.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserRoleQuota
Gibt ein Benutzerrollenkontingentobjekt an.
| Typ: | UserRoleQuota |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseVMCountMaximum
Gibt an, dass die maximale Anzahl virtueller Computer für eine Benutzerrolle zulässig ist. Wenn Sie einen Parameter angeben, erzwingt VMM kein Benutzerrollenkontingent für die Dimension des virtuellen Computers.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-VMCount
Gibt die Anzahl der virtuellen Computer für ein Benutzerrollenkontingent an.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-VMMServer
Gibt einen VMM-Server an, auf dem dieses Cmdlet ein Benutzerrollenkontingent ändert.
| Typ: | ServerConnection |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Ausgaben
UserRoleQuota
Dieses Cmdlet gibt ein UserRoleQuota--Objekt zurück.