ブローカー パワーシェル SDK コマンド
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-BrokerDesktopGroupPowerShell コマンドを使用します。例:PS C:\> Set-BrokerDesktopGroup "MyDesktop" -AutoscalingEnabled $true
ピーク時とオフピーク時で容量バッファを個別に構成する
- 「MyDesktop」という名前のデリバリーグループの容量バッファを、ピーク時は20%、オフピーク時は10%に設定したいとします。
Set-BrokerDesktopGroupPowerShell コマンドを使用します。例:PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakBufferSizePercent 20 -OffPeakBufferSizePercent 10
切断時のタイムアウト設定を構成する
- 「MyDesktop」という名前のデリバリーグループの切断時のタイムアウト値を、ピーク時は60分、オフピーク時は30分に設定したいとします。
Set-BrokerDesktopGroupPowerShell コマンドを使用します。例:PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakDisconnectTimeout 60 -OffPeakDisconnectTimeout 30
「ログオフ時のタイムアウト」設定を構成する
- 名前が「MyDesktop」であるデリバリーグループに対して、ピーク時の「ログオフ時のタイムアウト」値を60分に、オフピーク時の値を30分に設定したいとします。
Set-BrokerDesktopGroupPowerShellコマンドを使用します。例：PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakLogOffTimeout 60 -OffPeakLogOffTimeout 30
「電源オフ遅延」設定を構成する
- 名前が「MyDesktop」であるデリバリーグループに対して、電源オフ遅延を15分に設定したいとします。
Set-BrokerDesktopGroupPowerShellコマンドを使用します。例：PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PowerOffDelay 15
電源オフ遅延が適用されない期間を構成する
- 名前が「MyDesktop」であるデリバリーグループに対して、電源オフ遅延が30分経過するまで有効になるようにしたいとします。
Set-BrokerDesktopGroupPowerShellコマンドを使用します。例：-
C:\PS> Set-BrokerDesktopGroup "MyDesktop" -SettlementPeriodBeforeAutoShutdown 30。
-
「マシンインスタンスコスト」設定を構成する
- 名前が「MyDesktop」であるデリバリーグループに対して、1時間あたりのマシンインスタンスコストを0.2ドルに設定したいとします。
Set-BrokerDesktopGroupPowerShellコマンドを使用します。例：PS C:\> Set-BrokerDesktopGroup "MyDesktop" -MachineCost 0.2
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時間以上アイドル状態だったセッションが切断されます。