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