Set-SCUserRoleQuota

Modifie les paramètres d’un quota de rôle d’utilisateur.

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

L’applet de commande Set-SCUserRoleQuota modifie les paramètres d’un quota de rôle d’utilisateur VMM (Virtual Machine Manager).

Exemples

Exemple 1 : Augmenter le quota de nombre de machines virtuelles

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}

La première commande obtient le cloud nommé Cloud01, puis stocke cet objet dans la variable $Cloud.

La deuxième commande obtient le rôle d’utilisateur nommé ContosoSelfServiceUsers, puis stocke cet objet dans la variable $Role.

La troisième commande obtient le quota de rôle d’utilisateur pour le cloud stocké dans $Cloud et le rôle d’utilisateur stocké dans $Role. Étant donné que le paramètre QuotaPerUser a la valeur $False, la commande obtient le quota pour le rôle d’utilisateur.

La quatrième commande affiche le quota de nombre de machines virtuelles.

La commande finale détermine si le quota de machine virtuelle est inférieur à 20. Si c’est le cas, il définit le quota sur 20.

Paramètres

-Cloud

Spécifie un objet de cloud privé dans lequel cette applet de commande modifie les quotas de rôle d’utilisateur.

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

-CPUCount

Spécifie le nombre de processeurs virtuels pour un quota de rôles d’utilisateur.

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

-CustomQuotaCount

Spécifie le nombre de points de quota personnalisés pour un quota de rôle d’utilisateur.

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

-JobGroup

Spécifie un identificateur pour une série de commandes qui s’exécute en tant que jeu juste avant la commande finale qui inclut le même identificateur de groupe de travaux.

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

-JobVariable

Spécifie une variable dans laquelle la progression du travail est suivie et stockée.

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

-MemoryMB

Spécifie la quantité de mémoire, en mégaoctets (Mo), pour un quota de rôle d’utilisateur.

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

-OnBehalfOfUser

Spécifie un nom d'utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur spécifié par ce paramètre.

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

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

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

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.

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

-QuotaPerUser

Indique que cela définit des quotas de niveau membre. La spécification de $False indique les quotas au niveau du rôle. Si le paramètre n’est pas utilisé, les deux quotas sont définis ou retournés.

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

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-StorageGB

Spécifie la quantité de stockage, en gigaoctets (Go), pour un quota de rôle d’utilisateur. Cette quantité de stockage n’inclut pas le stockage de bibliothèque.

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

-UseCPUCountMaximum

Indique que le nombre maximal de processeurs virtuels est autorisé pour un rôle d’utilisateur. Si vous spécifiez ce paramètre, VMM n’applique pas de quota de rôle d’utilisateur pour la dimension de processeur virtuel.

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

-UseCustomQuotaCountMaximum

Indique que le nombre maximal de points de quota personnalisés est autorisé pour un rôle d’utilisateur. Si vous spécifiez ce paramètre, VMM n’applique pas de quota de rôle d’utilisateur pour la dimension de quota personnalisée.

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

-UseMaximumQuota

Indique que toutes les dimensions de quota sont définies sur maximum. Si vous spécifiez ce paramètre, VMM n’applique pas les quotas de rôle d’utilisateur.

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

-UseMemoryMBMaximum

Indique que la quantité maximale de mémoire, en mégaoctets, est autorisée pour un rôle d’utilisateur. Si vous spécifiez ce paramètre, VMM n’applique pas de quota de rôle d’utilisateur pour la dimension de mémoire.

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

-UserRoleQuota

Spécifie un objet de quota de rôle d’utilisateur.

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

-UseStorageGBMaximum

Indique que la quantité maximale de stockage, en gigaoctets, est autorisée pour un rôle d’utilisateur. Si vous spécifiez ce paramètre, VMM n’applique pas de quota de rôle d’utilisateur pour la dimension de stockage.

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

-UseVMCountMaximum

Indique que le nombre maximal de machines virtuelles est autorisé pour un rôle d’utilisateur. Si vous spécifiez un paramètre, VMM n’applique pas de quota de rôle d’utilisateur pour la dimension de machine virtuelle.

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

-VMCount

Spécifie le nombre de machines virtuelles pour un quota de rôle d’utilisateur.

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

-VMMServer

Spécifie un serveur VMM sur lequel cette applet de commande modifie un quota de rôle d’utilisateur.

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

Sorties

UserRoleQuota

Cette applet de commande retourne un objet UserRoleQuota .