Set-SCUserRoleQuota

Modifica as configurações de uma cota de função de usuário.

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

O cmdlet Set-SCUserRoleQuota modifica as configurações de uma cota de função de usuário do VMM (Virtual Machine Manager).

Exemplos

Exemplo 1: aumentar a cota de máquinas virtuais

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}

O primeiro comando obtém a nuvem chamada Cloud01 e armazena esse objeto na variável $Cloud.

O segundo comando obtém a função de usuário chamada ContosoSelfServiceUsers e armazena esse objeto na variável $Role.

O terceiro comando obtém a cota de função de usuário para a nuvem armazenada em $Cloud e função de usuário armazenada em $Role. Como o parâmetro QuotaPerUser tem um valor de $False, o comando obtém a cota para a função de usuário.

O quarto comando exibe a cota de contagem de máquinas virtuais.

O comando final determina se a cota da máquina virtual é menor que 20. Se for, define a cota como 20.

Parâmetros

-Cloud

Especifica um objeto de nuvem privada no qual esse cmdlet modifica as cotas de função de usuário.

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

-CPUCount

Especifica o número de CPUs virtuais para uma cota de função de usuário.

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

-CustomQuotaCount

Especifica o número de pontos de cota personalizados para uma cota de função de usuário.

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

-JobGroup

Especifica um identificador para uma série de comandos que são executados como um conjunto pouco antes do comando final que inclui a mesma execução do identificador do grupo de trabalho.

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

-JobVariable

Especifica uma variável na qual o progresso do trabalho é rastreado e armazenado.

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

-MemoryMB

Especifica a quantidade de memória, em megabytes (MB), para uma cota de função de usuário.

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

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

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

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole . Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

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

-PROTipID

Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

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

-QuotaPerUser

Indica que isso define cotas de nível de membro. Especificar $False indica cotas de nível de função. Se o parâmetro não for usado, ambas as cotas serão definidas ou retornadas.

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

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.

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

-StorageGB

Especifica a quantidade de armazenamento, em gigabytes (GB), para uma cota de função de usuário. Esse valor de armazenamento não inclui o armazenamento de biblioteca.

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

-UseCPUCountMaximum

Indica que o número máximo de CPUs virtuais é permitido para uma função de usuário. Se você especificar esse parâmetro, o VMM não imporá uma cota de função de usuário para a dimensão da CPU virtual.

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

-UseCustomQuotaCountMaximum

Indica que o número máximo de pontos de cota personalizados é permitido para uma função de usuário. Se você especificar esse parâmetro, o VMM não imporá uma cota de função de usuário para a dimensão de cota personalizada.

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

-UseMaximumQuota

Indica que todas as dimensões de cota são definidas como máximas. Se você especificar esse parâmetro, o VMM não imporá cotas de função de usuário.

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

-UseMemoryMBMaximum

Indica que a quantidade máxima de memória, em megabytes, é permitida para uma função de usuário. Se você especificar esse parâmetro, o VMM não imporá uma cota de função de usuário para a dimensão de memória.

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

-UserRoleQuota

Especifica um objeto de cota de função de usuário.

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

-UseStorageGBMaximum

Indica que a quantidade máxima de armazenamento, em gigabytes, é permitida para uma função de usuário. Se você especificar esse parâmetro, o VMM não imporá uma cota de função de usuário para a dimensão de armazenamento.

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

-UseVMCountMaximum

Indica que o número máximo de máquinas virtuais é permitido para uma função de usuário. Se você especificar o parâmetro, o VMM não imporá uma cota de função de usuário para a dimensão da máquina virtual.

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

-VMCount

Especifica o número de máquinas virtuais para uma cota de função de usuário.

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

-VMMServer

Especifica um servidor VMM no qual esse cmdlet modifica uma cota de função de usuário.

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

Saídas

UserRoleQuota

Este cmdlet retorna um objeto UserRoleQuota .