класс Win32_TSClientSetting

Статья
06/13/2023

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

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

Синтаксис

[dynamic, provider("Win32_WIN32_TSCLIENTSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSClientSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ConnectionPolicy;
  uint32   ConnectClientDrivesAtLogon;
  uint32   ConnectPrinterAtLogon;
  uint32   DefaultToClientPrinter;
  uint32   PolicySourceDefaultToClientPrinter;
  uint32   WindowsPrinterMapping;
  uint32   PolicySourceWindowsPrinterMapping;
  uint32   LPTPortMapping;
  uint32   PolicySourceLPTPortMapping;
  uint32   COMPortMapping;
  uint32   PolicySourceCOMPortMapping;
  uint32   DriveMapping;
  uint32   PolicySourceDriveMapping;
  uint32   AudioMapping;
  uint32   PolicySourceAudioMapping;
  uint32   ClipboardMapping;
  uint32   PolicySourceClipboardMapping;
  uint32   ColorDepthPolicy;
  uint32   PolicySourceColorDepthPolicy;
  uint32   ColorDepth;
  uint32   PolicySourceColorDepth;
  uint32   MaxMonitors;
  uint32   MaxXResolution;
  uint32   MaxYResolution;
  uint32   PolicySourceMaxMonitors;
  uint32   PolicySourceMaxResolution;
  uint32   PNPRedirection;
  uint32   PolicySourcePNPRedirection;
  uint32   AudioCaptureRedir;
  uint32   PolicySourceAudioCaptureRedir;
  uint32   VideoPlaybackRedir;
  uint32   PolicySourceVideoPlaybackRedir;
  uint32   AllowDwm;
  uint32   PolicySourceAllowDwm;
  uint32   PolicyAdvancedRemoteAppGraphics;
  uint32   AdvancedRemoteAppGraphics;
  uint32   RemoteSessionProfile;
  uint32   PolicySourceRemoteSessionProfile;
  uint32   AVC444ModePreferred;
  uint32   PolicySourceAvc444ModePreferred;
  uint32   EncodeImageQuality;
  uint32   PolicySourceEncodeImageQuality;
  uint32   HardwareGraphicsAdapter;
  uint32   PolicySourceHardwareGraphicsAdapter;
  uint32   SelectTransport;
  uint32   PolicySourceSelectTransport;
  uint32   SelectNetworkDetect;
  uint32   PolicySourceSelectNetworkDetect;
};

Члены

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

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

Методы

Класс Win32_TSClientSetting содержит эти методы.

Метод	Описание
ConnectionSettings	Задает свойства ConnectClientDrivesAtLogon, ConnectPrinterAtLogon и DefaultToClientPrinter этого класса.
SetAllowDwm	Не поддерживается. Windows 7 и Windows Server 2008 R2: Задает свойство AllowDwm .
SetClientProperty	Задает свойство LPTPortMapping, COMPortMapping, AudioMapping, ClipboardMapping, DriveMapping или WindowsPrinterMapping .
SetColorDepth	Задает свойство ColorDepth .
SetColorDepthPolicy	Задает свойство ColorDepthPolicy .
SetMaxMonitors	Задает свойство MaxMonitors .
SetMaxXResolution	Задает свойство MaxXResolution .
SetMaxYResolution	Задает свойство MaxYResolution .

Свойства

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

AdvancedRemoteAppGraphics

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

Указывает, следует ли включать расширенные графические элементы RemoteFX для RemoteApp.

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

FALSE (0)

Расширенная графика отключена.

TRUE (1)

Расширенная графика включена.

AllowDwm

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

Это свойство недоступно.

**Windows 7 и Windows Server 2008 R2: **

Указывает, следует ли включать или отключать композицию удаленного рабочего стола. Ноль отключит композицию удаленного рабочего стола, а ненулевое значение включит его.

Используйте метод SetAllowDwm для изменения этого свойства.

AudioCaptureRedir

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

Указывает, следует ли разрешать перенаправление аудиозахвата.

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

FALSE (0)

TRUE (1)

AudioMapping

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

Указывает, отключено или включено сопоставление звука.

FALSE (0)

Сопоставление звука включено.

TRUE (1)

Сопоставление звука отключено.

AVC444ModePreferred

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

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

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Vista и Windows Server 2008: это свойство недоступно до Windows 10 или Windows Server 2016.

FALSE (0)

TRUE (1)

Caption

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

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

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

Буфер обмена

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

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

FALSE (0)

Сопоставление буфера обмена включено.

TRUE (1)

Сопоставление буфера обмена отключено.

ColorDepth

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

Задает глубину цвета. Возможные значения см. в методе SetColorDepth .

8 бит (1)

15 бит (2)

16 бит (3)

24-разрядный (4)

32-разрядный (5)

ColorDepthPolicy

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

Указывает, следует ли переопределить максимальное значение цвета пользователя.

FALSE (0)

Не переопределять политику пользователя.

TRUE (1)

Переопределите политику пользователя.

COMPortMapping

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

Указывает, отключено или включено сопоставление COM-портов.

FALSE (0)

Сопоставление COM-портов включено.

TRUE (1)

Сопоставление com-портов отключено.

ConnectClientDrivesAtLogon

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

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

FALSE (0)

Диски не будут подключены автоматически.

TRUE (1)

Диски будут подключены автоматически.

ConnectionPolicy

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

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

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

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

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

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

ConnectPrinterAtLogon

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

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

FALSE (0)

Локальные принтеры не будут подключены автоматически.

TRUE (1)

Локальные принтеры будут подключены автоматически.

DefaultToClientPrinter

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

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

FALSE (0)

Задания печати не должны автоматически отправляться на локальный принтер клиента.

TRUE (1)

Задания печати должны автоматически отправляться на локальный принтер клиента.

Описание

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

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

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

DriveMapping

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

Указывает, отключено или включено сопоставление дисков.

FALSE (0)

Сопоставление дисков включено.

TRUE (1)

Сопоставление дисков отключено.

EncodeImageQuality

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

Указывает качество изображения для интерфейса RDP.

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

без потерь (1)

высокий (2)

средний (3)

HardwareGraphicsAdapter

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

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

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

FALSE (0)

TRUE (1)

InstallDate

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

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

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

LPTPortMapping

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

Указывает, отключено или включено сопоставление портов LPT.

FALSE (0)

Включено сопоставление портов LPT.

TRUE (1)

Сопоставление портов LPT отключено.

MaxMonitors

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

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

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

MaxXResolution

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

Максимальное разрешение X, поддерживаемого сервером. Используйте метод SetMaxXResolution для изменения этого свойства.

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

MaxYResolution

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

Максимальное разрешение Y, поддерживаемого сервером. Используйте метод SetMaxYResolution для изменения этого свойства.

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

имя;

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

Имя объекта.

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

PNPRedirection

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

Указывает, следует ли разрешать перенаправление Plug and Play.

FALSE (0)

Разрешить перенаправление Plug and Play.

TRUE (1)

Не разрешайте перенаправление Plug and Play.

PolicyAdvancedRemoteAppGraphics

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

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

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

0 (0x0)

Сервер

1 (0x1)

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

PolicySourceAllowDwm

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

Это свойство недоступно.

**Windows 7 и Windows Server 2008 R2: **

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

0 (0x0)

Сервер

1 (0x1)

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

PolicySourceAudioCaptureRedir

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

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

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

0 (0x0)

Сервер

1 (0x1)

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

PolicySourceAudioMapping

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

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

0 (0x0)

Сервер

1 (0x1)

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

2 (0x2)

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

PolicySourceAvc444ModePreferred

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

Указывает, как настроено свойство AVC444ModePreferredis .

Сервер

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

PolicySourceClipboardMapping

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

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

0 (0x0)

Сервер

1 (0x1)

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

2 (0x2)

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

PolicySourceColorDepth

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

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

0 (0x0)

Сервер

1 (0x1)

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

2 (0x2)

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

PolicySourceColorDepthPolicy

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

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

0 (0x0)

Сервер

1 (0x1)

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

2 (0x2)

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

PolicySourceCOMPortMapping

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

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

0 (0x0)

Сервер

1 (0x1)

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

2 (0x2)

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

PolicySourceDefaultToClientPrinter

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

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

0 (0x0)

Сервер

1 (0x1)

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

2 (0x2)

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

PolicySourceDriveMapping

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

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

0 (0x0)

Сервер

1 (0x1)

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

2 (0x2)

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

PolicySourceEncodeImageQuality

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

Указывает, как настроен EncodeImageQualityi .

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

Сервер

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

PolicySourceHardwareGraphicsAdapter

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

Указывает, как настроен HardwareGraphicsAdapter .

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

Сервер

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

PolicySourceLPTPortMapping

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

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

0 (0x0)

Сервер

1 (0x1)

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

2 (0x2)

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

PolicySourceMaxMonitors

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

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

0 (0x0)

Сервер

1 (0x1)

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

2 (0x2)

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

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

PolicySourceMaxResolution

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

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

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

0 (0x0)

Сервер

1 (0x1)

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

2 (0x2)

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

PolicySourcePNPRedirection

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

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

0 (0x0)

Сервер

1 (0x1)

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

PolicySourceRemoteSessionProfile

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

Указывает, как настроен RemoteSessionProfile .

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

Сервер

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

PolicySourceSelectNetworkDetect

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

Указывает, как настроено свойство SelectNetworkDetect .

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

Сервер

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

PolicySourceSelectTransport

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

Указывает, как настроено свойство SelectTransport .

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

Сервер

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

PolicySourceVideoPlaybackRedir

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

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

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

0 (0x0)

Сервер

1 (0x1)

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

PolicySourceWindowsPrinterMapping

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

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

0 (0x0)

Сервер

1 (0x1)

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

2 (0x2)

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

RemoteSessionProfile

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

Указывает профиль для интерфейса RDP.

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

scale (1)

опыт (2)

пропускная способность (3)

ВыберитеNetworkDetect

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

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

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

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

отключено во время подключения

отключено в устойчивом состоянии

отключено во время подключения и в устойчивом состоянии.

ВыберитеTransport (Перевод)

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

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

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

Используйте UDP и TCP.

Используйте только TCP.

Используйте UDP или TCP.

Состояние

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

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

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

("ОК")

("Ошибка")

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

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

("Pred Fail")

("Запуск")

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

("Служба")

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

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

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

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

VideoPlaybackRedir

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

Указывает, следует ли разрешить перенаправление воспроизведения видео.

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

FALSE (0)

TRUE (1)

WindowsPrinterMapping

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

Указывает, отключено или включено сопоставление принтеров для окна клиента.

FALSE (0)

Сопоставление принтеров включено.

TRUE (1)

Сопоставление принтеров отключено.

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

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

В следующем примере 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_Terminal
Win32_TerminalSetting
CIM_Setting

класс Win32_TSClientSetting

Синтаксис

Члены

Методы

Свойства

Комментарии

Требования

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

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

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

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