Citrix Virtual Apps and Desktops

Commandes du SDK PowerShell Broker

April 8, 2026

Contributeur:

C C

Vous pouvez configurer Autoscale pour les groupes de mise à disposition à l’aide du SDK PowerShell Broker. Pour configurer Autoscale à l’aide des commandes PowerShell, vous devez utiliser la version 7.21.0.12 ou ultérieure du SDK PowerShell. Pour plus d’informations sur les SDK PowerShell, consultez SDK et API.

Set-BrokerDesktopGroup

Désactive ou active un BrokerDesktopGroup existant ou modifie ses paramètres. Pour plus d’informations sur cette cmdlet, consultez https://citrix.github.io/delivery-controller-sdk/Broker/Set-BrokerDesktopGroup/.

-  ### Exemples

-  Consultez les exemples suivants pour plus de détails sur l'utilisation des cmdlets PowerShell.

Activer Autoscale™

Supposons que vous souhaitiez activer Autoscale pour le groupe de mise à disposition dont le nom est « MyDesktop ». Utilisez la commande PowerShell Set-BrokerDesktopGroup. Par exemple :
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -AutoscalingEnabled $true
- Configurer le tampon de capacité séparément pour les heures de pointe et les heures creuses
- Supposons que vous souhaitiez définir le tampon de capacité à 20 % pour les heures de pointe et à 10 % pour les heures creuses pour un groupe de mise à disposition dont le nom est « MyDesktop ». Utilisez la commande PowerShell Set-BrokerDesktopGroup. Par exemple :
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakBufferSizePercent 20 -OffPeakBufferSizePercent 10
- Configurer le paramètre délai d’expiration de la déconnexion
Supposons que vous souhaitiez définir la valeur du délai d’expiration de la déconnexion à 60 minutes pour les heures de pointe et à 30 minutes pour les heures creuses pour un groupe de mise à disposition dont le nom est « MyDesktop ». Utilisez la commande PowerShell Set-BrokerDesktopGroup. Par exemple :
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakDisconnectTimeout 60 -OffPeakDisconnectTimeout 30

Configurer le paramètre délai d’expiration de la fermeture de session

Supposons que vous souhaitiez définir la valeur du délai d’expiration de la fermeture de session à 60 minutes pour les heures de pointe et à 30 minutes pour les heures creuses pour un groupe de mise à disposition dont le nom est « MyDesktop ». Utilisez la commande PowerShell Set-BrokerDesktopGroup. Par exemple :
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PeakLogOffTimeout 60 -OffPeakLogOffTimeout 30

Configurer le paramètre délai de mise hors tension

Supposons que vous souhaitiez définir le délai de mise hors tension à 15 minutes pour un groupe de mise à disposition dont le nom est « MyDesktop ». Utilisez la commande PowerShell Set-BrokerDesktopGroup. Par exemple :
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -PowerOffDelay 15
Configurer une période pendant laquelle le délai de mise hors tension ne prend pas effet
- Supposons que vous souhaitiez que le délai de mise hors tension prenne effet après 30 minutes pour un groupe de mise à disposition dont le nom est « MyDesktop ». Utilisez la commande PowerShell Set-BrokerDesktopGroup. Par exemple :
- C:\PS> Set-BrokerDesktopGroup "MyDesktop" -SettlementPeriodBeforeAutoShutdown 30.
Configurer le paramètre coût de l’instance de machine
Supposons que vous souhaitiez définir le coût de l’instance de machine par heure à 0,2 dollar pour un groupe de mise à disposition dont le nom est « MyDesktop ». Utilisez la commande PowerShell Set-BrokerDesktopGroup. Par exemple :
- PS C:\> Set-BrokerDesktopGroup "MyDesktop" -MachineCost 0.2
Exclure les machines virtuelles en mode maintenance du pool Autoscale
Considérez un groupe de mise à disposition avec 10 machines, dont 2 sont en mode maintenance. La capacité tampon d’Autoscale est définie à 50 %. Supposons que vous souhaitiez exclure les machines virtuelles en mode maintenance du pool Autoscale, définissez alors PoolSizeExcludesMaintenanceMode sur True. Autoscale démarre alors 4 machines, car les 2 machines en mode maintenance ne sont pas incluses dans le pool de machines. Utilisez la commande PowerShell Set-BrokerDesktopGroup. Par exemple :
- PS C:\> Set-BrokerDesktopGroup -PoolSizeExcludesMaintenanceMode $true
La valeur par défaut de PoolSizeExcludesMaintenanceMode pour les groupes de mise à disposition à session unique est False.

La valeur par défaut de PoolSizeExcludesMaintenanceMode pour les groupes de mise à disposition multi-sessions est True.

New-BrokerPowerTimeScheme

Crée un BrokerPowerTimeScheme pour un groupe de mise à disposition. Pour plus d’informations, consultez https://citrix.github.io/delivery-controller-sdk/Broker/New-BrokerPowerTimeScheme/.

Exemple

Supposons que vous souhaitiez créer un schéma de temps d’alimentation pour un groupe de mise à disposition dont la valeur UID est 3. Le nouveau schéma couvre le week-end, le lundi et le mardi. La plage horaire de 8h00 à 18h30 est définie comme heures de pointe pour les jours inclus dans le schéma. Pour les heures de pointe, la taille du pool (le nombre de machines maintenues sous tension) est de 20. Pour les heures creuses, elle est de 5. Vous pouvez utiliser la commande PowerShell Set-BrokerDesktopGroup. Par exemple :

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

Paramètres pour les délais d’expiration de session dynamiques

Les cmdlets du SDK PowerShell Broker suivantes ont été étendues pour les délais d’expiration de session dynamiques en prenant en charge plusieurs nouveaux paramètres :

Get-BrokerDesktopGroup
New-BrokerDesktopGroup
Set-BrokerDesktopGroup

Ces paramètres incluent :

DisconnectPeakIdleSessionAfterSeconds – Représente le temps en secondes après lequel une session inactive est déconnectée pendant les heures de pointe. Cette propriété a une valeur par défaut de 0, ce qui indique la désactivation de son comportement associé pendant les heures de pointe. Une valeur supérieure à 0 active son comportement pour le groupe de mise à disposition uniquement pendant les heures de pointe.
DisconnectOffPeakIdleSessionAfterSeconds - Représente le temps en secondes après lequel une session inactive est déconnectée pendant les heures creuses. La valeur par défaut de cette propriété est 0, ce qui indique la désactivation de son comportement associé pendant les heures creuses. Une valeur supérieure à 0 active son comportement associé pour le groupe de mise à disposition uniquement pendant les heures creuses.
LogoffPeakDisconnectedSessionAfterSeconds - Représente le temps en secondes après lequel une session déconnectée est terminée pendant les heures de pointe. La valeur par défaut de cette propriété est 0, ce qui indique la désactivation de son comportement associé pendant les heures de pointe. Une valeur supérieure à 0 active son comportement associé pour le groupe de mise à disposition uniquement pendant les heures de pointe.
LogoffOffPeakDisconnectedSessionAfterSeconds - Représente le temps en secondes après lequel une session déconnectée est terminée pendant les heures creuses. La valeur par défaut de cette propriété est 0, ce qui indique la désactivation de son comportement associé pendant les heures creuses. Une valeur supérieure à 0 active son comportement associé pour le groupe de mise à disposition uniquement pendant les heures creuses.

Exemple

Supposons que vous souhaitiez définir le délai d’expiration de session inactive à 3 600 secondes pendant les heures de pointe pour un groupe de mise à disposition dont le nom est « MyDesktop ». Utilisez la commande PowerShell Set-BrokerDesktopGroup. Par exemple :

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

Cela déconnecte les sessions qui sont restées inactives pendant plus d’une heure en heures creuses pour le groupe de bureaux dont le nom est « MyDesktop ».

La version officielle de ce document est en anglais. Certains contenus de la documentation Cloud Software Group ont été traduits de façon automatique à des fins pratiques uniquement. Cloud Software Group n'exerce aucun contrôle sur le contenu traduit de façon automatique, qui peut contenir des erreurs, des imprécisions ou un langage inapproprié. Aucune garantie, explicite ou implicite, n'est fournie quant à l'exactitude, la fiabilité, la pertinence ou la justesse de toute traduction effectuée depuis l'anglais d'origine vers une autre langue, ou quant à la conformité de votre produit ou service Cloud Software Group à tout contenu traduit de façon automatique, et toute garantie fournie en vertu du contrat de licence de l'utilisateur final ou des conditions d'utilisation des services applicables, ou de tout autre accord avec Cloud Software Group, quant à la conformité du produit ou service à toute documentation ne s'applique pas dans la mesure où cette documentation a été traduite de façon automatique. Cloud Software Group ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

Cela vous a-t-il été utile ?

Commandes du SDK PowerShell Broker

April 8, 2026

Contributeur:

C C

April 8, 2026

Contributeur:

C C

Dans cet article

Set-BrokerDesktopGroup
New-BrokerPowerTimeScheme
Paramètres pour les délais d’expiration de session dynamiques

Cela vous a-t-il été utile ?