Set-RdsSessionHost
세션 호스트의 상태를 설정합니다.
구문
Default (기본값)
Set-RdsSessionHost
[-TenantName] <String>
[-HostPoolName] <String>
[-Name] <String>
[-AllowNewSession]
[-AssignedUser]
[<CommonParameters>]
Description
Set-RdsSessionHost cmdlet은 지정된 세션 호스트의 상태를 설정합니다. 세션 호스트에 대한 새 연결을 비활성화하거나 활성화할 수 있습니다. 세션 호스트에서 이 속성을 변경해도 세션 호스트의 사용자 세션에는 영향을 주지 않습니다.
예제
예 1: 세션 호스트에 대한 새 연결 비활성화(즉, 호스트를 드레이닝 모드로 설정)
PS C:\> Set-RdsSessionHost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com" -AllowNewSession $false
SessionHostName : sh1.contoso.com
TenantName : contoso
TenantGroupName : Default Tenant Group
HostPoolName : contosoHostPool
AllowNewSession : False
Sessions : 1
LastHeartBeat : 1/1/2018 12:00:00 PM
AgentVersion : 1.0.0.1
AssignedUser :
Status : Available
StatusTimestamp : 1/1/2018 12:00:00 PM
이 명령은 세션 호스트가 새 연결을 수신하지 못하도록 설정하고 로드 밸런싱 후보에서 제거합니다. 서버의 모든 기존 세션은 사용자가 로그오프할 때까지 그대로 유지됩니다. 관리자는 Invoke-RdsUserSessionLogoff cmdlet을 사용하여 강제로 로그오프할 수 있습니다.
예 2: 세션 호스트에 대한 새 연결 사용(즉, 드레이닝 모드에서 호스트 제거)
PS C:\> Set-RdsSessionHost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com" -AllowNewSession $true
SessionHostName : sh1.contoso.com
TenantName : contoso
TenantGroupName : Default Tenant Group
HostPoolName : contosoHostPool
AllowNewSession : True
Sessions : 1
LastHeartBeat : 1/1/2018 12:00:00 PM
AgentVersion : 1.0.0.1
AssignedUser :
Status : Available
StatusTimestamp : 1/1/2018 12:00:00 PM
이 명령을 사용하면 세션 호스트가 새 연결을 받을 수 있으며 이제 로드 밸런싱의 후보가 되었습니다.
예제 3: 개인 데스크톱 세션 호스트에 사용자 할당
PS C:\> Set-RdsSessionHost -TenantName "contoso" -HostPoolName "contosoPersonalDesktops" -Name "sh1.contoso.com" -AssignedUser user1@contoso.com
SessionHostName : sh1.contoso.com
TenantName : contoso
TenantGroupName : Default Tenant Group
HostPoolName : contosoPersonalDesktops
AllowNewSession : True
Sessions : 1
LastHeartBeat : 1/1/2018 12:00:00 PM
AgentVersion : 1.0.0.1
AssignedUser : user1@contoso.com
Status : Available
StatusTimestamp : 1/1/2018 12:00:00 PM
이 명령은 개인 데스크톱 호스트 풀의 세션 호스트를 에 할당합니다.user1@contoso.com 이제 이 사용자는 풀에 연결할 때 이 세션 호스트에 연결합니다.
매개 변수
-AllowNewSession
두 가지 잠재적 값이 있는 스위치:
- True이며, 브로커가 세션 호스트에 새 사용자 세션을 할당할 수 있음을 지정합니다.
- False - 세션 호스트에 새 사용자 세션(즉, 드레이닝 모드)이 할당되지 않도록 지정합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-AssignedUser
개인 데스크톱 세션 호스트에 할당할 사용자입니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-HostPoolName
호스트 풀의 이름입니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Name
세션 호스트의 FQDN(정규화된 도메인 이름)입니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 세션호스트이름 |
매개 변수 집합
(All)
| Position: | 2 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-TenantName
테넌트 이름입니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.