Set-RdsHostPool

모듈:

Microsoft.RDInfra.RDPowershell Module

호스트 풀의 속성을 설정합니다.

구문

HP4 (기본값)

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-FriendlyName <String>]
    [-Description <String>]
    [-MaxSessionLimit <Int32>]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP5

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-BreadthFirstLoadBalancer]
    [-MaxSessionLimit <Int32>]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP6

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    -MaxSessionLimit <Int32>
    [-DepthFirstLoadBalancer]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP3

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-CustomRdpProperty <String>]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP7

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-ValidationEnv <bool>]
    [-Ring <int>]
    [<CommonParameters>]

Description

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        :

이 명령은 깊이 우선 부하 분산을 사용하도록 호스트 풀을 설정하여 들어오는 사용자가 이 예제에서 10으로 지정된 MaxSessionLimit에 도달할 때까지 모두 특정 세션 호스트로 이동되도록 합니다. 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

개인 데스크톱 호스트 풀에 대한 할당 유형은 다음과 같습니다.

• 자동은 사용자에게 호스트 풀에 대한 첫 번째 연결에서 세션 호스트가 자동으로 할당됨을 의미합니다.
• 직접(Direct) 즉, 사용자는 연결하기 전에 풀의 세션 호스트에 직접 할당되어야 합니다.

매개 변수 속성

형식:	PersonalDesktopAssignmentType
Default value:	None
허용되는 값:	Automatic, Direct
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-BreadthFirstLoadBalancer

호스트 풀에 대해 너비 우선 부하 분산을 사용할 수 있도록 전환합니다. 너비 우선은 새 사용자 세션이 사용자 세션 수가 가장 적은 세션 호스트로 전달됨을 나타냅니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

HP5

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-CustomRdpProperty

이 컬렉션에 게시된 모든 RemoteApp 프로그램 및 원격 데스크톱의 .rdp 파일에 포함할 RDP(원격 데스크톱 프로토콜) 설정을 지정합니다. 자세한 내용은 지원되는 원격 데스크톱 RDP 파일 설정을 참조하세요.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

HP3

Position:	Named
필수:	False
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-DepthFirstLoadBalancer

호스트 풀에 대해 깊이 우선 부하 분산을 사용할 수 있도록 전환합니다. Depth-first는 새 사용자 세션이 최대 세션 제한에 아직 도달하지 않은 사용자 세션 수가 가장 많은 세션 호스트로 전달됨을 나타냅니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

HP6

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Description

호스트 풀에 대한 설명입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

HP4

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-FriendlyName

표시할 호스트 풀의 이름입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

HP4

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-MaxSessionLimit

호스트 풀에서 세션 호스트당 허용되는 최대 세션 수입니다. 로드 밸런싱에 대해 깊이 우선 모드가 설정된 경우 이 값은 한 호스트로의 사용자 로드 밸런싱을 중지하고 사용자를 다음 호스트로 보내기 시작할 시기를 결정하는 데 사용됩니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

HP4

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

HP5

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Name

호스트 풀의 이름입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	HostPoolName(호스트 풀 이름)

매개 변수 집합

(All)

Position:	1
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	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를 참조하세요.

입력

System.String

출력

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool