Поделиться через

Класс Win32_TerminalService

  • Статья

Класс WMI Win32_TerminalService является подклассом класса Win32_Service . Win32_TerminalService представляет свойство Elementсвязи Win32_TerminalServiceToSetting .

Следующий синтаксис упрощен из 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 содержит следующие методы.

Метод Описание
Изменить Изменяет службу.
ChangeStartMode Изменяет режим запуска службы.
Создать Создает новую службу.
Удалить Удаляет существующую службу.
GetSecurityDescriptor Возвращает дескриптор безопасности, управляющий доступом к службе.
Запрос службы Запрашивает, чтобы служба обновила свое состояние до диспетчера служб.
PauseService Пытается поместить службу в приостановленное состояние.
ResumeService Пытается поместить службу в возобновленное состояние.
SetSecurityDescriptor Записывает обновленную версию дескриптора безопасности, управляющего доступом к службе.
StartService Пытается поместить службу в состояние запуска.
StopService Помещает службу в остановленное состояние.
UserControlService Пытается отправить определяемый пользователем управляющий код в службу.

Свойства

Класс Win32_TerminalService имеет следующие свойства.

AcceptPause

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE"), DisplayName ("Служба принимает паузу")

Указывает, можно ли приостановить службу.

Это свойство наследуется от Win32_BaseService.

AcceptStop

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP"), DisplayName ("Служба принимает остановку")

Указывает, можно ли остановить службу.

Это свойство наследуется от Win32_BaseService.

Caption

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MaxLen (64), DisplayName ("Caption")

Краткое описание службы в однострочном формате.

Это свойство наследуется от CIM_ManagedSystemElement.

Контрольной точки

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS|dwCheckPoint"), DisplayName ("Check Point Count")

Значение, которое служба периодически увеличивает, чтобы сообщать о ходе выполнения во время длительного запуска, остановки, приостановки или продолжения операции. Например, служба увеличивает это значение по мере завершения каждого этапа своей инициализации при запуске. Программа пользовательского интерфейса, которая вызывает операцию в службе, использует это значение для отслеживания хода выполнения службы во время длительной операции. Это значение недопустимо и должно быть равно нулю, если у службы нет ожидающих операций запуска, остановки, приостановки или продолжения.

Это свойство наследуется от Win32_Service.

CreationClassName

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: CIM_Key, DisplayName ("Имя класса")

Имя первого конкретного класса, отображаемого в цепочке наследования, используемой при создании экземпляра. При использовании с другими ключевыми свойствами класса это свойство позволяет уникально идентифицировать все экземпляры этого класса и его подклассы.

Это свойство наследуется от 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.

Описание

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: DisplayName ("Описание")

Описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

DesktopInteract

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS"), DisplayName ("Взаимодействует с рабочим столом")

Указывает, может ли служба создавать окна на рабочем столе или взаимодействовать с ними и таким образом взаимодействовать с пользователем. Интерактивные службы должны выполняться под учетной записью Локальной системы. Большинство служб не являются интерактивными; то есть они никак не взаимодействуют с пользователем.

Это свойство наследуется от Win32_BaseService.

DisconnectedSessions

Тип данных: uint32

Тип доступа: только для чтения

Количество отключенных сеансов на текущем сервере. Эти сеансы по-прежнему могут активно потреблять ресурсы сервера, однако в настоящее время они не имеют сетевого подключения к клиенту.

Отображаемое имя

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("Отображаемое имя")

Имя службы, отображаемое в оснастке "Службы". Максимальная длина этой строки равна 256 символам. Обратите внимание, что отображаемое имя и имя службы (которое хранится в реестре) не всегда совпадают. Например, служба DHCP-клиента имеет имя службы Dhcp, но отображаемое имя DHCP-клиент. Имя сохраняется с учетом регистра в диспетчере управления службами. Однако при сравнении DisplayName регистр всегда не учитывается.

Ограничение: принимает то же значение, что и свойство Name .

Пример: "Atdisk"

Это свойство наследуется от Win32_BaseService.

ErrorControl

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("Серьезность сбоя при запуске")

Серьезность ошибки, если эта служба не запускается во время запуска. Значение указывает действие, выполняемое программой запуска в случае сбоя. Все ошибки записываются в журнал системой компьютера.

Ignore ("Ignore")

Пользователь не получает уведомление.

Normal ("Normal")

Пользователь получает уведомление. Обычно это окно сообщения, уведомляющее пользователя о проблеме.

Тяжелый ("Тяжелый")

Система перезапускается в последней известной рабочей конфигурации.

Критический ("Критический")

Попытка перезапустить систему в рабочей конфигурации. Если служба не запускается во второй раз, запуск завершается ошибкой.

Unknown ("Unknown")

Серьезность ошибки неизвестна.

Это свойство наследуется от Win32_BaseService.

ExitCode

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("Код выхода")

Код ошибки Windows, определяющий ошибки, возникшие при запуске или остановке службы. Это свойство имеет значение ERROR_SERVICE_SPECIFIC_ERROR (1066), если ошибка уникальна для службы, представленной этим классом, и сведения об ошибке доступны в свойстве ServiceSpecificExitCode . Служба задает для этого значения значение NO_ERROR при запуске и снова при обычном завершении работы.

Это свойство наследуется от Win32_BaseService.

InstallDate

Тип данных: datetime

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Дата установки")

Дата установки объекта. Для этого свойства не требуется значение, указывающее, что объект установлен.

Это свойство наследуется от CIM_ManagedSystemElement.

имя;

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: Ключ

Уникальный идентификатор службы, который указывает на управляемые функциональные возможности. Эта функция описана в свойстве Description объекта .

Это свойство наследуется от CIM_ManagedSystemElement.

PathName

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("Имя пути к файлу")

Полный путь к двоичному файлу службы, который реализует службу.

Пример: "\SystemRoot\System32\drivers\afd.sys"

Это свойство наследуется от Win32_BaseService.

ProcessId

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS_PROCESS|dwProcessId"), DisplayName ("Идентификатор процесса")

Идентификатор процесса службы.

Пример: 324

Это свойство наследуется от Win32_Service.

ServiceSpecificExitCode

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS|dwServiceSpecificExitCode"), DisplayName ("Код выхода для конкретного сервера")

Код ошибки службы для ошибок, возникающих во время запуска или остановки службы. Коды выхода определяются службой, представленной этим классом. Это значение задается, только если свойство ExitCodeимеет значение ERROR_SERVICE_SPECIFIC_ERROR (1066).

Это свойство наследуется от Win32_BaseService.

ServiceType

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("Тип службы")

Тип службы, предоставленной для вызывающих процессов.

Значения качества производительности:

Драйвер ядра ("Драйвер ядра")

Драйвер файловой системы ("Драйвер файловой системы")

Адаптер ("Адаптер")

Драйвер распознавателя ("Драйвер распознавателя")

Собственный процесс ("Собственный процесс")

Общий процесс ("Процесс предоставления общего доступа")

Интерактивный процесс ("Интерактивный процесс")

Это свойство наследуется от Win32_BaseService.

Приступая к работе

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: DisplayName ("Started")

Указывает, запущена ли служба.

Это свойство наследуется от CIM_Service.

StartMode

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: DisplayName ("Режим запуска")

Режим запуска базовой службы Windows.

Boot ("Boot")

Драйвер устройства, запущенный загрузчиком операционной системы (действителен только для служб драйверов).

System ("System")

Драйвер устройства, запущенный процессом инициализации операционной системы. Это значение допустимо только для служб драйверов.

Auto ("Auto")

Служба запускается автоматически диспетчером управления службами во время запуска системы. Автоматические службы запускаются, даже если пользователь не входит в систему.

Manual ("Manual")

Служба, запускаемая диспетчером управления службами, когда процесс вызывает метод StartService . Эти службы не запускаются, если пользователь не войдет в систему и не запустит их.

Disabled ("Disabled")

Служба, которая не может быть запущена, пока ее startMode не будет изменена на Auto или Manual.

Это свойство наследуется от CIM_Service.

StartName

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|lpServiceStartName"), DisplayName ("Имя стартовой учетной записи")

Имя учетной записи, под которой выполняется служба. В зависимости от типа службы имя учетной записи может быть в формате "Имя_домена\имя_пользователя" или в формате имени участника-пользователя ("Username@DomainName"). При запуске процесс службы регистрируется с помощью одной из этих двух форм. Если учетная запись принадлежит встроенному домену, можно указать ".\Username". Для драйверов уровня ядра или системы StartName содержит имя объекта драйвера (то есть "\FileSystem\Rdr" или "\Driver\Xns"), которое система ввода-вывода использует для загрузки драйвера устройства. Кроме того, если задано значение NULL , драйвер запускается с именем объекта по умолчанию, созданным системой ввода-вывода на основе имени службы.

Пример: "DWDOM\Администратор"

Это свойство наследуется от Win32_BaseService.

Состояние

Тип данных: string

Тип доступа: чтение и запись

Квалификаторы: MappingStrings ("Win32API| Структуры служб| SERVICE_STATUS|dwCurrentState "), DisplayName ("State")

Текущее состояние базовой службы.

Значения качества производительности:

Остановлено ("Остановлено")

Ожидание запуска ("Ожидание запуска")

Остановить ожидание ("Остановить ожидание")

Running ("Running")

Продолжить ожидание ("Продолжить в ожидании")

Приостановка ожидания ("Пауза в ожидании")

Приостановлено ("Приостановлено")

Unknown ("Unknown")

Windows Server 2008 и Windows Vista: Это свойство доступно только для чтения перед Windows 7 и Windows Server 2008 R2.

Это свойство наследуется от Win32_BaseService.

Состояние

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MaxLen (10), DisplayName ("Status")

Текущее состояние объекта. Можно определить различные операционные и нерабочие состояния. Операционные состояния: "ОК", "Понижено" и "Сбой pred" (элемент, например жесткий диск с поддержкой SMART, может работать правильно, но прогнозирует сбой в ближайшем будущем). К нерабочим состояниям относятся: "Ошибка", "Запуск", "Остановка" и "Служба". Последняя служба может применяться во время зеркало повторного изменения диска, перезагрузки списка разрешений пользователя или других административных действий. Не вся такая работа находится в сети, но управляемый элемент не является ни "ОК", ни в одном из других состояний.

Значения качества производительности:

ОК ("ОК")

Error ("Error")

Пониженный ("Пониженный")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Запуск ("Запуск")

Остановка ("Остановка")

Служба ("Служба")

Подчеркнуто ("подчеркнуто")

NonRecover ("NonRecover")

Нет контакта ("Нет контакта")

Lost Comm ("Lost Comm")

Это свойство наследуется от CIM_ManagedSystemElement.

SystemCreationClassName

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: распространяется ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("Имя системного класса")

Имя типа системы, в котором размещена эта служба.

Это свойство наследуется от CIM_Service.

SystemName

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: распространяется ("CIM_System. Name"), CIM_Key, DisplayName ("Имя системы")

Имя системы, в котором размещена эта служба.

Это свойство наследуется от CIM_Service.

TagId

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры служб| QUERY_SERVICE_CONFIG|dwTagId"), DisplayName ("Идентификатор тега")

Уникальное значение тега для этой службы в группе. Значение 0 (ноль) указывает, что у службы нет тега . Тег можно использовать для заказа запуска службы в группе заказов загрузки, указав вектор порядка тегов в реестре, расположенном по адресу:

HKEY_LOCAL_MACHINE\Системы\CurrentControlSet\Управления\ GroupOrderList

Теги оцениваются только для служб типа запуска драйвера ядра и драйвера файловой системы, имеющих режимы загрузки или запуска системы.

Это свойство наследуется от Win32_BaseService.

TotalSessions

Тип данных: uint32

Тип доступа: только для чтения

Общее количество сеансов на текущем сервере. Сюда входят как подключенные, так и отключенные сеансы.

WaitHint

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| | Структуры служб | SERVICE_STATUS|dwWaitHint"), DisplayName ("Предполагаемое время ожидания")

Предполагаемое время в миллисекундах для ожидающей операции запуска, остановки, приостановки или продолжения. По истечении указанного времени служба выполняет следующий вызов метода SetServiceStatus с добавочным значением CheckPoint или изменением в CurrentState. Если время, указанное WaitHint , прошло, а CheckPoint не увеличилось или CurrentState не изменилось, диспетчер управления службами или программа управления службами предполагает, что произошла ошибка.

Это свойство наследуется от Win32_Service.

Комментарии

Так как класс Win32_TerminalService является подклассом класса Win32_Service , класс наследует все свойства и методы Win32_Service.

Win32_TerminalServiceSetting связан с Win32_TerminalService как свойство Settingсвязи Win32_TerminalServiceToSetting .

Win32_TSSessionDirectory связан с Win32_TerminalService как свойство SettingWin32_TSSessionDirectorySetting связи.

MOF-файлы содержат определения для классов инструментария управления Windows (WMI). MOF-файлы не устанавливаются в составе пакета SDK для Microsoft Windows. Они устанавливаются на сервере при добавлении связанной роли с помощью диспетчер сервера. Дополнительные сведения о 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