Broker PowerShell SDK-Befehle

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 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

Siehe die folgenden Beispiele für Details zur Verwendung der PowerShell-Cmdlets.

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

Konfigurieren Sie den Kapazitätspuffer separat für Spitzen- und Nebenzeiten

• Angenommen, Sie möchten den Kapazitätspuffer für Spitzenzeiten auf 20 % und für Nebenzeiten auf 10 % für eine Bereitstellungsgruppe mit dem Namen „MyDesktop“ festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:
  • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakBufferSizePercent 20 -OffPeakBufferSizePercent 10

Konfigurieren Sie die Einstellung für das Trennungs-Timeout

• Angenommen, Sie möchten den Wert für das Trennungs-Timeout für Spitzenzeiten auf 60 Minuten und für Nebenzeiten auf 30 Minuten für eine Bereitstellungsgruppe mit dem Namen „MyDesktop“ festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Zum Beispiel:
  • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakDisconnectTimeout 60 -OffPeakDisconnectTimeout 30

Konfigurieren Sie die Einstellung Zeitüberschreitung bei Abmeldung

• Angenommen, Sie möchten den Wert für die Zeitüberschreitung bei Abmeldung auf 60 Minuten für Spitzenzeiten und 30 Minuten für Nebenzeiten für eine Bereitstellungsgruppe namens „MyDesktop“ festlegen. Verwenden Sie den Set-BrokerDesktopGroup PowerShell-Befehl. Zum Beispiel:
  • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakLogOffTimeout 60 -OffPeakLogOffTimeout 30

Konfigurieren Sie die Einstellung Ausschaltverzögerung

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

Konfigurieren Sie die Einstellung Kosten für Maschineninstanz

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

VMs im Wartungsmodus aus dem Autoscale-Pool ausschließen

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

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

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

  Der Standardwert für PoolSizeExcludesMaintenanceMode für die 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 Energiezeitschema für eine Bereitstellungsgruppe erstellen, deren UID-Wert 3 ist. 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 Set-BrokerDesktopGroup PowerShell-Befehl 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 – Stellt die Zeit in Sekunden dar, 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 – Stellt die Zeit in Sekunden dar, 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 – Stellt die Zeit in Sekunden dar, 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 – Stellt die Zeit in Sekunden dar, 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 länger als 1 Stunde inaktiv waren, für die Desktopgruppe mit dem Namen „MyDesktop“.