Set-RdsHostPool

Модуль:: Microsoft.RDInfra.RDPowershell

Задает свойства для пула узлов.

Синтаксис

Set-RdsHostPool
   [-TenantName] <String>
   [-Name] <String>
   [-FriendlyName <String>]
   [-Description <String>]
   [-MaxSessionLimit <Int32>]
   [-ValidationEnv <bool>]
   [-AssignmentType {Automatic | Direct}]
   [<CommonParameters>]

Set-RdsHostPool
   [-TenantName] <String>
   [-Name] <String>
   [-BreadthFirstLoadBalancer]
   [-MaxSessionLimit <Int32>]
   [-ValidationEnv <bool>]
   [-AssignmentType {Automatic | Direct}]
   [<CommonParameters>]

Set-RdsHostPool
   [-TenantName] <String>
   [-Name] <String>
   [-DepthFirstLoadBalancer]
   -MaxSessionLimit <Int32>
   [-ValidationEnv <bool>]
    [-AssignmentType {Automatic | Direct}]
   [<CommonParameters>]

Set-RdsHostPool
   [-TenantName] <String>
   [-Name] <String>
   [-CustomRdpProperty <String>]
   [-ValidationEnv <bool>]
   [-AssignmentType {Automatic | Direct}]
   [<CommonParameters>]

Set-RdsHostPool
   [-TenantName] <String>
   [-Name] <String>
   [-ValidationEnv <bool>]
   [-Ring <int>]
   [-AssignmentType {Automatic | Direct}]
   [<CommonParameters>]

Описание

Командлет Set-RdsHostPool задает свойства для указанного пула узлов. Для этого командлета существует три набора параметров. Первый используется для отключения дисков профилей пользователей. Второй используется для включения дисков профилей пользователей. Третий используется для установки всех остальных свойств пула узлов сети.

Примеры

Пример 1: Настройте пул узлов для использования балансировки нагрузки в глубину

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        :

Эта команда настраивает пул узлов на использование балансировки нагрузки в глубину, так что все входящие пользователи будут направляться на определенный узел сеанса до тех пор, пока он не достигнет максимального предела сеансов, который в этом примере указан как 10. Параметр MaxSessionLimit является обязательным требованием при настройке балансировки нагрузки в глубину, так как соединения не будут распределяться между последующими узлами сеансов до тех пор, пока это ограничение не будет достигнуто на первом узле сеанса.

Пример 2: Настройте пул узлов для использования балансировки нагрузки в ширину

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        :

Эта команда настраивает пул узлов на использование балансировки нагрузки в ширину, так что входящие пользователи будут равномерно перенаправлены между узлами сеансов в пуле узлов. Параметр MaxSessionLimit является необязательным, так как балансировка нагрузки в режиме «сначала вширь» менее строга, чем балансировка нагрузки в режиме «сначала в глубину».

Пример 3: Настройка пула узлов, который будет рассматриваться как среда проверки

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        :

Эта команда задает пул узлов в качестве пула проверяемых узлов. Пул проверяемых узлов будет получать обновления служб с более высокой периодичностью, что позволит вам протестировать любые изменения служб до их широкого развертывания в рабочей среде.

Пример 4: Настройка пула узлов для использования прямого назначения

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

Эта команда задает пул узлов для использования прямого назначения для определения узла сеансов личного рабочего стола для назначения пользователя. При прямом назначении пользователь должен быть назначен узлу сеансов перед подключением к пулу узлов.

Пример 5: Настройка пула узлов для использования автоматического назначения

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

Эта команда настраивает пул узлов на использование автоматического назначения для определения узла сеансов личного рабочего стола для назначения пользователя. При автоматическом назначении пользователю не нужно назначаться узлу сеансов перед подключением к пулу узлов.

Пример 4: Настройка пула узлов для использования прямого назначения

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

Пример 5: Настройка пула узлов для использования автоматического назначения

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

Параметры

-AssignmentType

Тип назначения для пула узлов персонального рабочего стола:

Автоматически, то есть пользователям будет автоматически назначен узел сеанса при первом подключении к пулу узлов.
Прямой, то есть пользователи должны быть напрямую назначены узлу сеансов в пуле, прежде чем они смогут подключиться.

Тип:	PersonalDesktopAssignmentType
Допустимые значения:	Automatic, Direct
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BreadthFirstLoadBalancer

Переключитесь, чтобы включить использование балансировки нагрузки в ширину для пула узлов. Параметр «Сначала в ширину» указывает, что сеансы новых пользователей направляются на узел сеансов с наименьшим числом сеансов пользователей.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CustomRdpProperty

Указывает параметры протокола удаленного рабочего стола (RDP) для включения в RDP-файлы для всех программ RemoteApp и удаленных рабочих столов, опубликованных в этой коллекции. Дополнительные сведения см. в разделе Поддерживаемые настройки файла RDP удаленного рабочего стола .

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-DepthFirstLoadBalancer

Переключитесь, чтобы включить использование балансировки нагрузки в глубину для пула узлов. Depth-first указывает, что новые пользовательские сеансы направляются на узел сеансов с наибольшим числом пользовательских сеансов, который еще не достиг максимального лимита сеансов.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Description

Описание пула узлов сети.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FriendlyName

Понятное имя пула узлов, который будет отображаться.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MaxSessionLimit

Максимально допустимое количество сеансов на один узел сеансов в пуле узлов. Если для балансировки нагрузки установлен режим depth-first, это значение используется для определения того, когда следует прекратить балансировку нагрузки пользователей на один узел и начать отправку пользователей на следующий узел.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Name

Имя пула узлов.

Тип:	String
Aliases:	HostPoolName
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-TenantName

Имя клиента.

Тип:	String
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-ValidationEnv

Логическое значение, указывающее, следует ли рассматривать пул узлов как пул проверяемых узлов. Пулы узлов с проверкой получают обновления служб с более высокой периодичностью, чем пулы узлов без проверки, что позволяет тестировать изменения служб перед их широким развертыванием в рабочей среде.

Тип:	String
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

Входные данные

System.String

Выходные данные

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool

Поделиться через

Set-RdsHostPool

Синтаксис

Описание

Примеры

Пример 1: Настройте пул узлов для использования балансировки нагрузки в глубину

Пример 2: Настройте пул узлов для использования балансировки нагрузки в ширину

Пример 3: Настройка пула узлов, который будет рассматриваться как среда проверки

Пример 4: Настройка пула узлов для использования прямого назначения

Пример 5: Настройка пула узлов для использования автоматического назначения

Пример 4: Настройка пула узлов для использования прямого назначения

Пример 5: Настройка пула узлов для использования автоматического назначения

Параметры

-AssignmentType

-BreadthFirstLoadBalancer

-CustomRdpProperty

-DepthFirstLoadBalancer

-Description

-FriendlyName

-MaxSessionLimit

-Name

-TenantName

-ValidationEnv

Входные данные

Выходные данные