Win32_TSGatewayServerSettings classe
Fournit des méthodes et des propriétés pour afficher et configurer les paramètres du serveur de passerelle Bureau à distance (passerelle Bureau à distance). Un administrateur peut utiliser cette classe pour configurer un ensemble de protocoles, l’ensemble d’événements qui seront écrits dans le journal des événements et le nombre maximal de connexions via la passerelle Bureau à distance.
Syntaxe
[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;
};
Membres
La classe Win32_TSGatewayServerSettings a les types de membres suivants :
Méthodes
La classe Win32_TSGatewayServerSettings a ces méthodes.
Méthode | Description |
---|---|
Configurer | Configure les paramètres IIS et RPC requis par le service de passerelle Bureau à distance. Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
EnableCentralCAP | Active ou désactive la propriété CentralCAPEnabled , qui contrôle si les serveurs centraux de stratégie d’autorisation de connexion Bureau à distance (CAP Bureau à distance) sont utilisés pour contrôler les stratégies d’autorisation de connexion pour ce serveur. |
EnableLogEvent | Active ou désactive la journalisation du type d’événement spécifié. |
EnableOnlyConsentCapableClients | Définit la propriété OnlyConsentCapableClients . Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
EnableRequestSOH | Cette méthode n’est pas prise en charge à partir de Windows Server 2016. Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 et Windows Server 2008 : active ou désactive les demandes pour une instruction d’intégrité (SoH). |
EnableTransport | Active ou désactive le transport spécifié. Windows Server 2008 R2 et Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2012. |
EnumAuthenticationPlugins | Énumère tous les plug-ins d’authentification inscrits. Windows Server 2008 : Cette méthode n’est pas disponible. |
EnumAuthorizationPlugins | Énumère tous les plug-ins d’autorisation inscrits. Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
GetIPAndPort | Obtient l’adresse IP d’écoute et le numéro de port pour le transport spécifié. Windows Server 2008 R2 et Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2012. |
GetLogEventName | Retourne le nom de l’événement de journal pour l’index d’événement de journal spécifié. |
GetProtocolName | Retourne le nom du protocole pour l’index de protocole spécifié. |
IsLogEventEnabled | Indique si le type de journal des événements spécifié est activé. |
IsTransportEnabled | Détermine si le transport spécifié est activé. Windows Server 2008 R2 et Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2012. |
QueryCertContext | Indique si le certificat spécifié est installé. |
RecycleRpcApplicationPools | Recycle les pools d’applications RPC dans IIS. Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
RefreshCertContext | Actualise le certificat utilisé par le serveur de passerelle Bureau à distance. |
SetAuthenticationPlugin | Définit le plug-in d’authentification actuel pour le serveur de passerelle Bureau à distance. Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
SetAuthenticationPluginAndRecycleRpcApplicationPools | Définit le plug-in d’authentification actuel pour le serveur de passerelle Bureau à distance et recycle les pools d’applications RPC dans IIS. Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
SetAuthorizationPlugin | Définit le plug-in d’autorisation actuel pour le serveur de passerelle Bureau à distance. Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
SetCertificate | Définit le hachage de certificat pour la liaison HTTPS sur le port 443 dans IIS. Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
SetCertificateACL | Définit les listes de contrôle d’accès des certificats (ACL) pour ce serveur. |
SetDefaultPluginsAndRecycleRpcApplicationPools | Définit les plug-ins d’authentification et d’autorisation actuels pour le serveur de passerelle Bureau à distance et recycle les pools d’applications RPC dans IIS. Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
SetEnforceChannelBinding | Définit la propriété EnforceChannelBinding . Windows Server 2008 R2 et Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2012. |
SetIPAndPort | Définit l’adresse IP d’écoute et le numéro de port pour le transport spécifié. Windows Server 2008 R2 et Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2012. |
SetMaxConnections | Définit le nombre maximal de connexions autorisées via la passerelle Bureau à distance. Cette méthode modifie les propriétés MaxConnections et UnlimitedConnections . |
SetSslBridging | Définit le type de pontage SSL à utiliser par le serveur de passerelle Bureau à distance. Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
TSGRemoveAdminMsg | Supprime le message d’administration pour le serveur de passerelle. Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
TSGRemoveConsentMsg | Supprime le message d’administration pour le serveur de passerelle. Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
TSGStoreAdminMsg | Mises à jour le message administratif pour le serveur de passerelle. Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
TSGStoreConsentMsg | Mises à jour le message de consentement pour le serveur de passerelle. Windows Server 2008 : Cette méthode n’est pas disponible avant Windows Server 2008 R2. |
Propriétés
La classe Win32_TSGatewayServerSettings possède ces propriétés.
-
adminMessageEndTime
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Heure de fin du message administratif.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
-
-
adminMessageStartTime
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Heure de début du message administratif.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
-
-
adminMessageText
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Texte du message administratif.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
-
-
AuthenticationPluginCLSID
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
CLSID du plug-in d’authentification actuel.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
-
-
AuthenticationPluginDescription
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Description du plug-in d’authentification actuel.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
-
-
AuthenticationPluginName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom du plug-in d’authentification actuel.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
-
-
AuthorizationPluginCLSID
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
CLSID du plug-in d’autorisation actuel.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
-
-
AuthorizationPluginDescription
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Description du plug-in d’autorisation actuel.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
-
-
AuthorizationPluginName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom du plug-in d’autorisation actuel.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
-
-
CentralCAPEnabled
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Spécifie si les serveurs CAP bureau à distance centraux sont utilisés pour le contrôle de ce serveur. Cette propriété peut être modifiée en appelant la méthode EnableCentralCAP .
-
-
CertHash
-
-
Type de données : tableau uint8
-
Type d'accès : Lecture seule
Spécifie le hachage de certificat pour la liaison HTTPS sur le port 443 dans IIS.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
-
-
consentMessageText
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Texte du message de consentement.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
-
-
EnforceChannelBinding
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Indique si la liaison de canal est appliquée pour le transport HTTP. Cette valeur de propriété peut être modifiée à l’aide de la méthode SetEnforceChannelBinding .
Windows Server 2008 R2 et Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2012.
-
-
IsConfigured
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Spécifie si les paramètres IIS et RPC requis par le service de passerelle Bureau à distance sont configurés.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
-
-
MaxConnections
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : clé
Retourne le nombre maximal de connexions autorisées via la passerelle Bureau à distance. Cette propriété peut être définie à l’aide de la méthode SetMaxConnections .
-
-
MaximumAllowedConnectionsBySku
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
Nombre maximal de connexions autorisées par l’unité de conservation des stocks (SKU).
-
-
MaxLogEvents
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
Retourne le nombre maximal d’événements de journal.
-
-
MaxProtocols
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
Nombre de protocoles pris en charge par la passerelle Bureau à distance.
-
-
OnlyConsentCapableClients
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Spécifie si seuls les clients capables de donner leur consentement aux messages sont autorisés à se connecter à la passerelle Bureau à distance.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
-
-
non nul
-
Seuls les clients compatibles avec les messages de consentement peuvent se connecter.
-
zéro
-
Les clients qui ne sont pas compatibles avec les messages de consentement peuvent également se connecter.
RequestSOH
-
Type de données : booléen
-
Type d'accès : Lecture seule
Cette propriété n’est pas prise en charge à partir de Windows Server 2016.
**Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 et Windows Server 2008 : **
Spécifie si le serveur doit demander une instruction d’intégrité (SoH) au client. Cette propriété peut être modifiée à l’aide de la méthode EnableRequestSOH .
SkuName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom de la SKU.
SslBridging
-
Type de données : uint32
-
Type d'accès : Lecture seule
Spécifie le type de pontage SSL à utiliser par le serveur de passerelle Bureau à distance. Il peut s’agir de l’une des valeurs suivantes.
Windows Server 2008 : Cette propriété n’est pas disponible avant Windows Server 2008 R2.
0
Aucun pont SSL.
1
Pontage HTTPS à HTTP.
2
Pontage HTTPS à HTTPS.
UnlimitedConnections
-
Type de données : booléen
-
Type d'accès : Lecture seule
Indique si un nombre illimité de connexions sont autorisées via la passerelle Bureau à distance. Cette propriété peut être définie à l’aide de la méthode SetMaxConnections .
Notes
Vous devez être membre du groupe Administrateurs pour utiliser cette classe.
Les fichiers MOF (Managed Object Format) contiennent les définitions des classes WMI (Windows Management Instrumentation). Les fichiers MOF ne sont pas installés dans le cadre du Kit de développement logiciel (SDK) Microsoft Windows. Ils sont installés sur le serveur lorsque vous ajoutez le rôle associé à l’aide du Gestionnaire de serveur. Pour plus d’informations sur les fichiers MOF, consultez Managed Object Format (MOF).
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Aucun pris en charge |
Serveur minimal pris en charge |
Windows Server 2008 |
Espace de noms |
Root\CIMv2\TerminalServices |
MOF |
|
DLL |
|