다음을 통해 공유

Win32_TerminalService 클래스

  • 아티클

Win32_TerminalService WMI 클래스는 Win32_Service 클래스의 하위 클래스입니다. Win32_TerminalServiceWin32_TerminalServiceToSetting 연결의 Element 속성을 나타냅니다.

다음 구문은 MOF 코드에서 간소화되며 정의된 속성과 상속된 모든 속성을 사전순으로 포함합니다.

구문

[dynamic, provider("Win32_WIN32_TERMINALSERVICE_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TerminalService : Win32_Service
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  uint32   CheckPoint;
  string   CreationClassName;
  boolean  DelayedAutoStart;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ProcessId;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
  uint32   WaitHint;
  uint32   DisconnectedSessions;
  uint32   TotalSessions;
};

멤버

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

메서드

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

메서드 Description
변경 서비스를 수정합니다.
ChangeStartMode 서비스의 시작 모드를 수정합니다.
만들기 새 서비스를 만듭니다.
삭제 기존 서비스를 삭제합니다.
GetSecurityDescriptor 서비스에 대한 액세스를 제어하는 보안 설명자를 반환합니다.
InterrogateService 서비스가 서비스 관리자에게 상태를 업데이트하도록 요청합니다.
PauseService 서비스를 일시 중지된 상태로 배치하려고 시도합니다.
ResumeService 서비스를 다시 시작된 상태로 배치하려고 시도합니다.
SetSecurityDescriptor 서비스에 대한 액세스를 제어하는 업데이트된 버전의 보안 설명자를 씁니다.
StartService 서비스를 시작 상태로 전환하려고 시도합니다.
StopService 서비스를 중지된 상태로 설정합니다.
UserControlService 사용자 정의 제어 코드를 서비스에 보내려고 시도합니다.

속성

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

AcceptPause

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE"), DisplayName ("Service Accepts Pause")

서비스를 일시 중지할 수 있는지 여부를 나타냅니다.

이 속성은 Win32_BaseService 상속됩니다.

AcceptStop

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP"), DisplayName ("Service Accepts Stop")

서비스를 중지할 수 있는지 여부를 나타냅니다.

이 속성은 Win32_BaseService 상속됩니다.

캡션

데이터 형식: string

액세스 형식: 읽기 전용

한정자: MaxLen (64), DisplayName ("Caption")

서비스에 대한 간단한 설명은 한 줄 문자열입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

검사점

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings("Win32API| 서비스 구조| SERVICE_STATUS|dwCheckPoint"), DisplayName("Check Point 개수")

긴 시작, 중지, 일시 중지 또는 계속 작업 중에 진행률을 보고하기 위해 서비스가 주기적으로 증가되는 값입니다. 예를 들어 서비스는 시작 시 초기화의 각 단계를 완료할 때 이 값을 증가합니다. 서비스에 대한 작업을 호출하는 사용자 인터페이스 프로그램은 이 값을 사용하여 긴 작업 중에 서비스의 진행률을 추적합니다. 이 값은 유효하지 않으며 서비스에 시작, 중지, 일시 중지 또는 계속 작업이 보류 중인 경우 0이어야 합니다.

이 속성은 Win32_Service 상속됩니다.

CreationClassName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: CIM_Key, DisplayName ("클래스 이름")

instance 만드는 데 사용되는 상속 체인에 표시할 첫 번째 구체적인 클래스의 이름입니다. 클래스의 다른 키 속성과 함께 사용할 경우 이 속성을 사용하면 이 클래스의 모든 인스턴스와 해당 서브클래스를 고유하게 식별할 수 있습니다.

이 속성은 CIM_Service 상속됩니다.

DelayedAutoStart

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| SERVICE_DELAYED_AUTO_START_INFO|fDelayedAutostart"), DisplayName ("지연된 자동 시작")

True이면 다른 자동 시작 서비스가 시작된 후 짧은 지연이 더해지면 서비스가 시작됩니다.

Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 및 Windows Vista: 이 속성은 Windows Server 2016 및 Windows 10 전에 지원되지 않습니다. .

이 속성은 Win32_Service 상속됩니다.

설명

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: DisplayName ("설명")

개체에 대한 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

DesktopInteract

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS"), DisplayName ("데스크톱과 상호 작용")

서비스가 데스크톱에서 창을 만들거나 통신할 수 있는지 여부를 나타내므로 사용자와 어떤 식으로든 상호 작용할 수 있습니다. 대화형 서비스는 로컬 시스템 계정으로 실행되어야 합니다. 대부분의 서비스는 대화형이 아닙니다. 즉, 어떤 방식으로든 사용자와 통신하지 않습니다.

이 속성은 Win32_BaseService 상속됩니다.

DisconnectedSessions

데이터 형식: uint32

액세스 형식: 읽기 전용

현재 서버의 연결이 끊긴 세션 수입니다. 이러한 세션은 여전히 서버 리소스를 적극적으로 사용할 수 있지만 현재는 클라이언트와 네트워크 연결이 없습니다.

표시 이름

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("표시 이름")

서비스 스냅인에서 볼 수 있는 서비스의 이름입니다. 이 문자열의 최대 길이는 256자입니다. 표시 이름 및 서비스 이름(레지스트리에 저장됨)이 항상 동일하지는 않습니다. 예를 들어 DHCP 클라이언트 서비스에는 서비스 이름 Dhcp가 있지만 표시 이름 DHCP 클라이언트가 있습니다. 이름은 서비스 제어 관리자에서 대/소문자를 유지합니다. 그러나 DisplayName 비교는 항상 대/소문자를 구분하지 않습니다.

제약 조건: Name 속성과 동일한 값을 허용합니다.

예: "Atdisk"

이 속성은 Win32_BaseService 상속됩니다.

ErrorControl

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("시작 실패 심각도")

시작 중에 이 서비스를 시작하지 못하는 경우 오류의 심각도입니다. 값은 오류가 발생하는 경우 시작 프로그램에서 수행한 작업을 나타냅니다. 모든 오류는 컴퓨터 시스템에 기록됩니다.

무시 ("무시")

사용자에게 오류를 알리지 않습니다.

Normal ("Normal")

사용자에게 오류를 알립니다. 일반적으로 사용자에게 문제를 알리는 메시지 상자가 표시됩니다.

심각 ("심각")

마지막으로 성공한 올바른 구성으로 시스템을 다시 시작합니다.

Critical ("Critical")

올바른 구성으로 시스템을 다시 시작합니다. 서비스가 두 번째로 시작되지 않으면 시작이 실패합니다.

알 수 없음 ("알 수 없음")

오류의 심각도를 알 수 없습니다.

이 속성은 Win32_BaseService 상속됩니다.

ExitCode

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("종료 코드")

서비스를 시작하거나 중지할 때 발생한 오류를 정의하는 Windows 오류 코드입니다. 이 속성은 오류가 이 클래스가 나타내는 서비스에 고유하고 오류에 대한 정보를 ServiceSpecificExitCode 속성에서 사용할 수 있는 경우 ERROR_SERVICE_SPECIFIC_ERROR(1066)로 설정됩니다. 서비스는 실행 시 이 값을 NO_ERROR , 정상 종료 시 다시 설정합니다.

이 속성은 Win32_BaseService 상속됩니다.

InstallDate

데이터 형식: datetime

액세스 형식: 읽기 전용

한정자: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("설치 날짜")

Date 개체가 설치됩니다. 이 속성은 개체가 설치되었음을 나타내는 값이 필요하지 않습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

이름

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: Key

관리되는 기능을 나타내는 서비스의 고유 식별자입니다. 이 기능은 개체의 Description 속성에 설명되어 있습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

PathName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("파일 경로 이름")

서비스를 구현하는 서비스 이진 파일에 대한 정규화된 경로입니다.

예: "\SystemRoot\System32\drivers\afd.sys"

이 속성은 Win32_BaseService 상속됩니다.

ProcessId

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| SERVICE_STATUS_PROCESS|dwProcessId"), DisplayName ("프로세스 ID")

서비스의 프로세스 식별자입니다.

예: 324

이 속성은 Win32_Service 상속됩니다.

ServiceSpecificExitCode

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| SERVICE_STATUS|dwServiceSpecificExitCode"), DisplayName ("서버별 종료 코드")

서비스를 시작하거나 중지하는 동안 발생하는 오류에 대한 서비스별 오류 코드입니다. 종료 코드는 이 클래스가 나타내는 서비스에 의해 정의됩니다. 이 값은 ExitCode 속성 값이 ERROR_SERVICE_SPECIFIC_ERROR 경우에만 설정됩니다(1066).

이 속성은 Win32_BaseService 상속됩니다.

ServiceType

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("서비스 유형")

호출 프로세스에 제공되는 서비스의 유형입니다.

값은 다음과 같습니다.

커널 드라이버 ("커널 드라이버")

파일 시스템 드라이버 ("파일 시스템 드라이버")

어댑터 ("어댑터")

인식기 드라이버 ("인식기 드라이버")

자체 프로세스 ("자체 프로세스")

프로세스 공유 ("프로세스 공유")

대화형 프로세스 ("대화형 프로세스")

이 속성은 Win32_BaseService 상속됩니다.

시작됨

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: DisplayName ("Started")

서비스가 시작되었는지 여부를 나타냅니다.

이 속성은 CIM_Service 상속됩니다.

StartMode

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: DisplayName ("시작 모드")

Windows 기본 서비스의 시작 모드입니다.

부팅 ("부팅")

운영 체제 로더에서 시작된 디바이스 드라이버(드라이버 서비스에만 유효).

시스템 ("시스템")

운영 체제 초기화 프로세스에서 시작된 디바이스 드라이버입니다. 이 값은 드라이버 서비스에 대해서만 유효합니다.

자동 ("자동")

시스템 시작 중 서비스 제어 관리자에 의해 자동으로 서비스가 시작됩니다. 자동 서비스는 사용자가 로그온하지 않더라도 시작됩니다.

수동 ("수동")

프로세스가 StartService 메서드를 호출할 때 Service Control Manager에서 시작할 서비스입니다. 이러한 서비스는 사용자가 로그온하여 시작하지 않는 한 시작되지 않습니다.

사용 안 함("사용 안 함")

StartMode가 자동 또는 수동으로 변경될 때까지 시작할 수 없는 서비스입니다.

이 속성은 CIM_Service 상속됩니다.

StartName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|lpServiceStartName"), DisplayName ("시작 계정 이름")

서비스가 실행되는 계정 이름입니다. 서비스 유형에 따라 계정 이름은 "DomainName\Username" 또는 UPN 형식("Username@DomainName") 형식일 수 있습니다. 서비스 프로세스는 실행할 때 이러한 두 가지 양식 중 하나를 사용하여 기록됩니다. 계정이 기본 제공 도메인에 속하는 경우 ".\Username"을 지정할 수 있습니다. 커널 또는 시스템 수준 드라이버의 경우 StartName 에는 I/O 시스템에서 디바이스 드라이버를 로드하는 데 사용하는 드라이버 개체 이름(즉, "\FileSystem\Rdr" 또는 "\Driver\Xns")이 포함됩니다. 또한 NULL 을 지정하면 드라이버가 서비스 이름에 따라 I/O 시스템에서 만든 기본 개체 이름으로 실행됩니다.

예: "DWDOM\관리"

이 속성은 Win32_BaseService 상속됩니다.

State

데이터 형식: 문자열

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32API| 서비스 구조| SERVICE_STATUS|dwCurrentState "), DisplayName ("State")

기본 서비스의 현재 상태입니다.

값은 다음과 같습니다.

중지됨 ("중지됨")

보류 중인 시작 ("보류 중 시작")

보류 중 중지 ("보류 중 중지")

실행 중 ("실행 중")

계속 보류 중 ("계속 보류 중")

보류 중 일시 중지 ("보류 중 일시 중지")

일시 중지됨 ("일시 중지됨")

알 수 없음 ("알 수 없음")

Windows Server 2008 및 Windows Vista: 이 속성은 Windows 7 및 Windows Server 2008 R2 이전에 읽기 전용입니다.

이 속성은 Win32_BaseService 상속됩니다.

상태

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MaxLen (10), DisplayName ("상태")

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

값은 다음과 같습니다.

확인 ("확인")

오류 ("오류")

저하됨 ("성능 저하")

알 수 없음 ("알 수 없음")

Pred Fail ("Pred Fail")

시작 ("시작")

중지 ("중지")

서비스 ("서비스")

스트레스( "스트레스")

NonRecover ("NonRecover")

연락처 없음 ("연락처 없음")

Lost Comm ("Lost Comm")

이 속성은 CIM_ManagedSystemElement 상속됩니다.

SystemCreationClassName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: 전파됨 ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("시스템 클래스 이름")

이 서비스를 호스트하는 시스템의 이름을 입력합니다.

이 속성은 CIM_Service 상속됩니다.

SystemName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: 전파됨 ("CIM_System. 이름"), CIM_Key, DisplayName ("시스템 이름")

이 서비스를 호스트하는 시스템의 이름입니다.

이 속성은 CIM_Service 상속됩니다.

TagId

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|dwTagId"), DisplayName ("태그 ID")

그룹의 이 서비스에 대한 고유 태그 값입니다. 값이 0이면 서비스에 태그가 없음을 나타냅니다. 태그는 다음 위치에 있는 레지스트리에서 태그 순서 벡터를 지정하여 부하 주문 그룹 내에서 서비스 시작을 주문하는 데 사용할 수 있습니다.

Hkey_local_machine\시스템\CurrentControlSet\컨트롤\ GroupOrderList

태그는 부팅 또는 시스템 시작 모드가 있는 커널 드라이버 및 파일 시스템 드라이버 시작 유형 서비스에 대해서만 평가됩니다.

이 속성은 Win32_BaseService 상속됩니다.

TotalSessions

데이터 형식: uint32

액세스 형식: 읽기 전용

현재 서버의 총 세션 수입니다. 여기에는 연결된 세션과 연결이 끊긴 세션이 모두 포함됩니다.

WaitHint

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| SERVICE_STATUS|dwWaitHint"), DisplayName ("예상 대기 시간")

보류 중인 시작, 중지, 일시 중지 또는 계속 작업에 필요한 예상 시간(밀리초)입니다. 지정된 시간이 경과한 후 서비스는 증분된 CheckPoint 값 또는 CurrentState 변경으로 SetServiceStatus 메서드를 다음으로 호출합니다. WaitHint에서 지정한 시간이 지났고 CheckPoint가 증가하지 않았거나 CurrentState가 변경되지 않은 경우 서비스 제어 관리자 또는 서비스 제어 프로그램에서 오류가 발생했다고 가정합니다.

이 속성은 Win32_Service 상속됩니다.

설명

Win32_TerminalService 클래스는 Win32_Service 클래스의 하위 클래스이므로 클래스는 Win32_Service 모든 속성과 메서드를 상속합니다.

Win32_TerminalServiceSettingWin32_TerminalServiceToSetting 연결의 설정 속성으로 Win32_TerminalService 연결됩니다.

Win32_TSSessionDirectoryWin32_TSSessionDirectorySetting 연결의 설정 속성으로 Win32_TerminalService 연결됩니다.

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

요구 사항

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

추가 정보

Win32_Service

Win32_TerminalServiceToSetting

Win32_TSSessionDirectory

Win32_BaseService

CIM_Service