New-RdsHostPool
Crée un pool d’hôtes.
Syntaxe
Default (Par défaut)
New-RdsHostPool
[-TenantName] <String>
[-Name] <String>
[-ValidationEnv <bool>]
[-Ring <int>]
[-Description <String>]
[-FriendlyName <String>]
[-Persistent]
[<CommonParameters>]
Description
Crée un pool d’hôtes au sein d’un locataire. Le pool d’hôtes contient un ou plusieurs hôtes de session auxquels les utilisateurs peuvent se connecter pour exécuter des programmes, enregistrer des fichiers et utiliser des ressources sur ces hôtes.
Au moment de la création, vous pouvez décider de créer un pool d’hôtes persistant à l’aide de l’indicateur persistant. En créant un pool d’hôtes persistant, l’utilisateur se connectera toujours au même hôte de session pour ses sessions. Si vous n’utilisez pas cet indicateur, un pool d’hôtes regroupé est créé. Dans un pool d’hôtes regroupé, les utilisateurs sont connectés à un hôte de session dans le pool qui est sélectionné dynamiquement par l’équilibreur de charge.
Exemples
Exemple 1 : Création d’un pool d’hôtes regroupé
PS C:\> New-RdsHostPool -TenantName "contoso" -Name "contosoHostPool"
TenantName : contoso
TenantGroupName : Default Tenant Group
HostPoolName : contosoHostPool
FriendlyName :
Description :
Persistent : False
CustomRdpProperty :
MaxSessionLimit : 999999
LoadBalancerType : BreadthFirst
ValidationEnv : False
Ring :
AssignmentType :
Cette commande crée un nouveau pool d’hôtes regroupé dans le locataire spécifié. Le pool d’hôtes est rempli avec des valeurs prédéfinies. Pour modifier ces valeurs, exécutez l’applet de commande Set-RdsHostPool.
Exemple 2 : Création d’un pool d’hôtes de poste de travail personnel
PS C:\> New-RdsHostPool -TenantName "contoso" -Name "contosoPersonal" -Persistent
TenantName : contoso
TenantGroupName : Default Tenant Group
HostPoolName : contosoPersonal
FriendlyName :
Description :
Persistent : True
CustomRdpProperty :
MaxSessionLimit : 999999
LoadBalancerType : Persistent
ValidationEnv : False
Ring :
AssignmentType : Automatic
Cette commande crée un pool d’hôtes de poste de travail personnel dans le locataire spécifié. Si vous ne fournissez pas le type d’attribution lors de l’exécution de la commande, le pool d’hôtes de poste de travail personnel est défini sur l’attribution automatique. Pour modifier le type d’attribution ou toute autre propriété du pool d’hôtes, exécutez l’applet de commande Set-RdsHostPool.
Exemple 3 : Création d’un pool d’hôtes de validation
PS C:\> New-RdsHostPool -TenantName "contoso" -Name "contosoValidation" -ValidationEnv $true
TenantName : contoso
TenantGroupName : Default Tenant Group
HostPoolName : contosoValidation
FriendlyName :
Description :
Persistent : False
CustomRdpProperty :
MaxSessionLimit : 999999
LoadBalancerType : Persistent
ValidationEnv : True
Ring :
AssignmentType : Automatic
Cette commande crée un nouveau pool d’hôtes de validation dans le locataire spécifié. 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. Pour modifier le pool d’hôtes afin qu’il ne soit plus un pool d’hôtes de validation, exécutez l’applet de commande Set-RdsHostPool.
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 |
-Description
Chaîne de 512 caractères qui décrit le HostPool pour aider les administrateurs. Tout caractère est autorisé.
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: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-FriendlyName
Chaîne de 256 caractères destinée aux utilisateurs finaux. Tout caractère est autorisé.
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: | 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, qui doit être unique dans le locataire.
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 |
-Persistent
Un commutateur indiquant de marquer le pool d’hôtes comme persistant.
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
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| 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.