Comandos do SDK do PowerShell do Broker

Last published : Nov 13, 2026
Você pode configurar o Autoscale para grupos de entrega usando o SDK do PowerShell do Broker. Para configurar o Autoscale usando comandos do PowerShell, você deve usar a versão 7.21.0.12 ou posterior do SDK do PowerShell. Para obter mais informações sobre os SDKs do PowerShell, consulte SDKs e APIs.
Related information
Autoscale™

Set-BrokerDesktopGroup

Desabilita ou habilita um BrokerDesktopGroup existente ou altera suas configurações. Para obter 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 Autoscale™
  • Suponha que você queira habilitar o Autoscale para o grupo de entrega cujo nome é "MyDesktop". Use o comando PowerShell Set-BrokerDesktopGroup. Por exemplo:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -AutoscalingEnabled $true
Configure 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 PowerShell Set-BrokerDesktopGroup. Por exemplo:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakBufferSizePercent 20 -OffPeakBufferSizePercent 10
Configure a configuração de tempo limite quando desconectado
  • Suponha que você queira definir o valor de tempo limite quando desconectado 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 PowerShell Set-BrokerDesktopGroup. Por exemplo:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakDisconnectTimeout 60 -OffPeakDisconnectTimeout 30
Configure a configuraçã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 PowerShell Set-BrokerDesktopGroup. Por exemplo:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakLogOffTimeout 60 -OffPeakLogOffTimeout 30
Configure a configuraçã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 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 PowerShell Set-BrokerDesktopGroup. Por exemplo:
    • C:\PS> Set-BrokerDesktopGroup "MyDesktop" -SettlementPeriodBeforeAutoShutdown 30.
Configurar a configuraçã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 PowerShell Set-BrokerDesktopGroup. Por exemplo:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -MachineCost 0.2
Excluir VMs em modo de manutenção do pool de autoescala
  • 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 de autoescala é definida como 50%. Suponha que, se você quiser excluir as VMs em modo de manutenção do pool de autoescala, defina PoolSizeExcludesMaintenanceMode como True. O Autoescala 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 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 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 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 Broker PowerShell foram estendidos para tempos limite de sessão dinâmicos, suportando múltiplos 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 desativação do 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 as horas fora do pico. O valor padrão desta propriedade é 0, o que indica a desativação do seu comportamento associado fora do pico. Um valor maior que 0 habilita seu comportamento associado para o grupo de entrega apenas durante as horas fora do 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 desativação do 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 as horas fora do pico. O valor padrão desta propriedade é 0, o que indica a desativação do seu comportamento associado fora do pico. Um valor maior que 0 habilita seu comportamento associado para o grupo de entrega apenas durante as horas fora do pico.

Exemplo

Suponha que você queira definir o tempo limite de sessão ociosa para 3.600 segundos durante os horários de pico para um grupo de entrega cujo nome é "MyDesktop". Use o comando PowerShell Set-BrokerDesktopGroup. Por exemplo:
  • C:\PS> Set-BrokerDesktopGroup "MyDesktop" -DisconnectOffPeakIdleSessionAfterSeconds 3600
Isso desconecta as sessões que estiveram ociosas por mais de 1 hora fora do pico para o grupo de desktop cujo nome é "MyDesktop".