Citrix DaaS™

Comandi SDK PowerShell Broker

September 16, 2025

Grazie al contributo di:

C C

È possibile configurare Autoscale per i gruppi di distribuzione utilizzando l’SDK PowerShell Broker. Per configurare Autoscale utilizzando i comandi PowerShell, è necessario utilizzare l’SDK PowerShell remoto versione 7.21.0.12 o successiva. Per maggiori informazioni sull’SDK PowerShell remoto, consultare SDK e API.

Set-BrokerDesktopGroup

Disabilita o abilita un BrokerDesktopGroup esistente o ne modifica le impostazioni. Per maggiori informazioni su questo cmdlet, consultare https://citrix.github.io/delivery-controller-sdk/Broker/Set-BrokerDesktopGroup/.

Esempi

Vedere gli esempi seguenti per i dettagli su come utilizzare i cmdlet PowerShell.

Abilitare Autoscale™

Si supponga di voler abilitare Autoscale per il gruppo di distribuzione il cui nome è “MyDesktop”. Utilizzare il comando PowerShell Set-BrokerDesktopGroup. Ad esempio:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -AutoscalingEnabled $true

Configurare il buffer di capacità separatamente per i periodi di punta e non di punta

Si supponga di voler impostare il buffer di capacità al 20% per i periodi di punta e al 10% per i periodi non di punta per un gruppo di distribuzione il cui nome è “MyDesktop”. Utilizzare il comando PowerShell Set-BrokerDesktopGroup. Ad esempio:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakBufferSizePercent 20 -OffPeakBufferSizePercent 10

Configurare l’impostazione timeout di disconnessione

Si supponga di voler impostare il valore del timeout di disconnessione a 60 minuti per i periodi di punta e a 30 minuti per i periodi non di punta per un gruppo di distribuzione il cui nome è “MyDesktop”. Utilizzare il comando PowerShell Set-BrokerDesktopGroup. Ad esempio:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakDisconnectTimeout 60 -OffPeakDisconnectTimeout 30

Configurare l’impostazione timeout di disconnessione utente

Si supponga di voler impostare il valore del timeout di disconnessione utente a 60 minuti per i periodi di punta e a 30 minuti per i periodi non di punta per un gruppo di distribuzione il cui nome è “MyDesktop”. Utilizzare il comando PowerShell Set-BrokerDesktopGroup. Ad esempio:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakLogOffTimeout 60 -OffPeakLogOffTimeout 30

Configurare l’impostazione ritardo spegnimento

Si supponga di voler impostare il ritardo di spegnimento a 15 minuti per un gruppo di distribuzione il cui nome è “MyDesktop”. Utilizzare il comando PowerShell Set-BrokerDesktopGroup. Ad esempio:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PowerOffDelay 15

Configurare un periodo di tempo durante il quale il ritardo di spegnimento non ha effetto

Si supponga di voler che il ritardo di spegnimento abbia effetto fino a quando non sono trascorsi 30 minuti per un gruppo di distribuzione il cui nome è “MyDesktop”. Utilizzare il comando PowerShell Set-BrokerDesktopGroup. Ad esempio:
- C:\PS> Set-BrokerDesktopGroup "MyDesktop" -SettlementPeriodBeforeAutoShutdown 30.

Configurare l’impostazione costo istanza macchina

Si supponga di voler impostare il costo dell’istanza macchina per ora a 0,2 dollari per un gruppo di distribuzione il cui nome è “MyDesktop”. Utilizzare il comando PowerShell Set-BrokerDesktopGroup. Ad esempio:
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -MachineCost 0.2

New-BrokerPowerTimeScheme

Crea uno schema BrokerPowerTimeScheme per un gruppo di distribuzione. Per maggiori informazioni, consultare https://citrix.github.io/delivery-controller-sdk/Broker/New-BrokerPowerTimeScheme/.

Esempio

Si supponga di voler creare uno schema temporale di alimentazione per un gruppo di distribuzione il cui valore UID è 3. Il nuovo schema copre il fine settimana, il lunedì e il martedì. La fascia oraria dalle 8:00 alle 18:30 è definita come orario di punta per i giorni inclusi nello schema. Per gli orari di punta, la dimensione del pool (il numero di macchine mantenute accese) è 20. Per gli orari non di punta, è 5. È possibile utilizzare il comando PowerShell Set-BrokerDesktopGroup. Ad esempio:

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

Parametri per i timeout di sessione dinamici

I seguenti cmdlet dell’SDK PowerShell Broker sono stati estesi per i timeout di sessione dinamici supportando diversi nuovi parametri:

Get-BrokerDesktopGroup
New-BrokerDesktopGroup
Set-BrokerDesktopGroup

Questi parametri includono:

DisconnectPeakIdleSessionAfterSeconds – Rappresenta il tempo in secondi dopo il quale una sessione inattiva viene disconnessa durante l’orario di punta. Questa proprietà ha un valore predefinito di 0, che indica la disabilitazione del comportamento associato durante l’orario di punta. Un valore maggiore di 0 abilita il suo comportamento per il gruppo di distribuzione solo durante l’orario di punta.
DisconnectOffPeakIdleSessionAfterSeconds - Rappresenta il tempo in secondi dopo il quale una sessione inattiva viene disconnessa durante gli orari non di punta. Il valore predefinito di questa proprietà è 0, che indica la disabilitazione del comportamento associato durante gli orari non di punta. Un valore maggiore di 0 abilita il suo comportamento associato per il gruppo di distribuzione solo durante gli orari non di punta.
LogoffPeakDisconnectedSessionAfterSeconds - Rappresenta il tempo in secondi dopo il quale una sessione disconnessa viene terminata durante l’orario di punta. Il valore predefinito di questa proprietà è 0, che indica la disabilitazione del comportamento associato durante l’orario di punta. Un valore maggiore di 0 abilita il suo comportamento associato per il gruppo di distribuzione solo durante l’orario di punta.
LogoffOffPeakDisconnectedSessionAfterSeconds - Rappresenta il tempo in secondi dopo il quale una sessione disconnessa viene terminata durante gli orari non di punta. Il valore predefinito di questa proprietà è 0, che indica la disabilitazione del comportamento associato durante gli orari non di punta. Un valore maggiore di 0 abilita il suo comportamento associato per il gruppo di distribuzione solo durante gli orari non di punta.

Esempio

Si supponga di voler impostare il timeout della sessione inattiva a 3.600 secondi durante gli orari di punta per un gruppo di distribuzione il cui nome è “MyDesktop”. Utilizzare il comando PowerShell Set-BrokerDesktopGroup. Ad esempio:

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

In questo modo le sessioni che sono rimaste inattive per più di 1 ora negli orari non di punta per il gruppo desktop il cui nome è “MyDesktop” verranno disconnesse.

La versione ufficiale di questo contenuto è in inglese. Per alcuni dei contenuti della documentazione Cloud Software Group è stata impiegata la traduzione automatica solo per comodità. Cloud Software Group non ha alcun controllo sui contenuti tradotti in modo automatico, che possono contenere errori, imprecisioni o linguaggio inadatto. Non viene offerta alcuna garanzia di alcun tipo, espressa o implicita, circa l'accuratezza, l'affidabilità, l'idoneità o la correttezza di qualsiasi traduzione dall'originale inglese in qualsiasi altra lingua, o che il prodotto o servizio Cloud Software Group sia conforme a qualsiasi contenuto in traduzione automatica, e qualsiasi garanzia fornita ai sensi del contratto di licenza per l'utente finale applicabile o i termini di servizio, o qualsiasi altro accordo con Cloud Software Group che il prodotto o il servizio sia conforme a qualsiasi documentazione non si applicheranno nella misura in cui tale documentazione sia in traduzione automatica. Cloud Software Group non sarà ritenuta responsabile per eventuali danni o problemi che potrebbero derivare dall'utilizzo di contenuti per cui si è impiegata la traduzione automatica.

È stato utile?

Comandi SDK PowerShell Broker

September 16, 2025

Grazie al contributo di:

C C

September 16, 2025

Grazie al contributo di:

C C

In questo articolo

Set-BrokerDesktopGroup
New-BrokerPowerTimeScheme
Parametri per i timeout di sessione dinamici

È stato utile?