Set-RdsHostPool

参考

模块:: WindowsVirtualDesktopPowershell

设置主机池的属性。

语法

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 cmdlet 设置指定主机池的属性。此 cmdlet 存在三个参数集。第一个用于禁用用户配置文件磁盘。第二个用于启用用户配置文件磁盘。第三个用于设置主机池的所有其他属性。

示例

示例 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        :

此命令将主机池设置为使用深度优先负载均衡，以便传入的用户将全部定向到特定的会话主机，直到它到达 MaxSessionLimit（在本示例中指定为 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

个人桌面主机池的分配类型：

自动，这意味着将在用户首次连接到主机池时自动为其分配会话主机。
直接，这意味着必须先将用户直接分配到池中的会话主机，然后才能进行连接。

Type:	PersonalDesktopAssignmentType
Accepted values:	Automatic, Direct
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BreadthFirstLoadBalancer

切换以允许对主机池使用广度优先负载均衡。广度优先指示新用户会话定向到具有最少用户会话数的会话主机。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomRdpProperty

指定要在此集合中发布的所有 RemoteApp 程序和远程桌面的 .rdp 文件中包含的远程桌面协议 (RDP) 设置。有关详细信息，请参阅支持的远程桌面 RDP 文件设置。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DepthFirstLoadBalancer

切换以启用主机池的深度优先负载均衡。深度优先指示新用户会话定向到用户会话数最多且尚未达到最大会话限制的会话主机。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

主机池的说明。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FriendlyName

要显示的主机池的友好名称。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxSessionLimit

主机池中每个会话主机允许的最大会话数。为负载均衡设置了深度优先模式时，此值用于确定何时停止对一台主机的用户进行负载均衡，并开始将用户发送到下一台主机。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

主机池的名称。

Type:	String
Aliases:	HostPoolName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TenantName

租户的名称。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ValidationEnv

一个布尔值，指示主机池是否应被视为验证主机池。与非验证主机池相比，验证主机池以更快的节奏接收服务更新，使你能够在将服务更改广泛部署到生产环境之前对其进行测试。

Type:	String
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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

输入

输出

其他资源