Documentação de produtos
Citrix DaaS™
Ver PDF

Comandos do SDK do PowerShell do Broker

May 4, 2026
Contribuição de: 
C C

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 o SDK do PowerShell Remoto versão 7.21.0.12 ou posterior. Para obter mais informações sobre o SDK do PowerShell Remoto, consulte SDKs e APIs.

Set-BrokerDesktopGroup

Desabilita ou habilita um BrokerDesktopGroup existente ou altera suas configurações

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 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 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 do PowerShell Set-BrokerDesktopGroup. Por exemplo:

    
 PS C:\> Set-BrokerDesktopGroup -PoolSizeExcludesMaintenanceMode $true

 <!--NeedCopy-->

    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 de 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 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 fora de pico. O valor padrão desta propriedade é 0, o que indica a desativaçã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 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 fora de pico. O valor padrão desta propriedade é 0, o que indica a desativaçã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 os 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

Isso desconecta as sessões que estiveram ociosas por mais de 1 hora fora do pico para o grupo de desktop cujo nome é “MyDesktop”.

Comandos do SDK do PowerShell do Broker
May 4, 2026
Contribuição de: 
C C
May 4, 2026
Contribuição de: 
C C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.