classe Win32_TSClientSetting

Article
06/12/2023

La classe WMI Win32_TSClientSetting définit les paramètres de configuration de la classe Win32_Terminal liée à la stratégie de connexion.

La syntaxe suivante est simplifiée à partir du code MOF et inclut toutes les propriétés définies et héritées, par ordre alphabétique. Pour obtenir des informations de référence sur les méthodes, consultez le tableau des méthodes plus loin dans cette rubrique.

Syntaxe

[dynamic, provider("Win32_WIN32_TSCLIENTSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSClientSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ConnectionPolicy;
  uint32   ConnectClientDrivesAtLogon;
  uint32   ConnectPrinterAtLogon;
  uint32   DefaultToClientPrinter;
  uint32   PolicySourceDefaultToClientPrinter;
  uint32   WindowsPrinterMapping;
  uint32   PolicySourceWindowsPrinterMapping;
  uint32   LPTPortMapping;
  uint32   PolicySourceLPTPortMapping;
  uint32   COMPortMapping;
  uint32   PolicySourceCOMPortMapping;
  uint32   DriveMapping;
  uint32   PolicySourceDriveMapping;
  uint32   AudioMapping;
  uint32   PolicySourceAudioMapping;
  uint32   ClipboardMapping;
  uint32   PolicySourceClipboardMapping;
  uint32   ColorDepthPolicy;
  uint32   PolicySourceColorDepthPolicy;
  uint32   ColorDepth;
  uint32   PolicySourceColorDepth;
  uint32   MaxMonitors;
  uint32   MaxXResolution;
  uint32   MaxYResolution;
  uint32   PolicySourceMaxMonitors;
  uint32   PolicySourceMaxResolution;
  uint32   PNPRedirection;
  uint32   PolicySourcePNPRedirection;
  uint32   AudioCaptureRedir;
  uint32   PolicySourceAudioCaptureRedir;
  uint32   VideoPlaybackRedir;
  uint32   PolicySourceVideoPlaybackRedir;
  uint32   AllowDwm;
  uint32   PolicySourceAllowDwm;
  uint32   PolicyAdvancedRemoteAppGraphics;
  uint32   AdvancedRemoteAppGraphics;
  uint32   RemoteSessionProfile;
  uint32   PolicySourceRemoteSessionProfile;
  uint32   AVC444ModePreferred;
  uint32   PolicySourceAvc444ModePreferred;
  uint32   EncodeImageQuality;
  uint32   PolicySourceEncodeImageQuality;
  uint32   HardwareGraphicsAdapter;
  uint32   PolicySourceHardwareGraphicsAdapter;
  uint32   SelectTransport;
  uint32   PolicySourceSelectTransport;
  uint32   SelectNetworkDetect;
  uint32   PolicySourceSelectNetworkDetect;
};

Membres

La classe Win32_TSClientSetting a les types de membres suivants :

Méthodes
Propriétés

Méthodes

La classe Win32_TSClientSetting a ces méthodes.

Méthode	Description
ConnectionSettings	Définit les propriétés ConnectClientDrivesAtLogon, ConnectPrinterAtLogon et DefaultToClientPrinter de cette classe.
SetAllowDwm	Non pris en charge. Windows 7 et Windows Server 2008 R2 : Définit la propriété AllowDwm .
SetClientProperty	Définit la propriété LPTPortMapping, COMPortMapping, AudioMapping, ClipboardMapping, DriveMapping ou WindowsPrinterMapping .
SetColorDepth	Définit la propriété ColorDepth .
SetColorDepthPolicy	Définit la propriété ColorDepthPolicy .
SetMaxMonitors	Définit la propriété MaxMonitors .
SetMaxXResolution	Définit la propriété MaxXResolution .
SetMaxYResolution	Définit la propriété MaxYResolution .

Propriétés

La classe Win32_TSClientSetting possède ces propriétés.

AdvancedRemoteAppGraphics

Type de données : uint32
Type d’accès : Lecture/écriture

Spécifie s’il faut activer les graphiques RemoteFX avancés pour RemoteApp.

Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 et Windows Vista : cette propriété n’est pas disponible avant Windows Server 2012 R2 et Windows 8.1.

FALSE (0)

Les graphiques avancés sont désactivés.

TRUE (1)

Les graphiques avancés sont activés.

AllowDwm

Type de données : uint32
Type d'accès : Lecture seule

Cette propriété n’est pas disponible.

**Windows 7 et Windows Server 2008 R2 : **

Spécifie s’il faut activer ou désactiver la composition du Bureau à distance. Zéro désactive la composition du Bureau à distance et une valeur différente de zéro l’active.

Utilisez la méthode SetAllowDwm pour modifier cette propriété.

AudioCaptureRedir

Type de données : uint32
Type d'accès : Lecture seule

Spécifie s’il faut autoriser la redirection de capture audio.

Windows Server 2008 et Windows Vista : Cette propriété n’est pas disponible avant Windows Server 2008 R2 et Windows 7.

FALSE (0)

TRUE (1)

AudioMapping

Type de données : uint32
Type d'accès : Lecture seule

Spécifie si le mappage audio est désactivé ou activé.

FALSE (0)

Le mappage audio est activé.

TRUE (1)

Le mappage audio est désactivé.

AVC444ModePreferred

Type de données : uint32
Type d’accès : Lecture/écriture

Spécifie si le mode AVC444 est préféré.

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : cette propriété n’est pas disponible avant Windows 10 ou Windows Server 2016.

FALSE (0)

TRUE (1)

Caption

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : MaxLen (64)

Brève description (chaîne d’une ligne) de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

Presse-papiersMapping

Type de données : uint32
Type d'accès : Lecture seule

Spécifie si le mappage du Presse-papiers est désactivé ou activé.

FALSE (0)

Le mappage du Presse-papiers est activé.

TRUE (1)

Le mappage du Presse-papiers est désactivé.

ColorDepth

Type de données : uint32
Type d'accès : Lecture seule

Spécifie la profondeur de couleur. Pour connaître les valeurs possibles, consultez la méthode SetColorDepth .

8 bits (1)

15 bits (2)

16 bits (3)

24 bits (4)

32 bits (5)

ColorDepthPolicy

Type de données : uint32
Type d'accès : Lecture seule

Spécifie s’il faut remplacer le paramètre de couleur maximal de l’utilisateur.

FALSE (0)

Ne remplacez pas la stratégie de l’utilisateur.

TRUE (1)

Remplacez la stratégie de l’utilisateur.

COMPortMapping

Type de données : uint32
Type d'accès : Lecture seule

Spécifie si le mappage de port COM est désactivé ou activé.

FALSE (0)

Le mappage des ports COM est activé.

TRUE (1)

Le mappage de port COM est désactivé.

ConnectClientDrivesAtLogon

Type de données : uint32
Type d'accès : Lecture seule

Spécifie si les lecteurs du client seront automatiquement connectés pendant le processus d’ouverture de session.

FALSE (0)

Les lecteurs ne seront pas connectés automatiquement.

TRUE (1)

Les lecteurs sont automatiquement connectés.

ConnectionPolicy

Type de données : uint32
Type d’accès : Lecture/écriture

Stratégie que le serveur utilise pour récupérer les paramètres de connexion utilisateur.

Par utilisateur (0)

Les paramètres de connexion de l’utilisateur sont en vigueur.

Remplacement du serveur (1)

Les paramètres de connexion de l’utilisateur sont remplacés par le serveur.

ConnectPrinterAtLogon

Type de données : uint32
Type d'accès : Lecture seule

Spécifie si toutes les imprimantes locales mappées du client seront automatiquement connectées pendant le processus d’ouverture de session.

FALSE (0)

Les imprimantes locales ne sont pas connectées automatiquement.

TRUE (1)

Les imprimantes locales sont automatiquement connectées.

DefaultToClientPrinter

Type de données : uint32
Type d'accès : Lecture seule

Spécifie si les travaux d’impression seront automatiquement envoyés à l’imprimante locale du client.

FALSE (0)

Les travaux d’impression ne doivent pas être envoyés automatiquement à l’imprimante locale du client.

TRUE (1)

Les travaux d’impression doivent être automatiquement envoyés à l’imprimante locale du client.

Description

Type de données : chaîne
Type d'accès : Lecture seule

Description de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

DriveMapping

Type de données : uint32
Type d'accès : Lecture seule

Spécifie si le mappage de lecteur est désactivé ou activé.

FALSE (0)

Le mappage de lecteur est activé.

TRUE (1)

Le mappage de lecteur est désactivé.

EncodeImageQuality

Type de données : uint32
Type d’accès : Lecture/écriture

Spécifie la qualité de l’image pour l’expérience RDP.

Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : Cette propriété n’est pas disponible avant Windows 8 ou Windows Server 2012.

sans perte (1)

high (2)

moyenne (3)

HardwareGraphicsAdapter

Type de données : uint32
Type d’accès : Lecture/écriture

Spécifie si le serveur hôte de session Bureau à distance utilise le convertisseur graphique matériel comme adaptateur par défaut.

Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : Cette propriété n’est pas disponible avant Windows 8 ou Windows Server 2012.

FALSE (0)

TRUE (1)

InstallDate

Type de données : datetime
Type d'accès : Lecture seule
Qualificateurs : Mappingstrings (« MIF. DMTF| ComponentID|001.5 »)

Date à laquelle l’objet a été installé. L’absence d’une valeur n’indique pas que l’objet n’est pas installé.

Cette propriété est héritée de CIM_ManagedSystemElement.

LPTPortMapping

Type de données : uint32
Type d'accès : Lecture seule

Spécifie si le mappage de port LPT est désactivé ou activé.

FALSE (0)

Le mappage des ports LPT est activé.

TRUE (1)

Le mappage des ports LPT est désactivé.

MaxMonitors

Type de données : uint32
Type d'accès : Lecture seule

Nombre maximal de moniteurs pris en charge par le serveur. Utilisez la méthode SetMaxMonitors pour modifier cette propriété.

Windows Server 2008 et Windows Vista : Cette propriété n’est pas disponible avant Windows Server 2008 R2 et Windows 7.

MaxXResolution

Type de données : uint32
Type d'accès : Lecture seule

Résolution X maximale prise en charge par le serveur. Utilisez la méthode SetMaxXResolution pour modifier cette propriété.

Windows Server 2008 et Windows Vista : Cette propriété n’est pas disponible avant Windows Server 2008 R2 et Windows 7.

MaxYResolution

Type de données : uint32
Type d'accès : Lecture seule

Résolution Y maximale prise en charge par le serveur. Utilisez la méthode SetMaxYResolution pour modifier cette propriété.

Windows Server 2008 et Windows Vista : Cette propriété n’est pas disponible avant Windows Server 2008 R2 et Windows 7.

Nom

Type de données : chaîne
Type d'accès : Lecture seule

Nom de l'objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

PNPRedirection

Type de données : uint32
Type d'accès : Lecture seule

Spécifie s’il faut autoriser Plug-and-Play redirection.

FALSE (0)

Autorisez la redirection Plug-and-Play.

TRUE (1)

N’autorisez pas Plug-and-Play redirection.

PolicyAdvancedRemoteAppGraphics

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété AdvancedRemoteAppGraphics est configurée par la stratégie de serveur ou de groupe.

Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 et Windows Vista : cette propriété n’est pas disponible avant Windows Server 2012 R2 et Windows 8.1.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

PolicySourceAllowDwm

Type de données : uint32
Type d'accès : Lecture seule

Cette propriété n’est pas disponible.

**Windows 7 et Windows Server 2008 R2 : **

Indique si la propriété AllowDwm est configurée par le serveur ou la stratégie de groupe.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

PolicySourceAudioCaptureRedir

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété AudioCaptureRedir est configurée par la stratégie de serveur ou de groupe.

Windows Server 2008 et Windows Vista : Cette propriété n’est pas disponible avant Windows Server 2008 R2 et Windows 7.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

PolicySourceAudioMapping

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété AudioMapping est configurée par le serveur, la stratégie de groupe ou par défaut.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

2 (0x2)

Default

PolicySourceAvc444ModePreferred

Type de données : uint32
Type d'accès : Lecture seule

Indique comment la propriété AVC444ModePreferredis est configurée.

Serveur

Stratégie de groupe

PolicySourceClipboardMapping

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété ClipboardMapping est configurée par le serveur, la stratégie de groupe ou par défaut.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

2 (0x2)

Default

PolicySourceColorDepth

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété ColorDepth est configurée par le serveur, la stratégie de groupe ou par défaut.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

2 (0x2)

Default

PolicySourceColorDepthPolicy

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété ColorDepthPolicy est configurée par le serveur, la stratégie de groupe ou par défaut.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

2 (0x2)

Default

PolicySourceCOMPortMapping

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété COMPortMapping est configurée par le serveur, la stratégie de groupe ou par défaut.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

2 (0x2)

Default

PolicySourceDefaultToClientPrinter

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété DefaultToClientPrinter est configurée par le serveur, la stratégie de groupe ou par défaut.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

2 (0x2)

Default

PolicySourceDriveMapping

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété DriveMapping est configurée par le serveur, la stratégie de groupe ou par défaut.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

2 (0x2)

Default

PolicySourceEncodeImageQuality

Type de données : uint32
Type d'accès : Lecture seule

Indique comment encodeImageQualityi est configuré.

Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : Cette propriété n’est pas disponible avant Windows 8 ou Windows Server 2012.

Serveur

Stratégie de groupe

PolicySourceHardwareGraphicsAdapter

Type de données : uint32
Type d'accès : Lecture seule

Indique comment le HardwareGraphicsAdapter est configuré.

Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : Cette propriété n’est pas disponible avant Windows 8 ou Windows Server 2012.

Serveur

Stratégie de groupe

PolicySourceLPTPortMapping

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété LPTPortMapping est configurée par le serveur, la stratégie de groupe ou par défaut.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

2 (0x2)

Default

PolicySourceMaxMonitors

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété MaxMonitors est configurée par le serveur, la stratégie de groupe ou la valeur par défaut.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

2 (0x2)

Default

Windows Server 2008 et Windows Vista : Cette propriété n’est pas disponible avant Windows Server 2008 R2 et Windows 7.

PolicySourceMaxResolution

Type de données : uint32
Type d'accès : Lecture seule

Indique si les propriétés MaxXResolution et MaxYResolution sont configurées par le serveur, la stratégie de groupe ou par défaut.

Windows Server 2008 et Windows Vista : Cette propriété n’est pas disponible avant Windows Server 2008 R2 et Windows 7.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

2 (0x2)

Default

PolicySourcePNPRedirection

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété PNPRedirection est configurée par le serveur ou par la stratégie de groupe.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

PolicySourceRemoteSessionProfile

Type de données : uint32
Type d'accès : Lecture seule

Indique comment le RemoteSessionProfile est configuré.

Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : Cette propriété n’est pas disponible avant Windows 8 ou Windows Server 2012.

Serveur

Stratégie de groupe

PolicySourceSelectNetworkDetect

Type de données : uint32
Type d'accès : Lecture seule

Indique comment la propriété SelectNetworkDetect est configurée.

Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : Cette propriété n’est pas disponible avant Windows 8 ou Windows Server 2012.

Serveur

Stratégie de groupe

PolicySourceSelectTransport

Type de données : uint32
Type d'accès : Lecture seule

Indique comment la propriété SelectTransport est configurée.

Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : Cette propriété n’est pas disponible avant Windows 8 ou Windows Server 2012.

Serveur

Stratégie de groupe

PolicySourceVideoPlaybackRedir

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété VideoPlaybackRedir est configurée par la stratégie de serveur ou de groupe.

Windows Server 2008 et Windows Vista : Cette propriété n’est pas disponible avant Windows Server 2008 R2 et Windows 7.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

PolicySourceWindowsPrinterMapping

Type de données : uint32
Type d'accès : Lecture seule

Indique si la propriété WindowsPrinterMapping est configurée par le serveur, la stratégie de groupe ou par défaut.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

2 (0x2)

Default

RemoteSessionProfile

Type de données : uint32
Type d’accès : Lecture/écriture

Spécifie le profil pour l’expérience RDP.

Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : Cette propriété n’est pas disponible avant Windows 8 ou Windows Server 2012.

échelle (1)

expérience (2)

bande passante (3)

SélectionnezNetworkDetect

Type de données : uint32
Type d’accès : Lecture/écriture

Spécifie si la détection réseau est utilisée.

Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : Cette propriété n’est pas disponible avant Windows 8 ou Windows Server 2012.

utilisé au moment de la connexion et à l’état stable.

désactivé au moment de la connexion

désactivé à l’état stable

désactivé au moment de la connexion et à l’état stable.

SélectionnerTransporter

Type de données : uint32
Type d’accès : Lecture/écriture

Spécifie les protocoles de transport qui peuvent être utilisés pour l’accès RDP au serveur.

Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : Cette propriété n’est pas disponible avant Windows 8 ou Windows Server 2012.

Utilisez UDP et TCP.

Utilisez uniquement TCP.

Utilisez UDP ou TCP.

État

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : MaxLen (10)

Status actuelle de l’objet. Différents états opérationnels et non opérationnels peuvent être définis. Les états opérationnels sont les suivants : « OK », « Détérioré » et « Échec antérieur » (un élément, tel qu’un disque dur smart, peut fonctionner correctement, mais prédire une défaillance dans un avenir proche). Les états non opératoires sont les suivants : « Erreur », « Démarrage », « Arrêt » et « Service ». Ce dernier, « Service », peut s’appliquer pendant miroir redimensionnement d’un disque, le rechargement d’une liste d’autorisations utilisateur ou tout autre travail administratif. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK » ni dans l’un des autres états.

Cette propriété est héritée de CIM_ManagedSystemElement.

(« OK »)

(« Erreur »)

(« Dégradé »)

(« Inconnu »)

(« Échec antérieur »)

(« Démarrage »)

(« Arrêt »)

(« Service »)

TerminalName

Type de données : chaîne
Type d'accès : Lecture seule

Nom du terminal.

Cette propriété est héritée de Win32_TerminalSetting.

VideoPlaybackRedir

Type de données : uint32
Type d'accès : Lecture seule

Spécifie s’il faut autoriser la redirection de lecture vidéo.

Windows Server 2008 et Windows Vista : Cette propriété n’est pas disponible avant Windows Server 2008 R2 et Windows 7.

FALSE (0)

TRUE (1)

WindowsPrinterMapping

Type de données : uint32
Type d'accès : Lecture seule

Spécifie si le mappage d’imprimante est désactivé ou activé pour la fenêtre du client.

FALSE (0)

Le mappage d’imprimante est activé.

TRUE (1)

Le mappage d’imprimante est désactivé.

Notes

N’oubliez pas qu’une station de fenêtre associée à la session de console ne peut pas accéder aux méthodes et propriétés de cette classe. Si une tentative est effectuée en spécifiant « Console » comme valeur de la propriété TerminalName , les méthodes de cet objet retournent WBEM_E_NOT_SUPPORTED. Ce code d’erreur est également retourné si une station de fenêtre tente d’appeler des méthodes de cet objet pour ajouter ou modifier les propriétés de sécurité des comptes LocalSystem, LocalService ou NetworkService.

Pour vous connecter à l’espace de noms \root\CIMV2\TerminalServices, le niveau d’authentification doit inclure la confidentialité des paquets. Pour les appels C/C++, il s’agit d’un niveau d’authentification de RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Pour Visual Basic et les appels de script, il s’agit d’un niveau d’authentification de WbemAuthenticationLevelPktPrivacy ou « pktPrivacy », avec une valeur de six.

L’exemple suivant de Visual Basic Scripting Edition (VBScript) montre comment se connecter à un ordinateur distant avec la confidentialité des paquets.

strComputer = "RemoteServer1" 
Set objServices = GetObject( _
    "winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")

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	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Root\CIMv2\TerminalServices
MOF	TSCfgWmi.mof
DLL	TSCfgWmi.dll

Voir aussi

Win32_Terminal
Win32_TerminalSetting
CIM_Setting

Partager via

classe Win32_TSClientSetting

Syntaxe

Membres

Méthodes

Propriétés

Notes

Spécifications

Voir aussi

Commentaires

Ressources supplémentaires