Comandos do SDK do Broker PowerShell

Last published : Nov 03, 2026
Você pode configurar o Autoscale para grupos de entrega usando o SDK do Broker PowerShell. Para configurar o Autoscale usando comandos PowerShell, você deve usar a versão 7.21.0.12 ou posterior do SDK do Remote PowerShell. Para obter mais informações sobre o SDK do Remote 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
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 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 PowerShell Set-BrokerDesktopGroup. Por exemplo:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakDisconnectTimeout 60 -OffPeakDisconnectTimeout 30
Configurar 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" -PeakLogOffTimeout 60 -OffPeakLogOffTimeout 30
Configurar 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 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, se você quiser excluir as VMs em modo de manutenção do pool de autoscale, 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 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 obter 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 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 de folga. O valor padrão desta propriedade é 0, o que indica a desativação de seu comportamento associado durante o horário de folga. Um valor maior que 0 habilita seu comportamento associado para o grupo de entrega apenas durante o horário de folga.
  • 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 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 de folga. O valor padrão desta propriedade é 0, o que indica a desativação de seu comportamento associado durante o horário de folga. Um valor maior que 0 habilita seu comportamento associado para o grupo de entrega apenas durante o horário de folga.

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
Fazer isso desconecta as sessões que ficaram ociosas por mais de 1 hora no horário de folga para o grupo de desktop cujo nome é "MyDesktop".