Citrix Virtual Apps and Desktops 7 2311

ブローカー PowerShell SDK コマンドレット

May 31, 2026

寄稿者:

C C

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

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

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

「切断時のタイムアウト」設定を構成する

名前が「MyDesktop」であるデリバリーグループに対して、ピーク時のwhen disconnected timeout値を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

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
セット-ブローカーデスクトップグループ

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

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時間以上アイドル状態だったセッションが切断されます。

この製品ドキュメントの正式なバージョンは英語版です。英語以外のすべてのバージョンは、お客様の利便性のためにのみ提供され、機械翻訳された内容が含まれている場合があります。詳しくは、Cloud Software Group home で機械翻訳に関する免責事項（Machine Translation Disclaimer）をご覧ください。

この情報は役に立ちましたか?

ブローカー PowerShell SDK コマンドレット

May 31, 2026

寄稿者:

C C

May 31, 2026

寄稿者:

C C

この情報は役に立ちましたか?