New-RdsHostPool
ホスト・プールを作成します。
構文
New-RdsHostPool
[-TenantName] <String>
[-Name] <String>
[-ValidationEnv <bool>]
[-Ring <int>]
[-AssignmentType {Automatic | Direct}]
[-Description <String>]
[-FriendlyName <String>]
[-Persistent]
[<CommonParameters>] 説明
テナント内にホスト プールを作成します。 ホスト・プールには、ユーザーが接続してプログラムを実行したり、ファイルを保管したり、それらのホスト上のリソースを使用したりできる 1 つ以上のセッション・ホストが含まれています。
作成時に、永続フラグを使用して永続ホストプールを作成することを決定できます。 永続ホストプールを作成することにより、ユーザーは常にセッションの同じセッションホストに接続することになります。 このフラグを使用しない場合、プールされたホスト・プールが作成されます。 プールされたホストプールでは、ユーザーは、ロードバランサーによって動的に選択されるプール内のセッションホストに接続されます。
例
例 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 コマンドレットを実行します。
例 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 コマンドレットを実行します。
例 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 コマンドレットを実行します。
パラメーター
-AssignmentType
パーソナル デスクトップ ホスト プールの割り当てタイプ:
- [自動] は、ユーザーがホスト プールに初めて接続したときに、セッション ホストが自動的に割り当てられることを意味します。
- 直接、つまり、ユーザーは接続する前にプール内のセッション ホストに直接割り当てる必要があります。
| 型: | PersonalDesktopAssignmentType |
| 指定可能な値: | Automatic, Direct |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
管理者を支援するための HostPool を説明する 512 文字の文字列。 任意の文字を使用できます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FriendlyName
エンド ユーザーへの表示を目的とした 256 文字の文字列。 任意の文字を使用できます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
ホスト プールの名前 (テナント内で一意である必要があります)。
| 型: | String |
| Aliases: | HostPoolName |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Persistent
ホスト・プールを永続としてマークすることを示すスイッチ。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TenantName
テナントの名前。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ValidationEnv
ホスト プールを検証ホスト プールとして扱う必要があるかどうかを示すブール値。 検証ホスト プールは、非検証ホスト プールよりも速い頻度でサービス更新を受け取るため、サービスの変更を運用環境に広くデプロイする前にテストできます。
| 型: | String |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
入力
System.String
出力
Microsoft.RDInfra.RDManagementData.RdMgmtHostPool