Citrix Virtual Apps and Desktops

Comandos do SDK do PowerShell do Broker

January 23, 2026

Contribuição de:

Você pode configurar o Autoscale para grupos de entrega usando o SDK do PowerShell do Broker. Para configurar o Autoscale com comandos do PowerShell, você deve usar a versão 7.21.0.12 ou posterior do SDK do PowerShell. Para mais informações sobre os SDKs do PowerShell, consulte SDKs e APIs.

Set-BrokerDesktopGroup

Desabilita ou habilita um BrokerDesktopGroup existente ou altera suas configurações. Para mais informações sobre este cmdlet, consulte https://citrix.github.io/delivery-controller-sdk/Broker/Set-BrokerDesktopGroup/.

Exemplos

Consulte os exemplos a seguir para obter detalhes sobre como usar os cmdlets do PowerShell.

Habilitar o Autoscale™

Suponha que você queira habilitar o Autoscale para o grupo de entrega cujo nome é “MyDesktop”. Use o comando do PowerShell Set-BrokerDesktopGroup. Por exemplo:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -AutoscalingEnabled $true

Configurar o buffer de capacidade separadamente para horários de pico e fora de pico

Suponha que você queira definir o buffer de capacidade para 20% para horários de pico e 10% para horários fora de pico para um grupo de entrega cujo nome é “MyDesktop”. Use o comando do PowerShell Set-BrokerDesktopGroup. Por exemplo:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakBufferSizePercent 20 -OffPeakBufferSizePercent 10

Configurar a definição de tempo limite de desconexão

Suponha que você queira definir o valor de tempo limite de desconexão para 60 minutos para horários de pico e 30 minutos para horários fora de pico para um grupo de entrega cujo nome é “MyDesktop”. Use o comando do PowerShell Set-BrokerDesktopGroup. Por exemplo:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakDisconnectTimeout 60 -OffPeakDisconnectTimeout 30

Configurar a definição de tempo limite de logoff

Suponha que você queira definir o valor de tempo limite de logoff para 60 minutos para horários de pico e 30 minutos para horários fora de pico para um grupo de entrega cujo nome é “MyDesktop”. Use o comando do PowerShell Set-BrokerDesktopGroup. Por exemplo:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakLogOffTimeout 60 -OffPeakLogOffTimeout 30

Configurar a definição de atraso de desligamento

Suponha que você queira definir o atraso de desligamento para 15 minutos para um grupo de entrega cujo nome é “MyDesktop”. Use o comando do PowerShell Set-BrokerDesktopGroup. Por exemplo:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PowerOffDelay 15

Configurar um período de tempo durante o qual o atraso de desligamento não entra em vigor

Suponha que você queira que o atraso de desligamento entre em vigor até que 30 minutos tenham decorrido para um grupo de entrega cujo nome é “MyDesktop”. Use o comando do PowerShell Set-BrokerDesktopGroup. Por exemplo:
- C:\PS> Set-BrokerDesktopGroup "MyDesktop" -SettlementPeriodBeforeAutoShutdown 30.

Configurar a definição de custo da instância da máquina

Suponha que você queira definir o custo da instância da máquina por hora para 0,2 dólares para um grupo de entrega cujo nome é “MyDesktop”. Use o comando do PowerShell Set-BrokerDesktopGroup. Por exemplo:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -MachineCost 0.2

Excluir VMs em modo de manutenção do pool do autoscale

Considere um grupo de entrega com 10 máquinas, das quais 2 máquinas estão em modo de manutenção. A capacidade do buffer do Autoscale é definida como 50%. Suponha que você queira excluir as VMs em modo de manutenção do pool do autoscale, então defina PoolSizeExcludesMaintenanceMode como True. O Autoscale então inicia 4 máquinas, pois as 2 máquinas em modo de manutenção não estão incluídas no pool de máquinas. Use o comando do PowerShell Set-BrokerDesktopGroup. Por exemplo:
- PS C:\> Set-BrokerDesktopGroup -PoolSizeExcludesMaintenanceMode $true
O valor padrão para PoolSizeExcludesMaintenanceMode para os grupos de entrega de sessão única é False.

O valor padrão para PoolSizeExcludesMaintenanceMode para os grupos de entrega de múltiplas sessões é True.

New-BrokerPowerTimeScheme

Cria um BrokerPowerTimeScheme para um grupo de entrega. Para mais informações, consulte https://citrix.github.io/delivery-controller-sdk/Broker/New-BrokerPowerTimeScheme/.

Exemplo

Suponha que você queira criar um esquema de tempo de energia para um grupo de entrega cujo valor UID é 3. O novo esquema abrange o fim de semana, segunda-feira e terça-feira. O período das 8:00 AM às 6:30 PM é definido como horários de pico para os dias incluídos no esquema. Para horários de pico, o tamanho do pool (o número de máquinas mantidas ligadas) é 20. Para horários fora de pico, é 5. Você pode usar o comando do PowerShell Set-BrokerDesktopGroup. Por exemplo:

PS C:\> $ps48=(0..47 | %{ if ($_ -lt 16 -or $_ -gt 37) { 5 } else { 20 } } )
PS C:\> $pt48=(0..47 | %{ if ($_ -lt 16 -or $_ -gt 37) { $false } else { $true } } )
PS C:\> New-BrokerPowerTimeScheme -Name 'First Half Week' -DaysOfWeek Weekend,Monday,Tuesday -DesktopGroupUid 3 -PeakHalfHours $pt48 -PoolSize $ps48

Parâmetros para tempos limite de sessão dinâmicos

Os seguintes cmdlets do SDK do PowerShell do Broker foram estendidos para tempos limite de sessão dinâmicos, suportando vários novos parâmetros:

Get-BrokerDesktopGroup
New-BrokerDesktopGroup
Set-BrokerDesktopGroup

Esses parâmetros incluem:

DisconnectPeakIdleSessionAfterSeconds – Representa o tempo em segundos após o qual uma sessão ociosa é desconectada durante o horário de pico. Esta propriedade tem um valor padrão de 0, o que indica a desabilitação de seu comportamento associado durante o horário de pico. Um valor maior que 0 habilita seu comportamento para o grupo de entrega apenas durante o horário de pico.
DisconnectOffPeakIdleSessionAfterSeconds - Representa o tempo em segundos após o qual uma sessão ociosa é desconectada durante o horário fora de pico. O valor padrão desta propriedade é 0, o que indica a desabilitação de seu comportamento associado durante o horário fora de pico. Um valor maior que 0 habilita seu comportamento associado para o grupo de entrega apenas durante o horário fora de pico.
LogoffPeakDisconnectedSessionAfterSeconds - Representa o tempo em segundos após o qual uma sessão desconectada é encerrada durante o horário de pico. O valor padrão desta propriedade é 0, o que indica a desabilitação de seu comportamento associado durante o horário de pico. Um valor maior que 0 habilita seu comportamento associado para o grupo de entrega apenas durante o horário de pico.
LogoffOffPeakDisconnectedSessionAfterSeconds - Representa o tempo em segundos após o qual uma sessão desconectada é encerrada durante o horário fora de pico. O valor padrão desta propriedade é 0, o que indica a desabilitação de seu comportamento associado durante o horário fora de pico. Um valor maior que 0 habilita seu comportamento associado para o grupo de entrega apenas durante o horário fora de pico.

Exemplo

Suponha que você queira definir o tempo limite de sessão ociosa para 3.600 segundos durante horários de pico para um grupo de entrega cujo nome é “MyDesktop”. Use o comando do PowerShell Set-BrokerDesktopGroup. Por exemplo:

C:\PS> Set-BrokerDesktopGroup "MyDesktop" -DisconnectOffPeakIdleSessionAfterSeconds 3600

Ao fazer isso, as sessões que estiveram ociosas por mais de 1 hora fora do pico para o grupo de desktop cujo nome é “MyDesktop” são desconectadas.

A versão oficial deste conteúdo está em inglês. Parte do conteúdo da documentação da Cloud Software Group é traduzida automaticamente para sua conveniência. A Cloud Software Group não tem controle sobre o conteúdo traduzido automaticamente, que pode conter erros, imprecisões ou linguagem inadequada. Nenhuma garantia de qualquer tipo, expressa ou implícita, é fornecida quanto à precisão, confiabilidade, adequação ou correção de quaisquer traduções feitas do original em inglês para qualquer outro idioma, ou quanto à conformidade do seu produto ou serviço Cloud Software Group com qualquer conteúdo traduzido automaticamente, e nenhuma garantia fornecida sob o contrato de licença de usuário final aplicável ou os termos de serviço, ou qualquer outro contrato com a Cloud Software Group, de que o produto ou serviço esteja em conformidade com qualquer documentação será aplicável na medida em que essa documentação tenha sido traduzida automaticamente. A Cloud Software Group não se responsabiliza por quaisquer danos ou problemas que possam surgir em decorrência do uso de conteúdo traduzido automaticamente.

Isso foi útil?

Comandos do SDK do PowerShell do Broker

January 23, 2026

Contribuição de:

January 23, 2026

Contribuição de:

Neste artigo

Set-BrokerDesktopGroup
New-BrokerPowerTimeScheme
Parâmetros para tempos limite de sessão dinâmicos

Isso foi útil?