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 .