Win32_TSGatewayServerSettings-Klasse

Artikel
06/13/2023

Stellt Methoden und Eigenschaften zum Anzeigen und Konfigurieren von Remotedesktopgateway-Servereinstellungen bereit. Ein Administrator kann diese Klasse verwenden, um eine Reihe von Protokollen, den Satz von Ereignissen, die in das Ereignisprotokoll geschrieben werden, und die maximale Anzahl von Verbindungen über RD-Gateway zu konfigurieren.

Syntax

[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;
};

Member

Die Win32_TSGatewayServerSettings-Klasse verfügt über folgende Membertypen:

Methoden
Eigenschaften

Methoden

Die Win32_TSGatewayServerSettings-Klasse verfügt über diese Methoden.

Methode	BESCHREIBUNG
Konfigurieren	Konfiguriert die IIS- und RPC-Einstellungen, die für den RD-Gatewaydienst erforderlich sind. Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.
EnableCentralCAP	Aktiviert oder deaktiviert die CentralCAPEnabled-Eigenschaft , die steuert, ob zentrale Remotedesktop-Verbindungsautorisierungsrichtlinien (RD CAP)-Server zum Steuern von Verbindungsautorisierungsrichtlinien für diesen Server verwendet werden.
EnableLogEvent	Aktiviert oder deaktiviert die Protokollierung des angegebenen Ereignistyps.
EnableOnlyConsentCapableClients	Legt die OnlyConsentCapableClients-Eigenschaft fest . Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.
EnableRequestSOH	Diese Methode wird ab Windows Server 2016 nicht unterstützt. Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 und Windows Server 2008: Aktiviert oder deaktiviert Anforderungen für ein Statement of Health (SoH).
EnableTransport	Aktiviert oder deaktiviert den angegebenen Transport. Windows Server 2008 R2 und Windows Server 2008: Diese Methode ist vor Windows Server 2012 nicht verfügbar.
EnumAuthenticationPlugins	Listet alle registrierten Authentifizierungs-Plug-Ins auf. Windows Server 2008: Diese Methode ist nicht verfügbar.
EnumAuthorizationPlugins	Listet alle registrierten Autorisierungs-Plug-Ins auf. Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.
GetIPAndPort	Ruft die lauschenden IP-Adresse und die Portnummer für den angegebenen Transport ab. Windows Server 2008 R2 und Windows Server 2008: Diese Methode ist vor Windows Server 2012 nicht verfügbar.
GetLogEventName	Gibt den Protokollereignisnamen für den angegebenen Protokollereignisindex zurück.
GetProtocolName	Gibt den Protokollnamen für den angegebenen Protokollindex zurück.
IsLogEventEnabled	Gibt an, ob der angegebene Ereignisprotokolltyp aktiviert ist.
IsTransportEnabled	Bestimmt, ob der angegebene Transport aktiviert ist. Windows Server 2008 R2 und Windows Server 2008: Diese Methode ist vor Windows Server 2012 nicht verfügbar.
QueryCertContext	Gibt an, ob das angegebene Zertifikat installiert ist.
RecycleRpcApplicationPools	Verwendet die RPC-Anwendungspools in IIS wieder. Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.
RefreshCertContext	Aktualisiert das Zertifikat, das vom RD-Gatewayserver verwendet wird.
SetAuthenticationPlugin	Legt das aktuelle Authentifizierungs-Plug-In für den RD-Gatewayserver fest. Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.
SetAuthenticationPluginAndRecycleRpcApplicationPools	Legt das aktuelle Authentifizierungs-Plug-In für den RD-Gatewayserver fest und verwendet die RPC-Anwendungspools in IIS wieder. Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.
SetAuthorizationPlugin	Legt das aktuelle Autorisierungs-Plug-In für den RD-Gatewayserver fest. Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.
Setcertificate	Legt den Zertifikathash für die HTTPS-Bindung an Port 443 in IIS fest. Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.
SetCertificateACL	Legt die Zertifikatzugriffssteuerungslisten (Certificate Access Control Lists, ACLs) für diesen Server fest.
SetDefaultPluginsAndRecycleRpcApplicationPools	Legt die aktuellen Authentifizierungs- und Autorisierungs-Plug-Ins für den RD-Gatewayserver fest und verwendet die RPC-Anwendungspools in IIS wieder. Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.
SetEnforceChannelBinding	Legt die EnforceChannelBinding-Eigenschaft fest . Windows Server 2008 R2 und Windows Server 2008: Diese Methode ist vor Windows Server 2012 nicht verfügbar.
SetIPAndPort	Legt die lauschend-IP-Adresse und die Portnummer für den angegebenen Transport fest. Windows Server 2008 R2 und Windows Server 2008: Diese Methode ist vor Windows Server 2012 nicht verfügbar.
SetMaxConnections	Legt die maximale Anzahl zulässiger Verbindungen über das RD-Gateway fest. Diese Methode ändert die Eigenschaften MaxConnections und UnlimitedConnections .
SetSslBridging	Legt den Typ des SSL-Bridgings fest, der vom RD-Gatewayserver verwendet werden soll. Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.
TSGRemoveAdminMsg	Entfernt die Administrative Nachricht für den Gatewayserver. Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.
TSGRemoveConsentMsg	Entfernt die Administrative Nachricht für den Gatewayserver. Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.
TSGStoreAdminMsg	Updates die Administratornachricht für den Gatewayserver. Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.
TSGStoreConsentMsg	Updates die Zustimmungsmeldung für den Gatewayserver. Windows Server 2008: Diese Methode ist vor Windows Server 2008 R2 nicht verfügbar.

Eigenschaften

Die Win32_TSGatewayServerSettings-Klasse verfügt über diese Eigenschaften.

adminMessageEndTime

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Die Endzeit der Administrativen Nachricht.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

adminMessageStartTime

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Die Startzeit der Administrativen Nachricht.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

adminMessageText

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Der Administrative Nachrichtentext.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

AuthenticationPluginCLSID

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Die CLSID des aktuellen Authentifizierungs-Plug-Ins.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

AuthenticationPluginDescription

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Die Beschreibung des aktuellen Authentifizierungs-Plug-Ins.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

AuthenticationPluginName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Der Name des aktuellen Authentifizierungs-Plug-Ins.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

AuthorizationPluginCLSID

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Die CLSID des aktuellen Autorisierungs-Plug-Ins.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

AuthorizationPluginDescription

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Die Beschreibung des aktuellen Autorisierungs-Plug-Ins.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

AuthorizationPluginName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Der Name des aktuellen Autorisierungs-Plug-Ins.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

CentralCAPEnabled

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt

Gibt an, ob zentrale RD-CAP-Server für die Steuerung dieses Servers verwendet werden. Diese Eigenschaft kann durch Aufrufen der EnableCentralCAP-Methode geändert werden.

CertHash

Datentyp: uint8-Array
Zugriffstyp: Schreibgeschützt

Gibt den Zertifikathash für die HTTPS-Bindung an Port 443 in IIS an.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

consentMessageText

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Der Text der Zustimmungsnachricht.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

EnforceChannelBinding

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt

Gibt an, ob die Kanalbindung für den HTTP-Transport erzwungen wird. Dieser Eigenschaftswert kann mithilfe der SetEnforceChannelBinding-Methode geändert werden.

Windows Server 2008 R2 und Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2012 nicht verfügbar.

IsConfigured

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt

Gibt an, ob IIS- und RPC-Einstellungen konfiguriert werden, die für den RD-Gatewaydienst erforderlich sind.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

MaxConnections

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schlüssel

Gibt die maximale Anzahl von Verbindungen zurück, die über RD-Gateway zulässig sind. Diese Eigenschaft kann mit der SetMaxConnections-Methode festgelegt werden.

MaximumAllowedConnectionsBySku

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Die maximale Anzahl von Verbindungen, die die Lagerhaltungseinheit (SKU) zulässt.

MaxLogEvents

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Gibt die maximale Anzahl von Protokollereignissen zurück.

MaxProtocols

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Anzahl der vom RD-Gateway unterstützten Protokolle.

OnlyConsentCapableClients

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt

Gibt an, ob nur Clients, die zustimmungsfähige Nachrichten haben, eine Verbindung mit dem RD-Gateway herstellen dürfen.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

Nonzero

Nur Zustimmungsnachrichtenfähige Clients können eine Verbindung herstellen.

Null

Clients, die keine Zustimmungsmeldung können, können ebenfalls eine Verbindung herstellen.

RequestSOH

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird ab Windows Server 2016 nicht unterstützt.

**Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 und Windows Server 2008: **

Gibt an, ob der Server eine SoH (Statement of Health) vom Client anfordern muss. Diese Eigenschaft kann mithilfe der EnableRequestSOH-Methode geändert werden.

SkuName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Name der SKU

SslBridging

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Gibt an, welcher Ssl-Bridging vom RD-Gatewayserver verwendet werden soll. Dies kann einer der folgenden Werte sein.

Windows Server 2008: Diese Eigenschaft ist vor Windows Server 2008 R2 nicht verfügbar.

Keine SSL-Überbrückung.

HTTPS-zu-HTTP-Bridging.

HTTPS-zu-HTTPS-Überbrückung.

UnlimitedConnections

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt

Gibt an, ob eine unbegrenzte Anzahl von Verbindungen über RD-Gateway zulässig ist. Diese Eigenschaft kann mit der SetMaxConnections-Methode festgelegt werden.

Bemerkungen

Sie müssen Mitglied der Gruppe Administratoren sein, um diese Klasse verwenden zu können.

MOF-Dateien (Managed Object Format) enthalten die Definitionen für WMI-Klassen (Windows Management Instrumentation). MOF-Dateien werden nicht als Teil des Microsoft Windows Software Development Kit (SDK) installiert. Sie werden auf dem Server installiert, wenn Sie die zugeordnete Rolle mithilfe des Server-Manager hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Verwaltetes Objektformat (MOF).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	WindowsServer 2008
Namespace	Root\CIMv2\TerminalServices
MOF	TSGateway.mof
DLL	AagWmi.dll

Siehe auch

Win32_TSGatewayConnection
Win32_TSGatewayConnectionAuthorizationPolicy
Win32_TSGatewayLoadBalancer
Win32_TSGatewayRADIUSServer
Win32_TSGatewayResourceAuthorizationPolicy
Win32_TSGatewayResourceGroup

Freigeben über

Win32_TSGatewayServerSettings-Klasse

Syntax

Member

Methoden

Eigenschaften

Bemerkungen

Anforderungen

Siehe auch

Feedback

Zusätzliche Ressourcen