Citrix Virtual Apps and Desktops

Broker PowerShell SDK 命令

可以使用 Broker PowerShell SDK 为交付组配置 AutoScale。要使用 PowerShell 命令配置 AutoScale,必须使用 PowerShell SDK 版本 7.21.0.12 或更高版本。有关 PowerShell SDK 的详细信息,请参阅 SDK 和 API

Set-BrokerDesktopGroup

禁用或启用现有 BrokerDesktopGroup 或更改其设置。有关此 cmdlet 的详细信息,请参阅https://citrix.github.io/delivery-controller-sdk/Broker/Set-BrokerDesktopGroup/

示例

有关如何使用 PowerShell cmdlet 的详细信息,请参阅以下示例:

启用 AutoScale

  • 假设您希望为名为“MyDesktop”的交付组启用 AutoScale。使用 Set-BrokerDesktopGroup PowerShell 命令。例如:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -AutoscalingEnabled $true

分别设置高峰和非高峰时段的容量缓冲区

  • 假设您希望将容量缓冲区设置为 20%(面向高峰时段),对于名为“MyDesktop”的交付组,将容量缓冲区设置为 10%(面向非高峰时段)。使用 Set-BrokerDesktopGroup PowerShell 命令。例如:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakBufferSizePercent 20 -OffPeakBufferSizePercent 10

配置断开连接的超时时间设置

  • 假设您希望将断开连接的超时时间值设置为 60分钟(面向高峰时段),对于名为“MyDesktop”的交付组,将断开连接的超时时间设置为 30分钟(面向非高峰时段)。使用 Set-BrokerDesktopGroup PowerShell 命令。例如:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakDisconnectTimeout 60 -OffPeakDisconnectTimeout 30

配置注销的超时时间设置

  • 假设您希望将注销的超时时间值设置为 60分钟(面向高峰时段),对于名为“MyDesktop”的交付组,将注销的超时时间设置为 30分钟(面向非高峰时段)。使用 Set-BrokerDesktopGroup PowerShell 命令。例如:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakLogOffTimeout 60 -OffPeakLogOffTimeout 30

配置关机延迟设置

  • 假设您希望将名为“MyDesktop”的交付组的关机延迟设置为 15 分钟。使用 Set-BrokerDesktopGroup PowerShell 命令。例如:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PowerOffDelay 15

配置关机延迟不生效的时间段

  • 假设您希望将名为“MyDesktop”的交付组的关机延迟设置为在 30 分钟后生效。使用 Set-BrokerDesktopGroup PowerShell 命令。例如:
    • C:\PS> Set-BrokerDesktopGroup "MyDesktop" -SettlementPeriodBeforeAutoShutdown 30

配置计算机实例成本设置

  • 假设您希望将名为“MyDesktop”的交付组的计算机实例每小时成本设置为 0.2 美元。使用 Set-BrokerDesktopGroup PowerShell 命令。例如:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -MachineCost 0.2

New-BrokerPowerTimeScheme

为交付组创建 BrokerPowerTimeScheme。有关详细信息,请参阅 https://citrix.github.io/delivery-controller-sdk/Broker/New-BrokerPowerTimeScheme/

示例

假设您要为 UID 值为 3 的交付组创建电源时间方案。新方案涵盖周末、星期一和星期二。上午 8:00 至下午 6:30 这一时间段被定义为方案中包含的日期的高峰时段。对于高峰时段,池大小(保持打开电源的计算机数量)为 20。对于非高峰时段,其大小为 5。可以使用 Set-BrokerDesktopGroup PowerShell 命令。例如:

  • 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

动态会话超时参数

通过支持多个新参数,以下 Broker PowerShell SDK cmdlet 已针对动态会话超时进行了扩展:

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

这些参数包括:

  • DisconnectPeakIdleSessionAfterSeconds - 表示空闲会话在高峰时段断开连接的时间(以秒为单位)。此属性的默认值为 0,表示在高峰时段禁用其关联行为。大于 0 的值仅启用交付组在高峰时段的行为。

  • DisconnectOffPeakIdleSessionAfterSeconds - 表示以秒为单位的时间,在此时间之后,空闲会话在非高峰时段断开连接。此属性的默认值为 0,表示在非高峰期间禁用其关联行为。如果值大于 0,则仅在非高峰时段启用交付组的关联行为。

  • LogoffPeakDisconnectedSessionAfterSeconds - 表示在高峰时段内断开连接的会话终止的时间(以秒为单位)。此属性的默认值为 0,表示在高峰时段禁用其关联行为。大于 0 的值仅在高峰时段启用交付组的关联行为。

  • LogoffOffPeakDisconnectedSessionAfterSeconds - 表示在非高峰时段终止断开连接的会话的时间(以秒为单位)。此属性的默认值为 0,表示在非高峰期间禁用其关联行为。如果值大于 0,则仅在非高峰时段启用交付组的关联行为。

示例

假设您想将名为“MyDesktop”的交付组的空闲会话超时设置为高峰时段的 3600 秒。使用 Set-BrokerDesktopGroup PowerShell 命令。例如:

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

这样做会断开名为“MyDesktop”的桌面组在非高峰时间空闲超过 1 小时的会话的连接。

Broker PowerShell SDK 命令