Citrix DaaS™

Comandos do SDK do PowerShell do Broker

September 15, 2025

Contribuição de:

C C

É possível 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. 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 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 configuraçã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 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 do 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 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 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 do PowerShell Set-BrokerDesktopGroup. Por exemplo:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -MachineCost 0.2

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-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”.

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

September 15, 2025

Contribuição de:

C C

September 15, 2025

Contribuição de:

C C

Neste artigo

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

Isso foi útil?