Класс Win32_TSGeneralSetting
Класс WMI Win32_TSGeneralSetting представляет общие параметры терминала, такие как уровень шифрования и транспортный протокол.
Следующий синтаксис упрощен из MOF-кода и включает все определенные и унаследованные свойства в алфавитном порядке. Справочные сведения о методах см. в таблице методов далее в этом разделе.
Синтаксис
[dynamic, provider("Win32_WIN32_TSGENERALSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSGeneralSetting : Win32_TerminalSetting
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
string TerminalName;
string CertificateName;
uint8 Certificates[];
string Comment;
uint32 MinEncryptionLevel;
uint32 PolicySourceMinEncryptionLevel;
uint32 PolicySourceSecurityLayer;
uint32 PolicySourceUserAuthenticationRequired;
uint32 SecurityLayer;
string SSLCertificateSHA1Hash;
uint32 SSLCertificateSHA1HashType;
string TerminalProtocol;
string Transport;
uint32 UserAuthenticationRequired;
uint32 WindowsAuthentication;
};
Члены
Класс Win32_TSGeneralSetting имеет следующие типы членов:
Методы
Класс Win32_TSGeneralSetting содержит эти методы.
Метод | Описание |
---|---|
SetEncryptionLevel | Задает уровень шифрования. |
SetSecurityLayer | Задает уровень безопасности RDP Security Layer (0), Negotiate (1) или SSL (2). |
SetUserAuthenticationRequired | Включает или отключает требование о том, что пользователи должны проходить проверку подлинности во время подключения, задавая значение свойства UserAuthenticationRequired . |
Свойства
Класс Win32_TSGeneralSetting имеет эти свойства.
-
Caption
-
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: MaxLen (64)
Краткое описание (однострочный текст) объекта.
Это свойство наследуется от CIM_ManagedSystemElement.
-
-
CertificateName
-
-
Тип данных: string
-
Тип доступа: только для чтения
Отображаемое имя для имени субъекта личного сертификата локального компьютера.
-
-
Сертификаты
-
-
Тип данных: массив uint8
-
Тип доступа: только для чтения
Содержит сериализованное хранилище сертификатов, содержащее все сертификаты из хранилища учетной записи пользователя на компьютере, которые являются допустимыми сертификатами сервера для использования с ssl-протоколом.
-
-
Комментарий
-
-
Тип данных: string
-
Тип доступа: чтение и запись
Описательное имя сочетания уровня сеанса и транспортного протокола.
-
-
Описание
-
-
Тип данных: string
-
Тип доступа: только для чтения
Описание объекта.
Это свойство наследуется от CIM_ManagedSystemElement.
-
-
InstallDate
-
-
Тип данных: datetime
-
Тип доступа: только для чтения
-
Квалификаторы: Mappingstrings ("MIF. DMTF| ComponentID|001.5")
Дата установки объекта. Отсутствие значения не означает, что объект не установлен.
Это свойство наследуется от CIM_ManagedSystemElement.
-
-
MinEncryptionLevel
-
-
Тип данных: uint32
-
Тип доступа: только для чтения
-
Квалификаторы: низкий ("Только данные, отправляемые с клиента на сервер, защищены шифрованием на основе стандартной надежности ключа сервера). Данные, отправляемые с сервера на клиент, не защищены.), средний ("Все данные, передаваемые между сервером и клиентом, защищены шифрованием на основе стандартной надежности ключа сервера)."), высокий ("Все данные, передаваемые между сервером и клиентом, защищены шифрованием на основе максимальной надежности ключа сервера").)
Минимальный уровень шифрования.
-
-
Низкий (1)
-
Низкий уровень шифрования. Только данные, отправленные с клиента на сервер, шифруются с помощью 56-разрядного шифрования. Имейте в виду, что данные, отправляемые с сервера клиенту, не шифруются.
-
Средний / Клиентский совместимый (2)
-
Совместимый с клиентом уровень шифрования. Все данные, отправляемые с клиента на сервер и от сервера к клиенту, шифруются с максимальной надежностью ключа, поддерживаемой клиентом.
-
Высокий (3)
-
Высокий уровень шифрования. Все данные, отправляемые с клиента на сервер и от сервера к клиенту, шифруются с помощью надежного 128-разрядного шифрования. Клиенты, которые не поддерживают этот уровень шифрования, не могут подключиться.
-
FiPS-совместимые (4)
-
Шифрование, совместимое с FIPS. Все данные, передаваемые от клиента к серверу и от сервера к клиенту, шифруются и расшифровываются с помощью алгоритмов шифрования FIPS с помощью криптографических модулей Майкрософт. FIPS — это стандарт под названием "Требования к безопасности для криптографических модулей". FIPS 140-1 (1994) и FIPS 140-2 (2001) описывают требования правительства к аппаратным и программным криптографическим модулям, используемым в правительстве США.
имя;
-
Тип данных: string
-
Тип доступа: только для чтения
Имя объекта.
Это свойство наследуется от CIM_ManagedSystemElement.
PolicySourceMinEncryptionLevel
-
Тип данных: uint32
-
Тип доступа: только для чтения
Указывает, настроено ли свойство MinEncryptionLevel сервером, групповой политикой или по умолчанию.
0 (0x0)
Сервер
1 (0x1)
Групповая политика
2 (0x2)
Значение по умолчанию
PolicySourceSecurityLayer
-
Тип данных: uint32
-
Тип доступа: только для чтения
Указывает, настроено ли свойство SecurityLayer сервером, групповой политикой или по умолчанию.
0 (0x0)
Сервер
1 (0x1)
Групповая политика
2 (0x2)
Значение по умолчанию
PolicySourceUserAuthenticationRequired
-
Тип данных: uint32
-
Тип доступа: только для чтения
Указывает, настроено ли свойство UserAuthenticationRequired сервером, групповой политикой или по умолчанию.
0 (0x0)
Сервер
1 (0x1)
Групповая политика
2 (0x2)
Значение по умолчанию
SecurityLayer
-
Тип данных: uint32
-
Тип доступа: только для чтения
-
Квалификаторы: RDPSecurityLayer ("Уровень безопасности RDP: обмен данными между сервером и клиентом будет использовать собственное шифрование RDP"."), Negotiate ("Будет использоваться наиболее безопасный уровень, поддерживаемый клиентом. Если поддержка поддерживается, будет использоваться TLS 1.0. Ssl ("SSL (TLS 1.0) будет использоваться для проверки подлинности сервера, а также для шифрования всех данных, передаваемых между сервером и клиентом. Для этого параметра требуется, чтобы сервер был совместим с SSL-сертификатом."), NEWTBD ("A NEW SECURITY LAYER in LONGHORN").
Указывает уровень безопасности, используемый между клиентом и сервером.
Уровень безопасности RDP (1)
Обмен данными между сервером и клиентом использует собственное шифрование RDP.
Согласование (2)
Используется наиболее безопасный уровень, поддерживаемый клиентом. Если он поддерживается, используется ПРОТОКОЛ SSL (TLS 1.0).
SSL (3)
SSL (TLS 1.0) используется для проверки подлинности сервера и шифрования всех данных, передаваемых между сервером и клиентом. Для этого параметра требуется, чтобы на сервере был ssl-совместимый сертификат. Этот параметр несовместим со значением MinEncryptionLevel , равным 1.
NEWTBD (4)
Новый уровень безопасности.
SSLCertificateSHA1Hash
-
Тип данных: string
-
Тип доступа: чтение и запись
Указывает хэш SHA1 в шестнадцатеричном формате SSL-сертификата, используемого целевым сервером.
Отпечаток сертификата можно найти с помощью оснастки MMC "Сертификаты" на вкладке Сведения на странице свойств сертификата.
SSLCertificateSHA1HashType
-
Тип данных: uint32
-
Тип доступа: только для чтения
Указывает состояние свойства SSLCertificateSHA1Hash .
0 (0x0)
Недопустимая
1 (0x1)
Самозаверяющий по умолчанию
2 (0x2)
Принудительно применяется групповая политика по умолчанию
3 (0x3)
Особые настройки
Состояние
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: MaxLen (10)
Текущее состояние объекта. Можно определить различные операционные и нерабочие состояния. Операционные состояния: "ОК", "Понижено" и "Сбой pred" (элемент, например жесткий диск с поддержкой SMART, может работать правильно, но прогнозирует сбой в ближайшем будущем). К нерабочим состояниям относятся: "Ошибка", "Запуск", "Остановка" и "Служба". Последняя служба может применяться во время зеркало повторного изменения диска, перезагрузки списка разрешений пользователя или других административных действий. Не все такие работы выполняются в режиме on-line, но управляемый элемент не является ни "ОК", ни в одном из других состояний.
Это свойство наследуется от CIM_ManagedSystemElement.
("ОК")
("Ошибка")
("Пониженная производительность")
("Неизвестно")
("Pred Fail")
("Запуск")
("Остановка")
("Служба")
Имя терминала
-
Тип данных: string
-
Тип доступа: только для чтения
Имя терминала.
Это свойство наследуется от Win32_TerminalSetting.
TerminalProtocol
-
Тип данных: string
-
Тип доступа: только для чтения
Имя протокола уровня сеанса; Например, Microsoft RDP 5.0.
Транспорт
-
Тип данных: string
-
Тип доступа: только для чтения
Тип транспорта, используемого в соединении; например, TCP, NetBIOS или IPX/SPX.
UserAuthenticationRequired
-
Тип данных: uint32
-
Тип доступа: только для чтения
Указывает тип проверки подлинности пользователя, используемой для удаленных подключений. Если задано значение 1, то это означает , что параметр UserAuthenticationRequired требует проверки подлинности пользователя во время подключения, чтобы повысить защиту сервера от сетевых атак. Подключаться могут только клиенты протокола удаленного рабочего стола (RDP) с поддержкой RDP версии 6.0 или более поздней. Чтобы избежать перебоев в работе удаленных пользователей, перед включением свойства рекомендуется развернуть клиенты RDP, поддерживающие соответствующую версию протокола.
Чтобы включить или отключить это свойство, используйте метод SetUserAuthenticationRequired .
FALSE (0)
Проверка подлинности пользователя при подключении отключена.
TRUE (1)
Проверка подлинности пользователя при подключении включена.
WindowsAuthentication
-
Тип данных: uint32
-
Тип доступа: чтение и запись
Указывает, используется ли подключение по умолчанию к стандартному процессу проверка подлинности Windows или к другому пакету проверки подлинности, установленному в системе.
FALSE (0)
По умолчанию не использует стандартный процесс проверка подлинности Windows.
TRUE (1)
По умолчанию используется стандартный процесс проверка подлинности Windows.
Комментарии
Имейте в виду, что оконные станции, не связанные с сеансом консоли, не могут получить доступ к методам и свойствам этого класса. Если предпринята попытка сделать это, указав "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 |
|
DLL |
|