製品ドキュメント
Citrix DaaS™
PDFを表示

Broker PowerShell SDK コマンド

April 6, 2026
寄稿者: 
C C

Broker PowerShell SDK を使用して、デリバリーグループの Autoscale を構成できます。PowerShell コマンドを使用して Autoscale を構成するには、Remote PowerShell SDK バージョン 7.21.0.12 以降を使用する必要があります。Remote 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 に設定します。メンテナンスモードの 2 台のマシンはマシンプールに含まれないため、Autoscale は 4 台のマシンを起動します。Set-BrokerDesktopGroup PowerShell コマンドを使用します。例:

  • ```

PS C:> Set-BrokerDesktopGroup “MyDesktop” -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 コマンド
April 6, 2026
寄稿者: 
C C
April 6, 2026
寄稿者: 
C C

この記事の概要

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