New-RdsHostPool

参考

模块:: WindowsVirtualDesktopPowershell

创建主机池。

语法

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

说明

在租户中创建主机池。主机池包含一个或多个会话主机，用户可以在其中连接到运行程序、保存文件以及使用这些主机上的资源。

在创建时，可以决定使用永久性标志创建永久性主机池。通过创建永久性主机池，用户将始终连接到其会话的同一会话主机。如果不使用此标志，则会创建共用主机池。在共用主机池中，用户连接到负载均衡器动态选择的池中的会话主机。

示例

示例 1：创建共用主机池

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        :

此命令在指定的租户中创建新的共用主机池。主机池中填充了一些预定义值。若要更改这些值，请运行 Set-RdsHostPool cmdlet。

示例 2：创建个人桌面主机池

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

此命令在指定的租户中创建新的个人桌面主机池。如果在运行命令时未提供分配类型，则个人桌面主机池将设置为自动分配。若要更改主机池的分配类型或任何其他属性，请运行 Set-RdsHostPool cmdlet。

示例 3：创建验证主机池

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

此命令在指定的租户中创建一个新的共用验证主机池。验证主机池将以更快的节奏接收服务更新，使你能够在在生产环境中广泛部署任何服务更改之前对其进行测试。若要更改主机池，使其不再是验证主机池，请运行 Set-RdsHostPool cmdlet。

参数

-AssignmentType

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

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

类型:	PersonalDesktopAssignmentType
接受的值:	Automatic, Direct
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Description

描述 HostPool 以帮助管理员的 512 字符串。允许任何字符。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FriendlyName

一个 256 字符的字符串，用于显示给最终用户。允许任何字符。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

主机池的名称，该名称在租户中必须是唯一的。

类型:	String
别名:	HostPoolName
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Persistent

指示将主机池标记为永久性的开关。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TenantName

租户的名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ValidationEnv

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

类型:	String
Position:	Named
默认值:	False
必需:	False
接受管道输入:	True
接受通配符:	False

输入

System.String

输出

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool

通过