Citrix Virtual Apps and Desktops

Broker PowerShell SDK-Befehle

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.

Set-BrokerDesktopGroup

Deaktiviert oder aktiviert 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 verdeutlichen die Verwendung der PowerShell-Cmdlets:

Autoscale aktivieren

  • Angenommen, Sie möchten Autoscale für die Bereitstellungsgruppe “MyDesktop” aktivieren. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -AutoscalingEnabled $true

Kapazitätspuffer für Spitzen- und Nebenzeiten separat festlegen

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

Einstellung Timeout für “Wenn getrennt” konfigurieren

  • Angenommen, Sie möchten für die Bereitstellungsgruppe “MyDesktop” den Wert Timeout für “Wenn getrennt” auf 60 Minuten für Spitzenzeiten und auf 30 Minuten für Nebenzeiten festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakDisconnectTimeout 60 -OffPeakDisconnectTimeout 30

Einstellung Timeout für “Wenn abgemeldet” konfigurieren

  • Angenommen, Sie möchten für die Bereitstellungsgruppe “MyDesktop” den Wert Timeout für “Wenn abgemeldet” auf 60 Minuten für Spitzenzeiten und auf 30 Minuten für Nebenzeiten festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakLogOffTimeout 60 -OffPeakLogOffTimeout 30

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. Beispiel:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PowerOffDelay 15

Konfigurieren eines Zeitraums, in dem die Ausschaltverzögerung nicht angewendet wird

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

Eigenschaft Maschineninstanzkosten konfigurieren

  • Angenommen, Sie möchten für die Bereitstellungsgruppe “MyDesktop” die Maschineninstanzkosten pro Stunde auf 0,2 Dollar festlegen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. 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 Energiezeitschema für die Bereitstellungsgruppe mit dem UID-Wert 3 erstellen. Das neue Schema gilt für Wochenenden, Montage und Dienstage. Der Zeitraum von 8:00 bis 18:30 Uhr gilt als Spitzenzeit für die Tage im ausgewählten Zeitplan. Für Spitzenzeiten beträgt die Poolgröße (die Anzahl der eingeschalteten Maschinen) 20. Für Nebenzeiten sind es 5 Maschinen. 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 Sitzungstimeouts

Die folgenden Broker PowerShell SDK-Cmdlets wurden für dynamische Sitzungstimeouts erweitert, indem mehrere neue Parameter unterstützt werden:

  • Get-BrokerDesktopGroup
  • New-BrokerDesktopGroup
  • Set-BrokerDesktopGroup

Zu diesen Parametern gehören:

  • DisconnectPeakIdleSessionAfterSeconds: Zeit in Sekunden, nach der eine Leerlaufsitzung während der Spitzenzeit getrennt wird. Die Eigenschaft hat den Standardwert 0 und das zugehörige Verhalten während der Spitzenzeit ist somit deaktiviert. Ein Wert über 0 aktiviert das Verhalten für die Bereitstellungsgruppe während der Spitzenzeit.

  • DisconnectOffPeakIdleSessionAfterSeconds: Zeit in Sekunden, nach der eine Leerlaufsitzung während der Nebenzeit getrennt wird. Die Eigenschaft hat den Standardwert 0 und das zugehörige Verhalten während der Nebenzeit ist somit deaktiviert. Ein Wert über 0 aktiviert das Verhalten für die Bereitstellungsgruppe während der Nebenzeit.

  • LogoffPeakDisconnectedSessionAfterSeconds: Zeit in Sekunden, nach der eine getrennte Sitzung während der Spitzenzeit beendet wird. Die Eigenschaft hat den Standardwert 0 und das zugehörige Verhalten während der Spitzenzeit ist somit deaktiviert. Ein Wert über 0 aktiviert das Verhalten für die Bereitstellungsgruppe während der Spitzenzeit.

  • LogoffOffPeakDisconnectedSessionAfterSeconds: Zeit in Sekunden, nach der eine getrennte Sitzung während der Nebenzeit beendet wird. Die Eigenschaft hat den Standardwert 0 und das zugehörige Verhalten während der Nebenzeit ist somit deaktiviert. Ein Wert über 0 aktiviert das Verhalten für die Bereitstellungsgruppe während der Nebenzeit.

Beispiel

Einsatzbeispiel: Sie möchten das Timeout für Leerlaufsitzungen während der Spitzenzeit für die Bereitstellungsgruppe “MyDesktop” auf 3.600 Sekunden einstellen. Verwenden Sie den PowerShell-Befehl Set-BrokerDesktopGroup. Beispiel:

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

Dadurch werden in der Nebenzeit Sitzungen der Bereitstellungsgruppe “MyDesktop” getrennt, die länger als eine Stunde im Leerlauf sind.

Broker PowerShell SDK-Befehle