Remove-RdsSessionHost
호스트 풀에서 세션 호스트를 제거합니다.
구문
Default (기본값)
Remove-RdsSessionHost
[-TenantName] <String>
[-HostPoolName] <String>
[-Name] <String>
[-Force]
[<CommonParameters>]
Description
Remove-RdsSessionHost cmdlet은 호스트 풀에서 등록된 세션 호스트를 제거합니다. 세션 호스트를 호스트 풀에 다시 등록하려면 해당 호스트 풀에 대한 유효한 등록 정보를 사용하여 에이전트를 다시 설치해야 합니다.
세션 호스트에 활성 사용자 세션이 있는 경우 이 명령이 실패합니다. 세션 호스트 제거를 완료하려면 먼저 Invoke-RdsUserSessionLogoff cmdlet을 사용하여 세션 호스트에서 모든 사용자를 로그오프하거나 Force 매개 변수를 사용하여 Remove-RdsSessionHost cmdlet을 다시 실행해야 합니다.
영구 호스트 풀에서 세션 호스트를 제거하기 위해 이 명령을 실행하면 사용자 할당도 제거됩니다. 이는 영구 호스트 풀의 새 세션 호스트에 사용자를 다시 할당하는 유일한 방법입니다.
예제
예제 1: 활성 세션이 없는 세션 호스트 제거
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com"
이 명령은 호스트 풀에서 세션 호스트를 제거합니다. Force 스위치 없이 Remove-RdsSessionHost cmdlet을 실행하면 지정된 세션 호스트에 활성 세션이 없는 경우에만 성공합니다. 사용자가 세션 호스트에서 로그오프하도록 하려면 Invoke-RdsUserSessionLogoff cmdlet을 실행할 수 있습니다.
예제 2: force 스위치를 사용하여 세션 호스트 제거
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com" -Force
이 명령은 호스트 풀에서 세션 호스트를 제거합니다. Remove-RdsSessionHost cmdlet을 Force 스위치와 함께 실행하면 세션 호스트가 사용자 세션 정보와 함께 데이터베이스에서 즉시 제거됩니다. 이렇게 하면 사용자가 자동으로 로그오프되지 않으며, 로그오프를 수행하기 전에 실수로 세션에서 연결이 끊어진 경우 사용자가 세션 상태를 잃게 될 수 있습니다.
매개 변수
-Force
세션 호스트에 포함된 사용자 세션 개체가 있는 경우에도 세션 호스트를 강제로 제거합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-HostPoolName
HostPool 이름입니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Name
SessionHost 이름입니다.
매개 변수 속성
| 형식: | 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를 참조하세요.