Set-RdsHostPool

Module:

Microsoft.RDInfra.RDPowershell Module

Définit les propriétés d’un pool d’hôtes.

Syntaxe

HP4 (Par défaut)

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-FriendlyName <String>]
    [-Description <String>]
    [-MaxSessionLimit <Int32>]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP5

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-BreadthFirstLoadBalancer]
    [-MaxSessionLimit <Int32>]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP6

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    -MaxSessionLimit <Int32>
    [-DepthFirstLoadBalancer]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP3

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-CustomRdpProperty <String>]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP7

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-ValidationEnv <bool>]
    [-Ring <int>]
    [<CommonParameters>]

Description

L’applet de commande Set-RdsHostPool définit les propriétés du pool d’hôtes spécifié. Trois jeux de paramètres existent pour cette applet de commande. First est utilisé pour désactiver les disques de profil utilisateur. Le second est utilisé pour activer les disques de profil utilisateur. Le troisième est utilisé pour définir toutes les autres propriétés du pool d’hôtes.

Exemples

Exemple 1 : Configurer le pool d’hôtes pour utiliser l’équilibrage de charge en profondeur

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoHostPool" -DepthFirstLoadBalancer -MaxSessionLimit 10

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoHostPool
FriendlyName          :
Description           :
Persistent            : False
CustomRdpProperty     :
MaxSessionLimit       : 10
LoadBalancerType      : DepthFirst
ValidationEnv         : False
Ring                  :
AssignmentType        :

Cette commande définit le pool d’hôtes pour qu’il utilise l’équilibrage de charge en profondeur d’abord, de sorte que les utilisateurs entrants soient tous dirigés vers un hôte de session spécifique jusqu’à ce qu’il atteigne la valeur MaxSessionLimit, qui est spécifiée comme 10 dans cet exemple. Le paramètre MaxSessionLimit est une exigence lors de la définition de l’équilibrage de charge de profondeur, car les connexions ne seront pas distribuées aux hôtes de session suivants tant que cette limite de session n’est pas atteinte sur le premier hôte de session.

Exemple 2 : Configurer le pool d’hôtes pour utiliser l’équilibrage de charge en termes de largeur d’abord

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoHostPool" -BreadthFirstLoadBalancer

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoHostPool
FriendlyName          :
Description           :
Persistent            : False
CustomRdpProperty     :
MaxSessionLimit       : 10
LoadBalancerType      : BreadthFirst
ValidationEnv         : False
Ring                  :
AssignmentType        :

Cette commande définit le pool d’hôtes pour qu’il utilise l’équilibrage de charge en fonction de la largeur, de sorte que les utilisateurs entrants soient dirigés uniformément entre les hôtes de session du pool d’hôtes. Le paramètre MaxSessionLimit est facultatif, car l’équilibrage de charge en mode de profondeur d’abord est moins restrictif que l’équilibrage de charge en mode de profondeur d’abord.

Exemple 3 : Définir le pool d’hôtes à traiter comme un environnement de validation

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoHostPool" -ValidationEnv $true

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoHostPool
FriendlyName          :
Description           :
Persistent            : False
CustomRdpProperty     : use multimon:i:0;
MaxSessionLimit       : 10
LoadBalancerType      : BreadthFirst
ValidationEnv         : True
Ring                  :
AssignmentType        :

Cette commande définit le pool d’hôtes comme un pool d’hôtes de validation. Le pool d’hôtes de validation reçoit les mises à jour de service à une cadence plus rapide, ce qui vous permet de tester les modifications de service avant qu’elles ne soient déployées à grande échelle en production.

Exemple 4 : Définir le pool d’hôtes pour utiliser l’attribution directe

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoPersonalDesktops" -AssignmentType Direct

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoPersonalDesktops
FriendlyName          :
Description           :
Persistent            : True
CustomRdpProperty     :
MaxSessionLimit       : 999999
LoadBalancerType      : Persistent
ValidationEnv         : False
Ring                  :
AssignmentType        : Direct

Cette commande définit le pool d’hôtes pour qu’il utilise l’attribution directe afin de déterminer l’hôte de session de bureau personnel à attribuer à l’utilisateur. Dans le cas de l’attribution directe, l’utilisateur doit être affecté à un hôte de session avant de se connecter au pool d’hôtes.

Exemple 5 : Configurer le pool d’hôtes pour qu’il utilise l’attribution automatique

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoPersonalDesktops" -AssignmentType Automatic

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoPersonalDesktops
FriendlyName          :
Description           :
Persistent            : True
CustomRdpProperty     :
MaxSessionLimit       : 999999
LoadBalancerType      : Persistent
ValidationEnv         : False
Ring                  :
AssignmentType        : Automatic

Cette commande définit le pool d’hôtes pour qu’il utilise l’attribution automatique afin de déterminer l’hôte de session de bureau personnel à attribuer à l’utilisateur. Avec l’attribution automatique, il n’est pas nécessaire d’affecter l’utilisateur à un hôte de session avant de se connecter au pool d’hôtes.

Exemple 4 : Définir le pool d’hôtes pour utiliser l’attribution directe

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoPersonalDesktops" -AssignmentType Direct

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoPersonalDesktops
FriendlyName          :
Description           :
Persistent            : True
CustomRdpProperty     :
MaxSessionLimit       : 999999
LoadBalancerType      : Persistent
ValidationEnv         : False
Ring                  :
AssignmentType        : Direct

Cette commande définit le pool d’hôtes pour qu’il utilise l’attribution directe afin de déterminer l’hôte de session de bureau personnel à attribuer à l’utilisateur. Dans le cas de l’attribution directe, l’utilisateur doit être affecté à un hôte de session avant de se connecter au pool d’hôtes.

Exemple 5 : Configurer le pool d’hôtes pour qu’il utilise l’attribution automatique

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoPersonalDesktops" -AssignmentType Automatic

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoPersonalDesktops
FriendlyName          :
Description           :
Persistent            : True
CustomRdpProperty     :
MaxSessionLimit       : 999999
LoadBalancerType      : Persistent
ValidationEnv         : False
Ring                  :
AssignmentType        : Automatic

Cette commande définit le pool d’hôtes pour qu’il utilise l’attribution automatique afin de déterminer l’hôte de session de bureau personnel à attribuer à l’utilisateur. Avec l’attribution automatique, il n’est pas nécessaire d’affecter l’utilisateur à un hôte de session avant de se connecter au pool d’hôtes.

Paramètres

-AssignmentType

Type d’attribution pour le pool d’hôtes de bureau personnel :

• Automatique, ce qui signifie que les utilisateurs se verront automatiquement attribuer un hôte de session lors de leur première connexion au pool d’hôtes.
• Direct, ce qui signifie que les utilisateurs doivent être directement affectés à un hôte de session dans le pool avant de pouvoir se connecter.

Propriétés du paramètre

Type:	PersonalDesktopAssignmentType
Valeur par défaut:	None
Valeurs acceptées:	Automatic, Direct
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-BreadthFirstLoadBalancer

Basculez pour activer l’utilisation de l’équilibrage de charge en fonction de l’étendue pour le pool d’hôtes. La largeur d’abord indique que les nouvelles sessions utilisateur sont dirigées vers l’hôte de session ayant le moins de sessions utilisateur.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

HP5

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-CustomRdpProperty

Spécifie les paramètres RDP (Remote Desktop Protocol) à inclure dans les fichiers .rdp pour tous les programmes RemoteApp et les postes de travail distants publiés dans cette collection. Pour plus d’informations, consultez la section Paramètres de fichier RDP Bureau à distance pris en charge .

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

HP3

Position:	Named
Obligatoire:	False
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-DepthFirstLoadBalancer

Basculez pour activer l’utilisation de l’équilibrage de charge en profondeur pour le pool d’hôtes. Depth-first indique que les nouvelles sessions utilisateur sont dirigées vers l’hôte de session avec le plus grand nombre de sessions utilisateur qui n’a pas encore atteint sa limite de session maximale.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

HP6

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Description

Description du pool d’hôtes.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

HP4

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-FriendlyName

Nom convivial du pool d’hôtes à afficher.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

HP4

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-MaxSessionLimit

Nombre maximal de sessions autorisées par hôte de session dans le pool d’hôtes. Lorsque le mode depth-first est défini pour l’équilibrage de charge, cette valeur est utilisée pour déterminer quand arrêter l’équilibrage de charge des utilisateurs sur un hôte et commencer à envoyer des utilisateurs vers l’hôte suivant.

Propriétés du paramètre

Type:	Int32
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

HP4

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

HP5

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Name

Nom du pool d’hôtes.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	HostPoolName

Jeux de paramètres

(All)

Position:	1
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-TenantName

Nom du client.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	0
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-ValidationEnv

Valeur booléenne indiquant si le pool d’hôtes doit être traité comme un pool d’hôtes de validation. Les pools d’hôtes de validation reçoivent les mises à jour de service à une cadence plus rapide que les pools d’hôtes sans validation, ce qui vous permet de tester les modifications de service avant qu’elles ne soient déployées à grande échelle en production.

Propriétés du paramètre

Type:	String
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

System.String

Sorties

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool