Broker PowerShell SDK-Befehle

Last published : Nov 13, 2026
Sie können Autoscale für Bereitstellungsgruppen mit dem Broker PowerShell SDK konfigurieren. Um Autoscale mit PowerShell-Befehlen zu konfigurieren, müssen Sie PowerShell SDK Version 7.21.0.12 oder höher verwenden. Weitere Informationen zu den PowerShell SDKs finden Sie unter SDKs und APIs.
Related information
Autoscale™

Set-BrokerDesktopGroup

Deaktiviert oder aktiviert eine vorhandene BrokerDesktopGroup oder ändert deren Einstellungen. Weitere Informationen zu diesem Cmdlet finden Sie unter <https://citrix.github.io/delivery-controller-sdk/Broker/Set-BrokerDesktopGroup/>.

Beispiele

Die folgenden Beispiele zeigen, wie die PowerShell-Cmdlets verwendet werden.
Autoscale™ aktivieren
  • Angenommen, Sie möchten Autoscale für die Bereitstellungsgruppe mit dem Namen „MyDesktop“ aktivieren. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -AutoscalingEnabled $true
Kapazitätspuffer separat für Spitzen- und Nebenzeiten konfigurieren
  • Angenommen, Sie möchten den Kapazitätspuffer für eine Bereitstellungsgruppe mit dem Namen „MyDesktop“ auf 20 % für Spitzenzeiten und 10 % für Nebenzeiten festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakBufferSizePercent 20 -OffPeakBufferSizePercent 10
Die Einstellung für die Zeitüberschreitung bei Trennung konfigurieren
  • Angenommen, Sie möchten den Wert für die Zeitüberschreitung bei Trennung für eine Bereitstellungsgruppe mit dem Namen „MyDesktop“ auf 60 Minuten für Spitzenzeiten und 30 Minuten für Nebenzeiten festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakDisconnectTimeout 60 -OffPeakDisconnectTimeout 30
Die Einstellung für die Zeitüberschreitung bei Abmeldung konfigurieren
  • Angenommen, Sie möchten den Wert für die Zeitüberschreitung bei Abmeldung für eine Bereitstellungsgruppe mit dem Namen „MyDesktop“ auf 60 Minuten für Spitzenzeiten und 30 Minuten für Nebenzeiten festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakLogOffTimeout 60 -OffPeakLogOffTimeout 30
Die Einstellung für die Ausschaltverzögerung konfigurieren
  • Angenommen, Sie möchten die Ausschaltverzögerung für eine Bereitstellungsgruppe mit dem Namen „MyDesktop“ auf 15 Minuten festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PowerOffDelay 15
Konfigurieren Sie einen Zeitraum, in dem die Ausschaltverzögerung nicht wirksam wird
  • Angenommen, Sie möchten, dass die Ausschaltverzögerung für eine Bereitstellungsgruppe mit dem Namen „MyDesktop“ erst nach 30 Minuten wirksam wird. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:
    • C:\PS> Set-BrokerDesktopGroup "MyDesktop" -SettlementPeriodBeforeAutoShutdown 30.
Konfigurieren Sie die Einstellung Kosten für Maschineninstanz
  • Angenommen, Sie möchten die Kosten pro Stunde für eine Maschineninstanz auf 0,2 Dollar für eine Bereitstellungsgruppe mit dem Namen „MyDesktop“ festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -MachineCost 0.2

New-BrokerPowerTimeScheme

Erstellt ein BrokerPowerTimeScheme für eine Bereitstellungsgruppe. Weitere Informationen finden Sie unter <https://citrix.github.io/delivery-controller-sdk/Broker/New-BrokerPowerTimeScheme/>.

Beispiel

Angenommen, Sie möchten ein Power-Zeit-Schema für eine Bereitstellungsgruppe mit dem UID-Wert 3 erstellen. Das neue Schema umfasst das Wochenende, Montag und Dienstag. Der Zeitraum von 8:00 Uhr bis 18:30 Uhr ist als Spitzenzeit für die im Schema enthaltenen Tage definiert. Für Spitzenzeiten beträgt die Poolgröße (die Anzahl der eingeschalteten Maschinen) 20. Für Nebenzeiten beträgt sie 5. Sie können den PowerShell-Befehl Set-BrokerDesktopGroup verwenden. Zum Beispiel:
  • 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

Parameter für dynamische Sitzungs-Timeouts

Die folgenden Broker PowerShell SDK-Cmdlets wurden für dynamische Sitzungs-Timeouts durch die Unterstützung mehrerer neuer Parameter erweitert:
  • Get-BrokerDesktopGroup
  • New-BrokerDesktopGroup
  • Set-BrokerDesktopGroup
Diese Parameter umfassen:
  • DisconnectPeakIdleSessionAfterSeconds – Gibt die Zeit in Sekunden an, nach der eine inaktive Sitzung während der Spitzenzeit getrennt wird. Diese Eigenschaft hat einen Standardwert von 0, was die Deaktivierung des zugehörigen Verhaltens während der Spitzenzeit anzeigt. Ein Wert größer als 0 aktiviert dieses Verhalten für die Bereitstellungsgruppe nur während der Spitzenzeit.
  • DisconnectOffPeakIdleSessionAfterSeconds – Gibt die Zeit in Sekunden an, nach der eine inaktive Sitzung außerhalb der Spitzenzeiten getrennt wird. Der Standardwert dieser Eigenschaft ist 0, was die Deaktivierung des zugehörigen Verhaltens außerhalb der Spitzenzeiten anzeigt. Ein Wert größer als 0 aktiviert das zugehörige Verhalten für die Bereitstellungsgruppe nur außerhalb der Spitzenzeiten.
  • LogoffPeakDisconnectedSessionAfterSeconds – Gibt die Zeit in Sekunden an, nach der eine getrennte Sitzung während der Spitzenzeit beendet wird. Der Standardwert dieser Eigenschaft ist 0, was die Deaktivierung des zugehörigen Verhaltens während der Spitzenzeit anzeigt. Ein Wert größer als 0 aktiviert das zugehörige Verhalten für die Bereitstellungsgruppe nur während der Spitzenzeit.
  • LogoffOffPeakDisconnectedSessionAfterSeconds – Gibt die Zeit in Sekunden an, nach der eine getrennte Sitzung außerhalb der Spitzenzeiten beendet wird. Der Standardwert dieser Eigenschaft ist 0, was die Deaktivierung des zugehörigen Verhaltens außerhalb der Spitzenzeiten anzeigt. Ein Wert größer als 0 aktiviert das zugehörige Verhalten für die Bereitstellungsgruppe nur außerhalb der Spitzenzeiten.

Beispiel

Angenommen, Sie möchten das Timeout für inaktive Sitzungen während der Spitzenzeiten für eine Bereitstellungsgruppe mit dem Namen „MyDesktop“ auf 3.600 Sekunden festlegen. Verwenden Sie den Set-BrokerDesktopGroup PowerShell-Befehl. Zum Beispiel:
  • C:\PS> Set-BrokerDesktopGroup "MyDesktop" -DisconnectOffPeakIdleSessionAfterSeconds 3600
Dadurch werden Sitzungen getrennt, die außerhalb der Spitzenzeiten für die Desktopgruppe „MyDesktop“ länger als 1 Stunde inaktiv waren.