Класс Msvm_TerminalService

Статья
06/12/2023

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

Следующий синтаксис представляет собой упрощенный код формата управляемого объекта (MOF) и включает все унаследованные свойства.

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_TerminalService : CIM_Service
{
  string   InstanceID;
  string   Caption = "Hyper-V Terminal Service";
  string   Description = "Microsoft Virtual Terminal Service";
  string   ElementName = "Hyper-V Terminal Service";
  datetime InstallDate;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "The virtual terminal connection management service is fully operational" };
  string   Status = "OK";
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   Name = "termsvc";
  string   CreationClassName = "Msvm_TerminalService";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   StartMode;
  boolean  Started;
};

Члены

Класс Msvm_TerminalService имеет следующие типы членов:

Методы
Свойства

Методы

Класс Msvm_TerminalService содержит следующие методы.

Метод	Описание
GetInteractiveSessionACL	Извлекает текущий dacl, который управляет доступом к интерактивному сеансу виртуальной машины.
GrantInteractiveSessionAccess	Предоставляет доступ к интерактивному сеансу виртуальной машины указанному списку доверенных лиц.
ModifyServiceSettings	Изменяет данные параметров для службы.
RequestStateChange	Запрашивает изменение состояния.
RevokeInteractiveSessionAccess	Отменяет доступ к интерактивному сеансу виртуальной машины из указанного списка доверенных лиц.
StartService	запускает службу.
StopService	останавливает службу.

Свойства

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

AvailableRequestedStates

Тип данных: массив uint16
Тип доступа: только для чтения

Указывает возможные значения для параметра RequestedState метода RequestStateChange . Это свойство наследуется от CIM_EnabledLogicalElement.

Caption

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

Краткое описание объекта. Это свойство наследуется от CIM_ManagedElement.

CommunicationStatus

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

Указывает на способность инструментирования взаимодействовать с базовым управляемым элементом. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
Недоступно (1)
Связь ОК (2)
Потерянная связь (3)
Нет контакта (4)
DmTF Reserved (..)
Зарезервировано поставщиком (0x8000.. )

CreationClassName

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

Имя класса или подкласса, используемого при создании экземпляра. Это свойство наследуется от CIM_Service.

Описание

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

Описание объекта. Это свойство наследуется от CIM_ManagedElement.

DetailedStatus

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

Дополняет свойство PrimaryStatus дополнительными сведениями о состоянии. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Недоступно (0)
Нет дополнительной информации (1)
Подчеркнуто (2)
Прогнозный сбой (3)
Ошибка, неизменяемая (4)
Ошибка поддержки сущности (5)
DmTF Reserved (..)
Зарезервировано поставщиком (0x8000.. )

ElementName

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

Отображаемое имя объекта. Это свойство наследуется от CIM_ManagedElement.

EnabledDefault

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

Конфигурация администратора по умолчанию или конфигурация запуска для включенного состояния элемента. Это свойство наследуется от CIM_EnabledLogicalElement.

EnabledState

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

Включенные и отключенные состояния элемента. Он также может указывать переходы между этими запрошенными состояниями. Это свойство наследуется от CIM_EnabledLogicalElement.

HealthState

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

Текущая работоспособность элемента. Этот атрибут выражает работоспособность данного элемента, но не обязательно его подкомпонентов. Возможные значения: от 0 до 30, где 5 означает, что элемент полностью работоспособен, а 30 означает, что элемент полностью нефункциональный. Это свойство наследуется от CIM_ManagedSystemElement.

InstallDate

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

Дата и время создания конфигурации виртуальной машины. Это свойство наследуется от CIM_ManagedSystemElement.

InstanceID

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Ключ

Уникально идентифицирует экземпляр этого класса. Это свойство наследуется от CIM_ManagedElement и всегда имеет значение Null.

имя;

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

Метка, по которой известен объект. Это свойство наследуется от CIM_Service.

OperatingStatus

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

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

Неизвестно (0)
Недоступно (1)
Обслуживание (2)
Начиная ( 3)
Остановка (4)
Остановлено (5)
Прервано (6)
Неактивный (7)
Завершено (8)
Миграция (9)
Эмигрирование (10)
Иммигрирование (11)
Создание моментальных снимков (12)
Завершение работы (13)
В тесте (14)
Переход ( 15)
В службе (16)
Зарезервировано DMTF (..)
Зарезервировано поставщиком (0x8000.. )

OperationalStatus

Тип данных: массив uint16
Тип доступа: только для чтения

Текущие состояния объекта. Это свойство наследуется от CIM_ManagedSystemElement.

OtherEnabledState

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

Строка, описывающая состояние включенного или отключенного элемента, когда свойству EnabledState присвоено значение 1 (Other). Это свойство должно иметь значение Null , если EnabledState имеет любое значение, отличное от 1. Это свойство наследуется от CIM_EnabledLogicalElement.

PrimaryOwnerContact

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

Значение типа , предоставляющее сведения о том, как можно получить доступ к основному владельцу службы (например, номер телефона, адрес электронной почты и т. д.). Это свойство наследуется от CIM_Service.

PrimaryOwnerName

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

Имя основного владельца службы, если он определен. Основным владельцем является первоначальный контакт службы поддержки. Это свойство наследуется от CIM_Service.

PrimaryStatus

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

Предоставляет сведения о состоянии высокого уровня. Это свойство следует использовать вместе со свойством DetailedStatus , чтобы обеспечить высокий уровень и подробное состояние работоспособности элемента и его подкомпонентов. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
ОК (1)
Понижение производительности (2)
Ошибка (3)
Зарезервировано DMTF (..)
Зарезервировано поставщиком (0x8000.. )

RequestedState

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

Последнее запрошенное или требуемое состояние элемента. Фактическое состояние элемента представлено EnabledState. Это свойство предоставляется для сравнения последних запрошенных и текущих включенных или отключенных состояний. Конкретный экземпляр CIM_EnabledLogicalElement может не поддерживать метод RequestStateChange . В этом случае используется значение 12 (неприменимо). Это свойство наследуется от CIM_EnabledLogicalElement.

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

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

Указывает, запущена ли служба в данный момент. Это свойство наследуется от CIM_Service.

StartMode

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

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

Состояние

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

Состояние элемента. Это свойство наследуется от CIM_ManagedSystemElement.

Описания состояния

Тип данных: строковый массив
Тип доступа: только для чтения

Строки, описывающие различные значения массива OperationalStatus . Это свойство наследуется от CIM_ManagedSystemElement.

SystemCreationClassName

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

Имя класса создания системы области. Это свойство наследуется от CIM_Service.

SystemName

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

Имя системы размещения компьютера. Это свойство наследуется от CIM_Service.

TimeOfLastStateChange

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

Дата или время последнего изменения включенного состояния элемента. Это свойство наследуется от CIM_EnabledLogicalElement.

TransitioningToState

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

Указывает целевое состояние, в которое переходит экземпляр. Это свойство наследуется от CIM_EnabledLogicalElement.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Пространство имен	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

См. также раздел

CIM_Service

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