Win32_TSGatewayServerSettings 類別

發行項
06/13/2023

提供方法和屬性，以檢視和設定遠端桌面閘道 (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類別具有這些方法。

方法	Description
設定	設定 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 之前無法使用。

無 SSL 橋接。

HTTPS 到 HTTP 橋接。

HTTPS 到 HTTPS 橋接。

UnlimitedConnections

資料類型： 布林值
存取類型：唯讀

指出是否允許透過 RD 閘道無限數量的連線。您可以使用 SetMaxConnections 方法來設定這個屬性。

備註

您必須是 Administrators 群組的成員，才能使用此類別。

Managed 物件格式 (MOF) 檔案包含 Windows Management Instrumentation (WMI) 類別的定義。 MOF 檔案不會安裝為 Microsoft Windows 軟體發展工具組 (SDK) 的一部分。當您使用伺服器管理員新增相關聯的角色時，它們會安裝在伺服器上。如需 MOF 檔案的詳細資訊，請參閱 Managed 物件格式 (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

共用方式為

Win32_TSGatewayServerSettings 類別

語法

成員

方法

屬性

備註

規格需求

另請參閱

意見反應

其他資源