Win32_TSGatewayServerSettings类

提供用于查看和配置远程桌面网关 (RD 网关) 服务器设置的方法和属性。 管理员可以使用此类来配置一组协议、将写入事件日志的事件集，以及通过 RD 网关建立的最大连接数。

语法

[dynamic, provider("AAGProvider"), AMENDMENT]
class Win32_TSGatewayServerSettings
{
  uint32  MaxConnections;
  boolean UnlimitedConnections;
  uint32  MaximumAllowedConnectionsBySku;
  string  SkuName;
  uint32  MaxProtocols;
  uint32  MaxLogEvents;
  string  adminMessageText;
  string  adminMessageStartTime;
  string  adminMessageEndTime;
  string  consentMessageText;
  boolean OnlyConsentCapableClients;
  boolean CentralCAPEnabled;
  boolean RequestSOH;
  string  AuthenticationPluginName;
  string  AuthenticationPluginCLSID;
  string  AuthenticationPluginDescription;
  string  AuthorizationPluginName;
  string  AuthorizationPluginCLSID;
  string  AuthorizationPluginDescription;
  uint32  SslBridging;
  boolean IsConfigured;
  uint8   CertHash[];
  boolean EnforceChannelBinding;
};

成员

Win32_TSGatewayServerSettings类包含以下类型的成员：

• 方法
• 属性

方法

Win32_TSGatewayServerSettings类具有这些方法。

方法	说明
配置	配置 RD 网关服务所需的 IIS 和 RPC 设置。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。
EnableCentralCAP	启用或禁用 CentralCAPEnabled 属性，该属性控制中央远程桌面连接授权策略 (RD CAP) 服务器是否用于控制此服务器的连接授权策略。
EnableLogEvent	启用或禁用指定事件类型的日志记录。
EnableOnlyConsentCapableClients	设置 OnlyConsentCapableClients 属性。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。
EnableRequestSOH	从 Windows Server 2016 开始，不支持此方法。 Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 和 Windows Server 2008：启用或禁用对运行状况声明 (SoH) 的请求。
EnableTransport	启用或禁用指定的传输。 Windows Server 2008 R2 和 Windows Server 2008：此方法在Windows Server 2012之前不可用。
EnumAuthenticationPlugins	枚举所有已注册的身份验证插件。 Windows Server 2008：此方法不可用。
EnumAuthorizationPlugins	枚举所有已注册的授权插件。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。
GetIPAndPort	获取指定传输的侦听 IP 地址和端口号。 Windows Server 2008 R2 和 Windows Server 2008：此方法在Windows Server 2012之前不可用。
GetLogEventName	返回指定日志事件索引的日志事件日志名称。
GetProtocolName	返回指定协议索引的协议名称。
IsLogEventEnabled	指示是否启用指定的事件日志类型。
IsTransportEnabled	确定是否启用指定的传输。 Windows Server 2008 R2 和 Windows Server 2008：此方法在Windows Server 2012之前不可用。
QueryCertContext	指示是否已安装指定的证书。
RecycleRpcApplicationPools	回收 IIS 中的 RPC 应用程序池。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。
RefreshCertContext	刷新 RD 网关服务器使用的证书。
SetAuthenticationPlugin	设置 RD 网关服务器的当前身份验证插件。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。
SetAuthenticationPluginAndRecycleRpcApplicationPools	设置 RD 网关服务器的当前身份验证插件，并在 IIS 中回收 RPC 应用程序池。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。
SetAuthorizationPlugin	设置 RD 网关服务器的当前授权插件。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。
SetCertificate	在 IIS 中的端口 443 上设置 HTTPS 绑定的证书哈希。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。
SetCertificateACL	设置此服务器的证书访问控制列表 (ACL) 。
SetDefaultPluginsAndRecycleRpcApplicationPools	设置 RD 网关服务器的当前身份验证和授权插件，并在 IIS 中回收 RPC 应用程序池。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。
SetEnforceChannelBinding	设置 EnforceChannelBinding 属性。 Windows Server 2008 R2 和 Windows Server 2008：此方法在Windows Server 2012之前不可用。
SetIPAndPort	设置指定传输的侦听 IP 地址和端口号。 Windows Server 2008 R2 和 Windows Server 2008：此方法在Windows Server 2012之前不可用。
SetMaxConnections	设置通过 RD 网关允许的最大连接数。 此方法更改 MaxConnections 和 UnlimitedConnections 属性。
SetSslBridging	设置 RD 网关服务器要使用的 SSL 桥接的类型。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。
TSGRemoveAdminMsg	删除网关服务器的管理消息。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。
TSGRemoveConsentMsg	删除网关服务器的管理消息。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。
TSGStoreAdminMsg	更新网关服务器的管理消息。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。
TSGStoreConsentMsg	更新网关服务器的同意消息。 Windows Server 2008：此方法在 Windows Server 2008 R2 之前不可用。

属性

Win32_TSGatewayServerSettings类具有以下属性。

adminMessageEndTime

数据类型： 字符串

访问类型：只读

管理消息结束时间。

Windows Server 2008：Windows Server 2008 R2 之前，此属性不可用。

adminMessageStartTime

数据类型： 字符串

访问类型：只读

管理消息开始时间。

Windows Server 2008：Windows Server 2008 R2 之前，此属性不可用。

adminMessageText

数据类型： 字符串

访问类型：只读

管理消息文本。

Windows Server 2008：Windows Server 2008 R2 之前，此属性不可用。

AuthenticationPluginCLSID

数据类型： 字符串

访问类型：只读

当前身份验证插件的 CLSID。

Windows Server 2008：Windows Server 2008 R2 之前，此属性不可用。

AuthenticationPluginDescription

数据类型： 字符串

访问类型：只读

当前身份验证插件的说明。

Windows Server 2008：Windows Server 2008 R2 之前，此属性不可用。

AuthenticationPluginName

数据类型： 字符串

访问类型：只读

当前身份验证插件的名称。

Windows Server 2008：Windows Server 2008 R2 之前，此属性不可用。

AuthorizationPluginCLSID

数据类型： 字符串

访问类型：只读

当前授权插件的 CLSID。

Windows Server 2008：Windows Server 2008 R2 之前，此属性不可用。

AuthorizationPluginDescription

数据类型： 字符串

访问类型：只读

当前授权插件的说明。

Windows Server 2008：Windows Server 2008 R2 之前，此属性不可用。

AuthorizationPluginName

数据类型： 字符串

访问类型：只读

当前授权插件的名称。

Windows Server 2008：Windows Server 2008 R2 之前，此属性不可用。

CentralCAPEnabled

数据类型： 布尔值

访问类型：只读

指定中央 RD CAP 服务器是否用于控制此服务器。 可以通过调用 EnableCentralCAP 方法更改此属性。

CertHash

数据类型： uint8 数组

访问类型：只读

指定 IIS 中端口 443 上的 HTTPS 绑定的证书哈希。

Windows Server 2008：Windows Server 2008 R2 之前，此属性不可用。

consentMessageText

数据类型： 字符串

访问类型：只读

同意消息文本。

Windows Server 2008：Windows Server 2008 R2 之前，此属性不可用。

EnforceChannelBinding

数据类型： 布尔值

访问类型：只读

指示是否为 HTTP 传输强制实施通道绑定。 可以使用 SetEnforceChannelBinding 方法更改此属性值。

Windows Server 2008 R2 和 Windows Server 2008：此属性在Windows Server 2012之前不可用。

IsConfigured

数据类型： 布尔值

访问类型：只读

指定是否配置 RD 网关服务所需的 IIS 和 RPC 设置。

Windows Server 2008：Windows Server 2008 R2 之前，此属性不可用。

MaxConnections

数据类型： uint32

访问类型：只读

限定符： 密钥

返回通过 RD 网关允许的最大连接数。 可以使用 SetMaxConnections 方法设置此属性。

MaximumAllowedConnectionsBySku

数据类型： uint32

访问类型：只读

保留单位 (SKU) 允许的最大连接数。

MaxLogEvents

数据类型： uint32

访问类型：只读

返回日志事件的最大数目。

MaxProtocols

数据类型： uint32

访问类型：只读

RD 网关支持的协议数。

OnlyConsentCapableClients

数据类型： 布尔值

访问类型：只读

指定仅允许能够同意消息的客户端连接到 RD 网关。

Windows Server 2008：Windows Server 2008 R2 之前，此属性不可用。

零

只有支持同意消息的客户端才能连接。

零

不支持同意消息的客户端也可以连接。

RequestSOH

数据类型： 布尔值

访问类型：只读

从Windows Server 2016开始，不支持此属性。

**Windows Server 2012 R2、Windows Server 2012、Windows Server 2008 R2 和 Windows Server 2008： **

指定服务器是否必须从客户端请求运行状况声明 (SoH) 。 可以使用 EnableRequestSOH 方法更改此属性。

SkuName

数据类型： 字符串

访问类型：只读

SKU 的名称。

SslBridging

数据类型： uint32

访问类型：只读

指定 RD 网关服务器要使用的 SSL 桥接类型。 这可以是以下值之一。

Windows Server 2008：此属性在 Windows Server 2008 R2 之前不可用。

0

无 SSL 桥接。

1

HTTPS 到 HTTP 桥接。

2

HTTPS 到 HTTPS 桥接。

UnlimitedConnections

数据类型： 布尔值

访问类型：只读

指示是否允许通过 RD 网关进行无限数量的连接。 可以使用 SetMaxConnections 方法设置此属性。

注解

你必须是管理员组的成员才能使用此类。

托管对象格式 (MOF) 文件包含Windows Management Instrumentation (WMI) 类的定义。 MOF 文件未作为 Microsoft Windows 软件开发工具包 (SDK) 的一部分安装。 使用服务器管理器添加关联角色时，这些角色安装在服务器上。 有关 MOF 文件的详细信息，请参阅 托管对象格式 (MOF) 。

要求

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMv2\TerminalServices
MOF	TSGateway.mof
DLL	AagWmi.dll

另请参阅

Win32_TSGatewayConnection

Win32_TSGatewayConnectionAuthorizationPolicy

Win32_TSGatewayLoadBalancer

Win32_TSGatewayRADIUSServer

Win32_TSGatewayResourceAuthorizationPolicy

Win32_TSGatewayResourceGroup