Documentazione dei prodotti
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Visualizza PDF

Comandi PowerShell SDK di Broker

January 23, 2026
Grazie al contributo di: 
C

È possibile configurare Autoscale per i gruppi di consegna utilizzando il PowerShell SDK di Broker. Per configurare Autoscale tramite i comandi PowerShell, è necessario utilizzare la versione 7.21.0.12 o successiva del PowerShell SDK. Per maggiori informazioni sugli SDK PowerShell, 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

Consultare i seguenti esempi per 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’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 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 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 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 siano 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 dell’istanza macchina per ora 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

New-BrokerPowerTimeScheme

Crea uno schema temporale di alimentazione (BrokerPowerTimeScheme) per un gruppo di consegna. 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 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 periodo di punta per i giorni inclusi nello schema. Per i periodi di punta, la dimensione del pool (il numero di macchine mantenute accese) è 20. Per i periodi 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 del PowerShell SDK di Broker 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 il periodo di punta. Questa proprietà ha un valore predefinito di 0, che indica la disabilitazione del comportamento associato durante il periodo di punta. Un valore maggiore di 0 abilita il suo comportamento per il gruppo di consegna solo durante il periodo 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 il periodo non di punta. Un valore maggiore di 0 abilita il suo 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 il periodo di punta. Il valore predefinito di questa proprietà è 0, che indica la disabilitazione del comportamento associato durante il periodo di punta. Un valore maggiore di 0 abilita il suo comportamento associato per il gruppo di consegna solo durante il periodo 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 il periodo non di punta. Un valore maggiore di 0 abilita il suo comportamento associato per il gruppo di consegna solo durante le ore non di punta.

Esempio

Si supponga di voler impostare il timeout di sessione inattiva a 3.600 secondi durante i periodi 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

Ciò disconnette le sessioni che sono rimaste inattive per più di 1 ora nel periodo non di punta per il gruppo desktop il cui nome è “MyDesktop”.

Comandi PowerShell SDK di Broker
January 23, 2026
Grazie al contributo di: 
C
January 23, 2026
Grazie al contributo di: 
C

In questo articolo

Feedback sito | Your privacy choices footer linkScelte di privacy | Privacy e condizioni legali | Preferenze cookie | Impostazioni di consenso | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.