Citrix DaaS™

Comandos del SDK de PowerShell de Broker

March 25, 2026

Contribución de:

C C

Puedes configurar Autoscale para grupos de entrega usando el SDK de PowerShell de Broker. Para configurar Autoscale usando comandos de PowerShell, debes usar la versión 7.21.0.12 o posterior del SDK de PowerShell remoto. Para más información sobre el SDK de PowerShell remoto, consulta SDK y API.

Set-BrokerDesktopGroup

Deshabilita o habilita un BrokerDesktopGroup existente o modifica sus ajustes

Para más información sobre este cmdlet, consulta https://citrix.github.io/delivery-controller-sdk/Broker/Set-BrokerDesktopGroup/.

Ejemplos

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

Habilitar Autoscale™:

Supón que quieres habilitar Autoscale para el grupo de entrega cuyo nombre es “MyDesktop”. Usa el comando de PowerShell Set-BrokerDesktopGroup. Por ejemplo:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -AutoscalingEnabled $true

Configurar el búfer de capacidad por separado para horas pico y horas de baja demanda:

Supón que quieres establecer el búfer de capacidad en un 20 % para las horas pico y un 10 % para las horas de baja demanda para un grupo de entrega cuyo nombre es “MyDesktop”. Usa el comando de PowerShell Set-BrokerDesktopGroup. Por ejemplo:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakBufferSizePercent 20 -OffPeakBufferSizePercent 10

Configurar el ajuste de tiempo de espera al desconectarse:

Supón que quieres establecer el valor de tiempo de espera al desconectarse en 60 minutos para las horas pico y 30 minutos para las horas de baja demanda para un grupo de entrega cuyo nombre es “MyDesktop”. Usa 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:

Supón que quieres establecer el valor de tiempo de espera al cerrar sesión en 60 minutos para las horas pico y 30 minutos para las horas de baja demanda para un grupo de entrega cuyo nombre es “MyDesktop”. Usa el comando de PowerShell Set-BrokerDesktopGroup. Por ejemplo:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakLogOffTimeout 60 -OffPeakLogOffTimeout 30

Configurar el ajuste de retraso de apagado:

Supón que quieres establecer el retraso de apagado en 15 minutos para un grupo de entrega cuyo nombre es “MyDesktop”. Usa 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:

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

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

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

Excluir las VM en modo de mantenimiento del grupo de Autoscale:

Considera un grupo de entrega con 10 máquinas, de las cuales 2 están en modo de mantenimiento. La capacidad del búfer de Autoscale está establecida en un 50 %. Supón que quieres excluir las VM en modo de mantenimiento del grupo de Autoscale; en ese caso, establece PoolSizeExcludesMaintenanceMode en True. Autoscale iniciará entonces 4 máquinas, ya que las 2 máquinas en modo de mantenimiento no se incluyen en el grupo de máquinas. Usa 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 de varias sesiones es True.

New-BrokerPowerTimeScheme

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

Ejemplo

Supón que quieres 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 AM a 6:30 PM se define como horas pico para los días incluidos en el esquema. Para las horas pico, el tamaño del grupo (el número de máquinas que se mantienen encendidas) es 20. Para las horas de baja demanda, es 5. Puedes 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 PowerShell de Broker se han ampliado para 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 deshabilitació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 baja demanda. El valor predeterminado de esta propiedad es 0, lo que indica la deshabilitación de su comportamiento asociado durante las horas de baja demanda. Un valor mayor que 0 habilita su comportamiento asociado para el grupo de entrega solo durante las horas de baja demanda.
LogoffPeakDisconnectedSessionAfterSeconds – Representa el tiempo en segundos después del cual una sesión desconectada se termina durante las horas pico. El valor predeterminado de esta propiedad es 0, lo que indica la deshabilitació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 termina durante las horas de baja demanda. El valor predeterminado de esta propiedad es 0, lo que indica la deshabilitación de su comportamiento asociado durante las horas de baja demanda. Un valor mayor que 0 habilita su comportamiento asociado para el grupo de entrega solo durante las horas de baja demanda.

Ejemplo

Supón que quieres establecer el tiempo de espera de sesión inactiva en 3600 segundos durante las horas pico para un grupo de entrega cuyo nombre es “MyDesktop”. Usa el comando de PowerShell Set-BrokerDesktopGroup. 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 baja demanda para el grupo de escritorio cuyo nombre es “MyDesktop”.

La versión oficial de este contenido está en inglés. Para mayor comodidad, parte del contenido de la documentación de Cloud Software Group solo tiene traducción automática. Cloud Software Group no puede controlar el contenido con traducción automática, que puede contener errores, imprecisiones o un lenguaje inadecuado. No se ofrece ninguna garantía, ni implícita ni explícita, en cuanto a la exactitud, la fiabilidad, la idoneidad o la precisión de las traducciones realizadas del original en inglés a cualquier otro idioma, o que su producto o servicio de Cloud Software Group se ajusten a cualquier contenido con traducción automática, y cualquier garantía provista bajo el contrato de licencia del usuario final o las condiciones de servicio, o cualquier otro contrato con Cloud Software Group, de que el producto o el servicio se ajusten a la documentación no se aplicará en cuanto dicha documentación se ha traducido automáticamente. Cloud Software Group no se hace responsable de los daños o los problemas que puedan surgir del uso del contenido traducido automáticamente.

¿Le ha resultado útil?

Comandos del SDK de PowerShell de Broker

March 25, 2026

Contribución de:

C C

March 25, 2026

Contribución de:

C C

En este artículo

Set-BrokerDesktopGroup
New-BrokerPowerTimeScheme
Parámetros para tiempos de espera de sesión dinámicos

¿Le ha resultado útil?