Comandi SDK PowerShell di Broker

Last published : Nov 03, 2026
È possibile configurare Autoscale per i gruppi di consegna utilizzando l'SDK PowerShell di Broker. Per configurare Autoscale utilizzando i comandi PowerShell, è necessario utilizzare l'SDK PowerShell remoto versione 7.21.0.12 o successiva. Per ulteriori informazioni sull'SDK PowerShell remoto, vedere SDK e API.
Related information
Autoscale™

Set-BrokerDesktopGroup

Disabilita o abilita un BrokerDesktopGroup esistente o ne modifica le impostazioni

Per ulteriori informazioni su questo cmdlet, vedere <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 consegna 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 consegna il cui nome è "MyDesktop". Utilizzare il comando PowerShell Set-BrokerDesktopGroup. Ad esempio:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakBufferSizePercent 20 -OffPeakBufferSizePercent 10
Configurare l'timeout di disconnessione impostazione:
  • Si supponga di voler impostare il valore 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 consegna 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 quando disconnesso:
  • Si supponga di voler impostare il valore di timeout quando disconnesso a 60 minuti per i periodi di punta e a 30 minuti per i periodi non di punta per un gruppo di consegna 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 consegna 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 consegna 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 orario dell'istanza macchina a 0,2 dollari per un gruppo di consegna il cui nome è "MyDesktop". Utilizzare il comando PowerShell Set-BrokerDesktopGroup. Ad esempio:
    • PS C:\> Set-BrokerDesktopGroup "MyDesktop" -MachineCost 0.2
Escludere le VM in modalità di manutenzione dal pool di autoscale:
  • Si consideri un gruppo di consegna con 10 macchine, di cui 2 in modalità di manutenzione. La capacità del buffer di Autoscale è impostata al 50%. Se si desidera escludere le VM in modalità di manutenzione dal pool di autoscale, impostare PoolSizeExcludesMaintenanceMode su True. Autoscale avvia quindi 4 macchine poiché le 2 macchine in modalità di manutenzione non sono incluse nel pool di macchine. Utilizzare il comando PowerShell Set-BrokerDesktopGroup. Ad esempio:
    PS C:\> Set-BrokerDesktopGroup -PoolSizeExcludesMaintenanceMode $true
    Il valore predefinito per PoolSizeExcludesMaintenanceMode per i gruppi di consegna a sessione singola è False.
    Il valore predefinito per PoolSizeExcludesMaintenanceMode per i gruppi di consegna a sessione multipla è True.

New-BrokerPowerTimeScheme

Crea un BrokerPowerTimeScheme per un gruppo di consegna. Per maggiori informazioni, vedere <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 consegna il cui valore UID è 3. Il nuovo schema copre il fine settimana, lunedì e 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 di Broker PowerShell SDK sono stati estesi per i timeout di sessione dinamici supportando più 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 consegna solo durante l'orario di punta.
  • DisconnectOffPeakIdleSessionAfterSeconds - Rappresenta il tempo in secondi dopo il quale una sessione inattiva viene disconnessa durante le ore non di punta. Il valore predefinito di questa proprietà è 0, che indica la disabilitazione del comportamento associato durante le ore non di punta. Un valore maggiore di 0 abilita il comportamento associato per il gruppo di consegna solo durante le ore 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 comportamento associato per il gruppo di consegna solo durante l'orario di punta.
  • LogoffOffPeakDisconnectedSessionAfterSeconds - Rappresenta il tempo in secondi dopo il quale una sessione disconnessa viene terminata durante le ore non di punta. Il valore predefinito di questa proprietà è 0, che indica la disabilitazione del comportamento associato durante le ore non di punta. Un valore maggiore di 0 abilita il comportamento associato per il gruppo di consegna solo durante le ore non di punta.

Esempio

Supponiamo di voler impostare il timeout della sessione inattiva a 3.600 secondi durante gli orari di punta per un gruppo di consegna il cui nome è "MyDesktop". Utilizzare il comando PowerShell Set-BrokerDesktopGroup. Ad esempio:
  • C:\PS> Set-BrokerDesktopGroup "MyDesktop" -DisconnectOffPeakIdleSessionAfterSeconds 3600
In questo modo vengono disconnesse le sessioni che sono rimaste inattive per più di 1 ora durante le ore non di punta per il gruppo desktop il cui nome è "MyDesktop".