製品ドキュメント
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDFを表示

Broker PowerShell SDK コマンド

March 18, 2026
寄稿者: 
C

Broker PowerShell SDK を使用して、デリバリーグループの Autoscale を構成できます。PowerShell コマンドを使用して Autoscale を構成するには、PowerShell SDK バージョン 7.21.0.12 以降を使用する必要があります。PowerShell SDK の詳細については、「SDK と API」を参照してください。

Set-BrokerDesktopGroup

既存の BrokerDesktopGroup を無効または有効にするか、その設定を変更します。このコマンドレットの詳細については、https://citrix.github.io/delivery-controller-sdk/Broker/Set-BrokerDesktopGroup/ を参照してください。

例

PowerShell コマンドレットの使用方法の詳細については、以下の例を参照してください。

Autoscale™ の有効化

  • 名前が「MyDesktop」であるデリバリーグループに対して Autoscale を有効にしたいとします。Set-BrokerDesktopGroup PowerShell コマンドを使用します。例：
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -AutoscalingEnabled $true

ピーク時とオフピーク時で容量バッファーを個別に構成

  • 名前が「MyDesktop」であるデリバリーグループに対して、ピーク時の容量バッファーを 20%、オフピーク時の容量バッファーを 10% に設定したいとします。Set-BrokerDesktopGroup PowerShell コマンドを使用します。例：
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakBufferSizePercent 20 -OffPeakBufferSizePercent 10

切断時のタイムアウト設定の構成

  • 名前が「MyDesktop」であるデリバリーグループに対して、ピーク時の切断時のタイムアウト値を 60 分、オフピーク時の値を 30 分に設定したいとします。Set-BrokerDesktopGroup PowerShell コマンドを使用します。例：
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakDisconnectTimeout 60 -OffPeakDisconnectTimeout 30

ログオフ時のタイムアウト設定の構成

  • 名前が「MyDesktop」であるデリバリーグループに対して、ピーク時のログオフ時のタイムアウト値を 60 分、オフピーク時の値を 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」であるデリバリーグループに対して、1 時間あたりのマシンインスタンスコストを 0.2 ドルに設定したいとします。Set-BrokerDesktopGroup PowerShell コマンドを使用します。例：
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -MachineCost 0.2

メンテナンスモードの VM を Autoscale プールから除外

  • 10 台のマシンを持つデリバリーグループがあり、そのうち 2 台のマシンがメンテナンスモードであるとします。Autoscale のバッファー容量は 50% に設定されています。メンテナンスモードの VM を Autoscale プールから除外したい場合は、PoolSizeExcludesMaintenanceMode を True に設定します。Autoscale は、メンテナンスモードの 2 台のマシンがマシンプールに含まれないため、4 台のマシンを起動します。Set-BrokerDesktopGroup PowerShell コマンドを使用します。例：

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

    シングルセッションデリバリーグループの場合、PoolSizeExcludesMaintenanceMode のデフォルト値は False です。

    マルチセッションデリバリーグループの場合、PoolSizeExcludesMaintenanceMode のデフォルト値は True です。

New-BrokerPowerTimeScheme

デリバリーグループの BrokerPowerTimeScheme を作成します。詳細については、https://citrix.github.io/delivery-controller-sdk/Broker/New-BrokerPowerTimeScheme/ を参照してください。

例

UID 値が 3 のデリバリーグループに対して電源時間スキームを作成したいとします。新しいスキームは週末、月曜日、火曜日を対象とします。午前 8 時から午後 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 コマンドレットは、複数の新しいパラメーターをサポートすることで、動的セッションタイムアウト用に拡張されました。

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

これらのパラメーターには以下が含まれます。

  • DisconnectPeakIdleSessionAfterSeconds – ピーク時にアイドル状態のセッションが切断されるまでの時間を秒単位で表します。このプロパティのデフォルト値は 0 で、ピーク時の関連動作が無効になっていることを示します。0 より大きい値は、ピーク時のみデリバリーグループの動作を有効にします。

  • DisconnectOffPeakIdleSessionAfterSeconds - オフピーク時にアイドル状態のセッションが切断されるまでの時間を秒単位で表します。このプロパティのデフォルト値は 0 で、オフピーク時の関連動作が無効になっていることを示します。0 より大きい値は、オフピーク時のみデリバリーグループの関連動作を有効にします。

  • LogoffPeakDisconnectedSessionAfterSeconds - ピーク時に切断されたセッションが終了されるまでの時間を秒単位で表します。このプロパティのデフォルト値は 0 で、ピーク時の関連動作が無効になっていることを示します。0 より大きい値は、ピーク時のみデリバリーグループの関連動作を有効にします。

  • LogoffOffPeakDisconnectedSessionAfterSeconds - オフピーク時に切断されたセッションが終了されるまでの時間を秒単位で表します。このプロパティのデフォルト値は 0 で、オフピーク時の関連動作が無効になっていることを示します。0 より大きい値は、オフピーク時のみデリバリーグループの関連動作を有効にします。

例

名前が「MyDesktop」であるデリバリーグループに対して、ピーク時のアイドルセッションタイムアウトを 3,600 秒に設定したいとします。Set-BrokerDesktopGroup PowerShell コマンドを使用します。例：

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

これにより、名前が「MyDesktop」であるデスクトップグループのオフピーク時に、1 時間以上アイドル状態であったセッションが切断されます。

Broker PowerShell SDK コマンド
March 18, 2026
寄稿者: 
C
March 18, 2026
寄稿者: 
C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.