Класс Win32_TSSessionSetting

Статья
06/13/2023

Класс WMI Win32_TSSessionSetting определяет параметры конфигурации для класса Win32_Terminal , такие как ограничения по времени, а также действия отключения и повторного подключения.

Следующий синтаксис упрощен из MOF-кода и включает все определенные и унаследованные свойства в алфавитном порядке. Справочные сведения о методах см. в таблице методов далее в этом разделе.

Синтаксис

[dynamic, provider("Win32_WIN32_TSSESSIONSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSSessionSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ActiveSessionLimit;
  uint32   BrokenConnectionAction;
  uint32   BrokenConnectionPolicy;
  uint32   DisconnectedSessionLimit;
  uint32   IdleSessionLimit;
  uint32   PolicySourceActiveSessionLimit;
  uint32   PolicySourceBrokenConnectionAction;
  uint32   PolicySourceDisconnectedSessionLimit;
  uint32   PolicySourceIdleSessionLimit;
  uint32   PolicySourceReconnectionPolicy;
  uint32   ReconnectionPolicy;
  uint32   TimeLimitPolicy;
  uint32   EnableTimeoutWarning;
};

Члены

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

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

Методы

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

Метод	Описание
BrokenConnection	Задает свойства неработаемых соединений, включенные в этот класс.
TimeLimit	Задает свойства ограничения по времени, включенные в этот класс.

Свойства

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

ActiveSessionLimit

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

Максимальное время в миллисекундах, выделенное активному сеансу. Значение 0 указывает бесконечное количество времени.

BrokenConnectionAction

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

Действие, выполняемое сервером в сеансе, когда подключение было разорвано из-за потери сети или превышения ограничений по времени.

Отключиться (0)

Пользователь отключен от сеанса.

Завершение (1)

Сеанс окончательно удаляется с сервера.

BrokenConnectionPolicy

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

Политика, используется сервером для определения того, когда следует разорвать подключение из-за потери сети или превышения ограничений по времени.

Переопределение сервера (1)

Параметры политики отключения пользователя переопределяются сервером.

На пользователя (0)

Действуют параметры политики отключения пользователя.

Caption

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

Краткое описание (однострочный текст) объекта.

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

Описание

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

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

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

DisconnectedSessionLimit

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

Интервал времени в миллисекундах, по истечении которого завершается отключенный сеанс. Значение 0 указывает бесконечное количество времени.

EnableTimeoutWarning

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

Включает предупреждение о времени ожидания.

Windows 7, Windows Server 2008 R2, Windows Vista и Windows Server 2008: Это свойство недоступно.

IdleSessionLimit

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

Интервал времени в миллисекундах, по истечении которого завершается бездействующий сеанс. Значение 0 указывает бесконечное количество времени.

InstallDate

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: Mappingstrings ("MIF. DMTF| ComponentID|001.5")

Дата установки объекта. Отсутствие значения не означает, что объект не установлен.

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

имя;

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

Имя объекта.

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

PolicySourceActiveSessionLimit

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

Указывает, настроено ли свойство ActiveSessionLimit сервером, групповой политикой или по умолчанию.

Сервер

Групповая политика

Значение по умолчанию

PolicySourceBrokenConnectionAction

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

Указывает, настроено ли свойство BrokenConnectionAction сервером, групповой политикой или по умолчанию.

Сервер

Групповая политика

Значение по умолчанию

PolicySourceDisconnectedSessionLimit

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

Указывает, настроено ли свойство DisconnectedSessionLimit сервером, групповой политикой или по умолчанию.

Сервер

Групповая политика

Значение по умолчанию

PolicySourceIdleSessionLimit

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

Указывает, настроено ли свойство IdleSessionLimit сервером, групповой политикой или по умолчанию.

Сервер

Групповая политика

Значение по умолчанию

PolicySourceReconnectionPolicy

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

Указывает, настроено ли свойство ReconnectPolicy сервером, групповой политикой или по умолчанию.

Сервер

Групповая политика

Значение по умолчанию

ReconnectionPolicy

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

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

Любой клиент (0)

Для повторного подключения будет использоваться любой клиент.

Предыдущий клиент (1)

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

Состояние

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

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

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

("ОК")

("Ошибка")

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

("Неизвестно")

("Pred Fail")

("Запуск")

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

("Служба")

Имя терминала

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

Имя терминала.

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

TimeLimitPolicy

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

Политика, используется сервером для определения временных ограничений для сеансов пользователей.

На пользователя (0)

Действуют параметры политики ограничений по времени пользователя.

Переопределение сервера (1)

Параметры политики ограничения времени пользователя переопределяются сервером.

Имейте в виду, что winstations, связанные с сеансом консоли, не могут получить доступ к методам и свойствам этого класса. Если предпринята попытка сделать это, указав "Console" в качестве значения свойства TerminalName, методы этого объекта будут возвращать WBEM_E_NOT_SUPPORTED. Этот код ошибки также возвращается, если оконная станция попытается вызвать методы этого объекта с целью добавления или изменения свойств безопасности учетных записей LocalSystem, LocalService или NetworkService.

Чтобы подключиться к пространству имен root\CIMV2\TerminalServices, уровень проверки подлинности должен включать конфиденциальность пакетов. Для вызовов C/C++ это будет уровень проверки подлинности RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Для вызовов Visual Basic и сценариев это будет уровень проверки подлинности WbemAuthenticationLevelPktPrivacy или pktPrivacy со значением 6. В следующем примере Visual Basic Scripting Edition (VBScript) показано, как подключиться к удаленному компьютеру с конфиденциальностью пакетов.

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

MOF-файлы содержат определения для классов инструментария управления Windows (WMI). MOF-файлы не устанавливаются в составе пакета SDK для Microsoft Windows. Они устанавливаются на сервере при добавлении связанной роли с помощью диспетчер сервера. Дополнительные сведения о MOF-файлах см. в разделе Формат управляемого объекта (MOF).

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMv2\TerminalServices
MOF	TSCfgWmi.mof
DLL	TSCfgWmi.dll

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

Win32_TerminalSetting
CIM_Setting

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

Класс Win32_TSSessionSetting

Синтаксис

Члены

Методы

Свойства

Комментарии

Требования

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

Обратная связь

Дополнительные ресурсы