Freigeben über

Get-SCUserRoleQuota

  • Referenz
Modul:
VirtualMachineManager

Ruft ein Benutzerrollenkontingent ab.

Syntax

Get-SCUserRoleQuota
   [-VMMServer <ServerConnection>]
   [[-UserRole] <UserRole>]
   [-QuotaPerUser <Boolean>]
   [-Cloud <Cloud>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-SCUserRoleQuota Cmdlet ruft VMM-Benutzerrollenkontingentobjekte (Virtual Machine Manager) ab.

Dieses Cmdlet gibt zwei Benutzerrollenkontingentobjekte für eine Self-Service-Benutzerrolle pro private Cloud zurück. Ein Objekt enthält Informationen zum Rollenkontingent auf Rollenebene. Das andere Objekt enthält Informationen zum Kontingent auf Memberebene. Geben Sie einen Wert von $True für das Cmdlet QuotaPerUser an, um nur das Kontingentobjekt auf Elementebene zurückzugeben. Geben Sie einen Wert von $False für das Cmdlet an, um nur das Kontingentobjekt auf Rollenebene zurückzugeben.

Beispiele

Beispiel 1: Abrufen des Kontingents für die Anzahl der virtuellen Computer pro Benutzer

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

Der erste Befehl ruft das private Cloudobjekt "Cloud01" ab und speichert dieses Objekt dann in der $Cloud Variablen.

Der zweite Befehl ruft das Benutzerrollenobjekt namens ContosoSelfServiceUsers ab und speichert dieses Objekt dann in der $Role Variablen.

Der dritte Befehl ruft das Benutzerrollenkontingent für die private Cloud ab, die in $Cloud und in $Role gespeicherte Benutzerrolle gespeichert ist. Da der parameter QuotaPerUser einen Wert von $True hat, ruft dieser Befehl das Kontingent für Mitglieder ab.

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

Parameter

-Cloud

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

Typ:Cloud
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

-QuotaPerUser

Gibt an, ob dieses Cmdlet Kontingente auf Benutzerebene oder Kontingente auf Memberebene abruft. Geben Sie einen Wert von $True an, um Kontingente auf Memberebene abzurufen. Geben Sie einen Wert von $False an, um Kontingente auf Rollenebene abzurufen. Wenn Sie diesen Parameter nicht angeben, gibt das Cmdlet beide Arten von Kontingenten zurück.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserRole

Gibt ein Benutzerrollenobjekt an, für das dieses Cmdlet Benutzerrollenkontingente abruft.

Typ:UserRole
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an, für das dieses Cmdlet Benutzerrollenkontingente abruft.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

UserRoleQuota

Dieses Cmdlet gibt ein UserRoleQuota--Objekt zurück.