Produktdokumentation
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDF anzeigen

Broker PowerShell SDK-Befehle

April 6, 2026
Beitrag von: 
C C

Sie können Autoscale für Bereitstellungsgruppen mithilfe des Broker PowerShell SDK konfigurieren. Um Autoscale mithilfe von 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.

Set-BrokerDesktopGroup

Deaktiviert oder aktiviert eine bestehende 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 „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 die Bereitstellungsgruppe „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 Zeitüberschreitung bei Trennung konfigurieren
  • Angenommen, Sie möchten den Wert für die Zeitüberschreitung bei Trennung für die Bereitstellungsgruppe „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 Zeitüberschreitung bei Abmeldung konfigurieren

  • Angenommen, Sie möchten den Wert für die Zeitüberschreitung bei Abmeldung für die Bereitstellungsgruppe „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 Ausschaltverzögerung konfigurieren

  • Angenommen, Sie möchten die Ausschaltverzögerung für die Bereitstellungsgruppe „MyDesktop“ auf 15 Minuten festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PowerOffDelay 15

  • Einen Zeitraum konfigurieren, in dem die Ausschaltverzögerung nicht wirksam wird

    • Angenommen, Sie möchten, dass die Ausschaltverzögerung für eine Bereitstellungsgruppe namens „MyDesktop“ erst nach 30 Minuten wirksam wird. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:
    • C:\PS> Set-BrokerDesktopGroup "MyDesktop" -SettlementPeriodBeforeAutoShutdown 30.

  • Die Einstellung Kosten für Maschineninstanz konfigurieren

  • Angenommen, Sie möchten die Kosten für die Maschineninstanz pro Stunde für eine Bereitstellungsgruppe namens „MyDesktop“ auf 0,2 Dollar festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -MachineCost 0.2

  • VMs im Wartungsmodus vom Autoscale-Pool ausschließen

  • Betrachten Sie eine Bereitstellungsgruppe mit 10 Maschinen, von denen sich 2 im Wartungsmodus befinden. Die Autoscale-Pufferkapazität ist auf 50 % eingestellt. Wenn Sie die VMs im Wartungsmodus vom Autoscale-Pool ausschließen möchten, setzen Sie PoolSizeExcludesMaintenanceMode auf True. Autoscale startet dann 4 Maschinen, da die 2 Maschinen im Wartungsmodus nicht im Maschinenpool enthalten sind. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:

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

    Der Standardwert für PoolSizeExcludesMaintenanceMode für Einzelsitzungs-Bereitstellungsgruppen ist False.

    Der Standardwert für PoolSizeExcludesMaintenanceMode für Mehrfachsitzungs-Bereitstellungsgruppen ist True.

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-Time-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 um die Unterstützung mehrerer neuer Parameter für dynamische Sitzungs-Timeouts 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 während der Nebenzeiten getrennt wird. Der Standardwert dieser Eigenschaft ist 0, was die Deaktivierung des zugehörigen Verhaltens während der Nebenzeiten anzeigt. Ein Wert größer als 0 aktiviert dieses Verhalten für die Bereitstellungsgruppe nur während der Nebenzeiten.

  • 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 dieses Verhalten für die Bereitstellungsgruppe nur während der Spitzenzeit.

  • LogoffOffPeakDisconnectedSessionAfterSeconds – Gibt die Zeit in Sekunden an, nach der eine getrennte Sitzung während der Nebenzeiten beendet wird. Der Standardwert dieser Eigenschaft ist 0, was die Deaktivierung des zugehörigen Verhaltens während der Nebenzeiten anzeigt. Ein Wert größer als 0 aktiviert dieses Verhalten für die Bereitstellungsgruppe nur während der Nebenzeiten.

Beispiel

Angenommen, Sie möchten das Timeout für inaktive Sitzungen während der Spitzenzeiten für eine Bereitstellungsgruppe namens „MyDesktop“ auf 3.600 Sekunden festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:

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

Dadurch werden Sitzungen getrennt, die länger als 1 Stunde in den Nebenzeiten für die Desktopgruppe „MyDesktop“ inaktiv waren.

Broker PowerShell SDK-Befehle
April 6, 2026
Beitrag von: 
C C
April 6, 2026
Beitrag von: 
C C

In diesem Artikel

Feedback zur Site | Your privacy choices footer linkIhre Datenschutzauswahl | Datenschutz und rechtliche Bestimmungen | Cookie-Einstellungen | Einstellungen für die Zustimmung | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.