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 ruft Benutzerrollenkontingentobjekte (Virtual Machine Manager, VMM) ab.

Dieses Cmdlet gibt zwei Benutzerrollenkontingentobjekte für eine Self-Service-Benutzerrolle pro private Cloud zurück. Ein Objekt enthält Informationen zum Kontingent 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 Memberebene 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 virtuelle 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 namens Cloud01 ab und speichert dieses Objekt dann in der $Cloud Variablen.

Der zweite Befehl ruft das Benutzerrollenobjekt "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 gespeicherten 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 virtueller Computer an.

Parameter

-Cloud

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

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen 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. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen 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

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

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

-UserRole

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

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

-VMMServer

Gibt ein VMM-Serverobjekt an, auf dem dieses Cmdlet Benutzerrollenkontingente abruft.

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

Ausgaben

UserRoleQuota

Dieses Cmdlet gibt ein UserRoleQuota-Objekt zurück .