Comandos del SDK de PowerShell de Broker

Puede configurar Autoscale para grupos de entrega mediante el SDK de PowerShell de Broker. Para configurar Autoscale mediante comandos de PowerShell, debe usar la versión 7.21.0.12 o posterior del SDK de PowerShell. Para obtener más información sobre los SDK de PowerShell, consulte SDK y API.

Set-BrokerDesktopGroup

Deshabilita o habilita un BrokerDesktopGroup existente o modifica su configuración. Para obtener más información sobre este cmdlet, consulte https://citrix.github.io/delivery-controller-sdk/Broker/Set-BrokerDesktopGroup/.

Ejemplos

Consulte los siguientes ejemplos para obtener detalles sobre cómo usar los cmdlets de PowerShell.

Habilitar Autoscale™

• Supongamos que quiere habilitar Autoscale para el grupo de entrega cuyo nombre es “MyDesktop”. Use el comando de PowerShell Set-BrokerDesktopGroup. Por ejemplo:
  • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -AutoscalingEnabled $true

Configurar el búfer de capacidad por separado para las horas pico y las horas de menor actividad

• Supongamos que quiere establecer el búfer de capacidad en el 20% para las horas pico y en el 10% para las horas de menor actividad para un grupo de entrega cuyo nombre es “MyDesktop”. Use el comando de PowerShell Set-BrokerDesktopGroup. Por ejemplo:
  • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakBufferSizePercent 20 -OffPeakBufferSizePercent 10

Configurar el ajuste cuando el tiempo de espera de desconexión

• Supongamos que quiere establecer el valor de cuando el tiempo de espera de desconexión en 60 minutos para las horas pico y en 30 minutos para las horas de menor actividad para un grupo de entrega cuyo nombre es “MyDesktop”. Use el comando de PowerShell Set-BrokerDesktopGroup. Por ejemplo:
  • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakDisconnectTimeout 60 -OffPeakDisconnectTimeout 30

Configurar el ajuste de tiempo de espera al cerrar sesión

• Supongamos que quiere establecer el valor de tiempo de espera al cerrar sesión en 60 minutos para las horas punta y 30 minutos para las horas de menor actividad para un grupo de entrega cuyo nombre es “MyDesktop”. Utilice el comando de PowerShell Set-BrokerDesktopGroup. Por ejemplo:
  • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakLogOffTimeout 60 -OffPeakLogOffTimeout 30

Configurar el ajuste de retraso de apagado

• Supongamos que quiere establecer el retraso de apagado en 15 minutos para un grupo de entrega cuyo nombre es “MyDesktop”. Utilice el comando de PowerShell Set-BrokerDesktopGroup. Por ejemplo:
  • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PowerOffDelay 15

Configurar un período de tiempo durante el cual el retraso de apagado no surte efecto

• Supongamos que quiere que el retraso de apagado surta efecto hasta que hayan transcurrido 30 minutos para un grupo de entrega cuyo nombre es “MyDesktop”. Utilice el comando de PowerShell Set-BrokerDesktopGroup. Por ejemplo:
  • C:\PS> Set-BrokerDesktopGroup "MyDesktop" -SettlementPeriodBeforeAutoShutdown 30.

Configurar el ajuste de costo de la instancia de máquina

• Supongamos que quiere establecer el costo de la instancia de máquina por hora en 0,2 dólares para un grupo de entrega cuyo nombre es “MyDesktop”. Utilice el comando de PowerShell Set-BrokerDesktopGroup. Por ejemplo:
  • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -MachineCost 0.2

Excluir las VMs en modo de mantenimiento del grupo de Autoscale

• Considere un grupo de entrega con 10 máquinas, de las cuales 2 máquinas están en modo de mantenimiento. La capacidad del búfer de Autoscale está establecida en el 50%. Supongamos que quiere excluir las VMs en modo de mantenimiento del grupo de Autoscale, entonces establezca PoolSizeExcludesMaintenanceMode en True. Autoscale inicia entonces 4 máquinas, ya que las 2 máquinas en modo de mantenimiento no están incluidas en el grupo de máquinas. Utilice el comando de PowerShell Set-BrokerDesktopGroup. Por ejemplo:

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

  El valor predeterminado de PoolSizeExcludesMaintenanceMode para los grupos de entrega de sesión única es False.

  El valor predeterminado de PoolSizeExcludesMaintenanceMode para los grupos de entrega multisecuencia es True.

New-BrokerPowerTimeScheme

Crea un BrokerPowerTimeScheme para un grupo de entrega. Para obtener más información, consulte https://citrix.github.io/delivery-controller-sdk/Broker/New-BrokerPowerTimeScheme/.

Ejemplo

Supongamos que quiere crear un esquema de tiempo de energía para un grupo de entrega cuyo valor UID es 3. El nuevo esquema cubre el fin de semana, el lunes y el martes. La franja horaria de 8:00 a 18:30 se define como horas punta para los días incluidos en el esquema. Para las horas punta, el tamaño del grupo (el número de máquinas que se mantienen encendidas) es 20. Para las horas de menor actividad, es 5. Puede usar el comando de PowerShell Set-BrokerDesktopGroup. Por ejemplo:

• 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 tiempos de espera de sesión dinámicos

Los siguientes cmdlets del SDK de Broker PowerShell se han ampliado para los tiempos de espera de sesión dinámicos al admitir varios parámetros nuevos:

• Get-BrokerDesktopGroup
• New-BrokerDesktopGroup
• Set-BrokerDesktopGroup

Esos parámetros incluyen:

• DisconnectPeakIdleSessionAfterSeconds – Representa el tiempo en segundos después del cual una sesión inactiva se desconecta durante las horas pico. Esta propiedad tiene un valor predeterminado de 0, lo que indica la desactivación de su comportamiento asociado durante las horas pico. Un valor mayor que 0 habilita su comportamiento para el grupo de entrega solo durante las horas pico.

• DisconnectOffPeakIdleSessionAfterSeconds - Representa el tiempo en segundos después del cual una sesión inactiva se desconecta durante las horas de menor actividad. El valor predeterminado de esta propiedad es 0, lo que indica la desactivación de su comportamiento asociado durante las horas de menor actividad. Un valor mayor que 0 habilita su comportamiento asociado para el grupo de entrega solo durante las horas de menor actividad.

• LogoffPeakDisconnectedSessionAfterSeconds - Representa el tiempo en segundos después del cual una sesión desconectada se cierra durante las horas pico. El valor predeterminado de esta propiedad es 0, lo que indica la desactivación de su comportamiento asociado durante las horas pico. Un valor mayor que 0 habilita su comportamiento asociado para el grupo de entrega solo durante las horas pico.

• LogoffOffPeakDisconnectedSessionAfterSeconds - Representa el tiempo en segundos después del cual una sesión desconectada se cierra durante las horas de menor actividad. El valor predeterminado de esta propiedad es 0, lo que indica la desactivación de su comportamiento asociado durante las horas de menor actividad. Un valor mayor que 0 habilita su comportamiento asociado para el grupo de entrega solo durante las horas de menor actividad.

Ejemplo

Supongamos que desea establecer el tiempo de espera de la sesión inactiva en 3600 segundos durante las horas pico para un grupo de entrega cuyo nombre es «MyDesktop». Utilice el comando Set-BrokerDesktopGroup de PowerShell. Por ejemplo:

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

Al hacer esto, se desconectan las sesiones que han estado inactivas durante más de 1 hora en horas de menor actividad para el grupo de escritorios cuyo nombre es «MyDesktop».