New-RdsHostPool
創建主機池。
語法
Default (預設值)
New-RdsHostPool
[-TenantName] <String>
[-Name] <String>
[-ValidationEnv <bool>]
[-Ring <int>]
[-Description <String>]
[-FriendlyName <String>]
[-Persistent]
[<CommonParameters>]
Description
在租戶中創建主機池。 主機池包含一個或多個會話主機，用戶可以在其中連接以運行程式、保存檔以及使用這些主機上的資源。
在創建時，您可以決定使用persistent標誌創建持久性主機池。 通過創建持久主機池，用戶將始終連接到其會話的同一會話主機。 如果不使用此標誌，則會創建一個共用主機池。 在共用主機池中，用戶連接到池中由負載均衡器動態選擇的會話主機。
範例
範例 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
個人桌面主機池的分配類型：
- Automatic，這意味著使用者將在首次連接到主機池時自動分配會話主機。
- Direct，這意味著必須先將使用者直接分配到池中的會話主機，然後才能進行連接。
參數屬性
| 類型: | PersonalDesktopAssignmentType |
| 預設值: | None |
| 接受的值: | Automatic, Direct |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Description
一個 512 個字元的字串，用於描述 HostPool 以説明管理員。 允許使用任何字元。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-FriendlyName
一個 256 個字元的字串，用於向最終用戶顯示。 允許使用任何字元。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
主機池的名稱，在租戶中必須是唯一的。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | HostPool名稱 |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Persistent
指示將主機池標記為持久池的開關。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TenantName
租用戶的名稱。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ValidationEnv
一個布爾值，指示是否應將主機池視為驗證主機池。 驗證主機池以比非驗證主機池更快的節奏接收服務更新，從而允許您在將服務更改廣泛部署到生產環境之前對其進行測試。
參數屬性
| 類型: | String |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。