Win32_TSSessionDirectory 클래스

아티클
06/13/2023

Win32_TSSessionDirectorySetting 클래스에 대한 RD 연결 브로커(원격 데스크톱 연결 브로커) 구성 설정을 정의합니다.

참고

Windows Server 2008 R2에서는 터미널 서비스 세션 브로커(TS 세션 브로커)의 이름이 RD 연결 브로커로 변경되었습니다. 이러한 속성은 달리 명시되지 않는 한 지원되는 모든 운영 체제에 적용됩니다.

다음 구문은 MOF 코드에서 간소화되며 정의된 속성과 상속된 모든 속성을 사전순으로 포함합니다. 메서드에 대한 참조 정보는 이 항목의 뒷부분에 있는 메서드 표를 참조하세요.

구문

[dynamic, provider("Win32_WIN32_TSSESSIONDIRECTORY_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TSSessionDirectory : CIM_Setting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   SessionDirectoryLocation;
  uint32   PolicySourceSessionDirectoryLocation;
  uint32   SessionDirectoryActive;
  uint32   PolicySourceSessionDirectoryActive;
  uint32   SessionDirectoryExposeServerIP;
  uint32   PolicySourceSessionDirectoryExposeServerIP;
  string   SessionDirectoryClusterName;
  uint32   PolicySourceLoadBalancing;
  uint32   GetLoadBalancingState;
  uint32   GetServerWeight;
  uint32   PolicySourceSessionDirectoryClusterName;
  string   SessionDirectoryIPAddress;
  uint32   GetTSRedirectorMode;
  uint32   PolicySourceTSRedirectorMode;
};

멤버

Win32_TSSessionDirectory 클래스에는 다음과 같은 유형의 멤버가 있습니다.

메서드
속성

메서드

Win32_TSSessionDirectory 클래스에는 이러한 메서드가 있습니다.

메서드	Description
CreateUserDiskTemplate	사용자 디스크 템플릿을 만듭니다.
DisableUserVhd	사용자 프로필 VHD를 사용하지 않도록 설정합니다.
EnableUserVhd	RDSH 서버에서 사용자 프로필 VHD를 사용하도록 설정합니다.
GetCurrentRedirectableAddresses	현재 구성된 DNS 적격 주소 목록과 리디렉션 유형을 가져옵니다.
GetRedirectableAddresses	DNS 적격 주소의 전체 목록을 가져옵니다.
PingSessionDirectory	RD 연결 브로커 서버를 사용할 수 있는지 여부를 확인합니다.
SetCurrentRedirectableAddresses	구성된 DNS 적격 주소 목록 및 리디렉션 유형을 설정합니다.
SetLoadBalancingState	서버가 RD 연결 브로커 부하 분산에 참여할지 여부를 나타내는 값을 설정합니다.
SetServerWeight	RD 연결 브로커 부하 분산에 대한 서버 가중치 값을 설정합니다.
SetSessionDirectoryActive	RD 연결 브로커를 사용하지 않도록 설정하고 사용하도록 설정합니다.
SetSessionDirectoryExposeServerIP	SessionDirectoryExposeServerIP 속성을 설정합니다.
SetSessionDirectoryProperty	SessionDirectoryLocation 속성 또는 SessionDirectoryClusterName 속성을 설정합니다.
SetTSRedirectorMode	이 메서드는 사용할 수 없습니다.

속성

Win32_TSSessionDirectory 클래스에는 이러한 속성이 있습니다.

캡션

데이터 형식: string
액세스 형식: 읽기 전용
한정자: MaxLen(64)

개체의 간단한 설명(한 줄 문자열)입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

설명

데이터 형식: 문자열
액세스 형식: 읽기 전용

개체에 대한 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

GetLoadBalancingState

데이터 형식: uint32
액세스 형식: 읽기 전용

서버가 RD 연결 브로커 부하 분산에 참여하도록 구성되어 있는지를 나타냅니다.

0

서버가 RD 연결 브로커 부하 분산에 참여하도록 구성되지 않았습니다.

1

서버는 RD 연결 브로커 부하 분산에 참여하도록 구성됩니다.

GetServerWeight

데이터 형식: uint32
액세스 형식: 읽기 전용

RD 연결 브로커 부하 분산에 사용되는 서버 가중치 값을 검색합니다.

GetTSRedirectorMode

데이터 형식: uint32
액세스 형식: 읽기 전용

서버가 원격 데스크톱 서비스 리렉터 역할을 하도록 구성되어 있는지를 나타냅니다.

서버는 원격 데스크톱 서비스 리렉터 역할을 하도록 구성됩니다.

서버가 원격 데스크톱 서비스 리렉터 역할을 하도록 구성되지 않았습니다.

Windows Server 2008: 이 속성은 사용할 수 없습니다.

InstallDate

데이터 형식: datetime
액세스 형식: 읽기 전용
한정자: 매핑 문자열 ("MIF. DMTF| ComponentID|001.5")

개체가 설치된 날짜입니다. 값이 부족해도 개체가 설치되지 않았음을 의미하지는 않습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

이름

데이터 형식: 문자열
액세스 형식: 읽기 전용

개체의 이름입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

PolicySourceLoadBalancing

데이터 형식: uint32
액세스 형식: 읽기 전용

GetLoadBalancingState 속성이 서버 또는 그룹 정책에 의해 구성되었는지 여부를 나타냅니다.

0(0x0)

서버

1(0x1)

그룹 정책

PolicySourceSessionDirectoryActive

데이터 형식: uint32
액세스 형식: 읽기 전용

SessionDirectoryActive 속성이 서버 또는 그룹 정책에 의해 구성되었는지 여부를 나타냅니다.

0(0x0)

서버

1(0x1)

그룹 정책

PolicySourceSessionDirectoryClusterName

데이터 형식: uint32
액세스 형식: 읽기 전용

SessionDirectoryClusterName 속성이 서버 또는 그룹 정책에 의해 구성되었는지 여부를 나타냅니다.

0(0x0)

서버

1(0x1)

그룹 정책

PolicySourceSessionDirectoryExposeServerIP

데이터 형식: uint32
액세스 형식: 읽기 전용

SessionDirectoryExposeServerIP 속성이 서버 또는 그룹 정책에 의해 구성되었는지 여부를 나타냅니다.

0(0x0)

서버

1(0x1)

그룹 정책

PolicySourceSessionDirectoryLocation

데이터 형식: uint32
액세스 형식: 읽기 전용

SessionDirectoryLocation 속성이 서버 또는 그룹 정책에 의해 구성되었는지 여부를 나타냅니다.

0(0x0)

서버

1(0x1)

그룹 정책

PolicySourceTSRedirectorMode

데이터 형식: uint32
액세스 형식: 읽기 전용

이 속성은 사용할 수 없습니다.

Windows Server 2008 R2:GetTSRedirectorMode 속성이 서버 또는 그룹 정책에 의해 구성되었는지 여부를 나타냅니다.

0(0x0)

서버

1(0x1)

그룹 정책

SessionDirectoryActive

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 키

원격 데스크톱 서비스가 RD 연결 브로커에 참여하는지 지정합니다.

FALSE (0)

RD 연결 브로커에 원격 데스크톱 서비스 참여가 사용되지 않습니다.

TRUE (1)

RD 연결 브로커에 원격 데스크톱 서비스 참여가 활성화됩니다.

SessionDirectoryClusterName

데이터 형식: 문자열
액세스 형식: 읽기 전용

RD 세션 호스트 서버가 속한 클러스터의 가상 IP 주소입니다.

SessionDirectoryExposeServerIP

데이터 형식: uint32
액세스 형식: 읽기 전용

RD 연결 브로커의 IP 주소 검색이 허용되는지 지정합니다.

FALSE (0)

검색이 거부되었습니다.

TRUE (1)

검색이 허용됩니다.

SessionDirectoryIPAddress

데이터 형식: 문자열
액세스 형식: 읽기/쓰기

세션 디렉터리에서 사용하는 LAN 어댑터의 IP 주소입니다.

SessionDirectoryLocation

데이터 형식: 문자열
액세스 형식: 읽기 전용

RD 연결 브로커 서비스가 실행 중인 서버의 네트워크 DNS 이름 또는 IP 주소입니다.

상태

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MaxLen (10)

개체의 현재 상태. 다양한 운영 및 비 운용 상태를 정의할 수 있습니다. 작동 상태에는 "OK", "Degraded", "Pred Fail"(SMART 지원 하드 디스크 드라이브와 같은 요소가 제대로 작동하지만 가까운 장래에 오류를 예측할 수 있음)이 포함됩니다. 비 운용성 상태에는 "오류", "시작 중", "중지" 및 "서비스"가 포함됩니다. 후자의 "서비스"는 디스크를 다시 미러, 사용자 권한 목록의 다시 로드 또는 기타 관리 작업 중에 적용할 수 있습니다. 이러한 모든 작업이 온라인 상태인 것은 아니지만 관리되는 요소는 "OK"도 아니고 다른 상태 중 하나에 있지도 않습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

("OK")

("오류")

("Degraded")

("알 수 없음")

("Pred Fail")

("시작")

("중지")

("서비스")

설명

\\root\CIMV2\TerminalServices 네임스페이스에 연결하려면 인증 수준에 패킷 개인 정보를 포함해야 합니다. C/C++ 호출의 경우 RPC_C_AUTHN_LEVEL_PKT_PRIVACY 인증 수준입니다. Visual Basic 및 스크립팅 호출의 경우 값이 6인 WbemAuthenticationLevelPktPrivacy 또는 "pktPrivacy"의 인증 수준입니다.

다음 VBScript(Visual Basic Scripting Edition) 예제에서는 패킷 개인 정보를 사용하여 원격 컴퓨터에 연결하는 방법을 보여 줍니다.

strComputer = "RemoteServer1" 
Set objServices = GetObject( _
    "winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")

Windows Server 2008에서는 터미널 서비스 세션 디렉터리 기능의 이름이 터미널 서비스 세션 브로커로 변경되었습니다.

Windows Server 2008 R2에서 터미널 서비스 세션 브로커 기능의 이름이 원격 데스크톱 연결 브로커로 변경되었습니다.

MOF(Managed Object Format) 파일에는 WMI(Windows Management Instrumentation) 클래스에 대한 정의가 포함되어 있습니다. MOF 파일은 Microsoft Windows SDK(소프트웨어 개발 키트)의 일부로 설치되지 않습니다. 서버 관리자 사용하여 연결된 역할을 추가할 때 서버에 설치됩니다. MOF 파일에 대한 자세한 내용은 MOF(관리 개체 형식)를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2008
네임스페이스	Root\CIMv2\TerminalServices
MOF	TSCfgWmi.mof
DLL	TSCfgWmi.dll

추가 정보

CIM_Setting
Win32_TSSessionDirectorySetting

다음을 통해 공유

Win32_TSSessionDirectory 클래스

구문

멤버

메서드

속성

설명

요구 사항

추가 정보

피드백

추가 리소스