Citrix DaaS™

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 Remote PowerShell SDK Version 7.21.0.12 oder höher verwenden. Weitere Informationen zum Remote PowerShell SDK 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

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`. Beispiel:
-  `PS C:\> Set-BrokerDesktopGroup "MyDesktop" -AutoscalingEnabled $true`

-  **Kapazitätspuffer separat für Spitzen- und Nebenlastzeiten 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 Nebenlastzeiten festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakBufferSizePercent 20 -OffPeakBufferSizePercent 10

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 Nebenlastzeiten festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakDisconnectTimeout 60 -OffPeakDisconnectTimeout 30

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 Nebenlastzeiten festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakLogOffTimeout 60 -OffPeakLogOffTimeout 30

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. 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 mit dem Namen „MyDesktop“ erst nach 30 Minuten wirksam wird. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Beispiel:
    • C:\PS> Set-BrokerDesktopGroup "MyDesktop" -SettlementPeriodBeforeAutoShutdown 30.
  • Einstellung für die Kosten für Maschineninstanz konfigurieren:

  • Angenommen, Sie möchten die Kosten pro Stunde für eine Maschineninstanz für eine Bereitstellungsgruppe mit dem Namen „MyDesktop“ auf 0,2 Dollar festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. 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 2 Maschinen im Wartungsmodus sind. 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. Beispiel:

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

    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 einen Energiezeitplan für eine Bereitstellungsgruppe erstellen, deren UID-Wert 3 ist. Der neue Plan umfasst das Wochenende, Montag und Dienstag. Der Zeitraum von 8:00 Uhr bis 18:30 Uhr ist als Spitzenzeit für die im Plan enthaltenen Tage definiert. Für Spitzenzeiten beträgt die Poolgröße (die Anzahl der eingeschalteten Maschinen) 20. Für Nebenlastzeiten beträgt sie 5. Sie können den PowerShell-Befehl Set-BrokerDesktopGroup verwenden. 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 erweitert, indem sie mehrere neue Parameter unterstützen:

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

  • DisconnectOffPeakIdleSessionAfterSeconds – Stellt die Zeit in Sekunden dar, nach der eine inaktive Sitzung während der Nebenlastzeiten getrennt wird. Der Standardwert dieser Eigenschaft ist 0, was die Deaktivierung des zugehörigen Verhaltens während der Nebenlastzeiten anzeigt. Ein Wert größer als 0 aktiviert das zugehörige Verhalten für die Bereitstellungsgruppe nur während der Nebenlastzeiten.

  • 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 während der Nebenlastzeiten beendet wird. Der Standardwert dieser Eigenschaft ist 0, was die Deaktivierung des zugehörigen Verhaltens während der Nebenlastzeiten anzeigt. Ein Wert größer als 0 aktiviert das zugehörige Verhalten für die Bereitstellungsgruppe nur während der Nebenlastzeiten.

Beispiel

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

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

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

Broker PowerShell SDK-Befehle