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
개인 데스크톱 호스트 풀에 대한 할당 유형은 다음과 같습니다.
- 자동은 사용자에게 호스트 풀에 대한 첫 번째 연결에서 세션 호스트가 자동으로 할당됨을 의미합니다.
- 직접(Direct) 즉, 사용자는 연결하기 전에 풀의 세션 호스트에 직접 할당되어야 합니다.
매개 변수 속성
| 형식: | PersonalDesktopAssignmentType |
| Default value: | None |
| 허용되는 값: | Automatic, Direct |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Description
관리자를 돕기 위해 HostPool을 설명하는 512자 문자열입니다. 모든 문자가 허용됩니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-FriendlyName
최종 사용자에게 표시하기 위한 256자 문자열입니다. 모든 문자가 허용됩니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Name
호스트 풀의 이름으로, 테넌트에서 고유해야 합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | HostPoolName(호스트 풀 이름) |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Persistent
호스트 풀을 영구로 표시할지 여부를 나타내는 스위치입니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-TenantName
테넌트 이름입니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-ValidationEnv
호스트 풀을 유효성 검사 호스트 풀로 처리해야 하는지 여부를 나타내는 부울입니다. 검증 호스트 풀은 비검증 호스트 풀보다 더 빠른 주기로 서비스 업데이트를 수신하므로 서비스 변경 사항이 프로덕션에 광범위하게 배포되기 전에 테스트할 수 있습니다.
매개 변수 속성
| 형식: | String |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.