_Classe TSClientSetting Win32

La classe WMI Win32 _ TSClientSetting définit des paramètres de configuration pour la classe de _ Terminal Win32 associée à la stratégie de connexion.

La syntaxe suivante est simplifiée à partir du code MOF et comprend 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 possède les types de membres suivants :

Méthodes

La classe Win32 _ TSClientSetting possède 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 a ces propriétés.

AdvancedRemoteAppGraphics

Type de données : UInt32

Type d’accès : lecture/écriture

spécifie s’il faut activer advanced RemoteFX graphics 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 le permet.

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.

ClipboardMapping

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é.

La

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 de port 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 sont connectés automatiquement au cours du processus d’ouverture de session.

False (0)

Les lecteurs ne sont pas automatiquement connectés.

True (1)

Les lecteurs seront automatiquement connectés.

ConnectionPolicy

Type de données : UInt32

Type d’accès : lecture/écriture

La stratégie utilisée par le serveur pour récupérer les paramètres de connexion utilisateur.

Par utilisateur (0)

Les paramètres de connexion de l’utilisateur sont activés.

Serveur-override (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 connectées automatiquement au cours du processus d’ouverture de session.

False (0)

Les imprimantes locales ne seront pas connectées automatiquement.

True (1)

Les imprimantes locales seront automatiquement connectées.

DefaultToClientPrinter

Type de données : UInt32

Type d'accès : Lecture seule

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

False (0)

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

True (1)

Les travaux d’impression doivent être envoyés automatiquement à 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)

élevé (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 de port LPT est activé.

True (1)

Le mappage de port 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 maximale X 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 de Plug-and-Play.

True (1)

N’autorisez pas la redirection de Plug-and-Play.

PolicyAdvancedRemoteAppGraphics

Type de données : UInt32

Type d'accès : Lecture seule

Indique si la propriété AdvancedRemoteAppGraphics est configurée par le serveur ou la stratégie 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 le serveur ou la stratégie 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)

Valeur par défaut

PolicySourceAvc444ModePreferred

Type de données : UInt32

Type d'accès : Lecture seule

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

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.

0

Serveur

1

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)

Valeur par défaut

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)

Valeur par défaut

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)

Valeur par défaut

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)

Valeur par défaut

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)

Valeur par défaut

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)

Valeur par défaut

PolicySourceEncodeImageQuality

Type de données : UInt32

Type d'accès : Lecture seule

Indique la configuration de EncodeImageQualityi .

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.

0

Serveur

1

Stratégie de groupe

PolicySourceHardwareGraphicsAdapter

Type de données : UInt32

Type d'accès : Lecture seule

Indique la configuration de HardwareGraphicsAdapter .

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.

0

Serveur

1

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)

Valeur par défaut

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 par défaut.

0 (0x0)

Serveur

1 (0x1)

Stratégie de groupe

2 (0X2)

Valeur par défaut

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)

Valeur par défaut

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 la configuration de RemoteSessionProfile .

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.

0

Serveur

1

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.

0

Serveur

1

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.

0

Serveur

1

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 le serveur ou la stratégie 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)

Valeur par défaut

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)

SelectNetworkDetect

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.

0

utilisé au moment de la connexion et dans un état stable.

1

désactivé au moment de la connexion

2

désactivé dans un état stable

3

désactivé au moment de la connexion et dans un état stable.

SelectTransport

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.

0

Utilisez à la fois UDP et TCP.

1

Utilisez uniquement TCP.

2

Utilisez le protocole UDP ou TCP.

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10)

État actuel de l’objet. Divers États opérationnels et inopérationnels peuvent être définis. Les États opérationnels sont les suivants : « OK », « détérioré » et « échec prévu » (un élément, tel qu’un lecteur de disque dur intelligent, peut fonctionner correctement, mais prédire une défaillance dans un avenir proche). Les États qui ne sont pas opérationnels sont les suivants : « erreur », « démarrage », « arrêt » et « service ». Le dernier, « service », peut s’appliquer pendant la réargentation en miroir d’un disque, le rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives. Tous les travaux de ce type ne sont pas en ligne, mais l’élément géré n’est ni « OK », ni de l’un des autres États.

Cette propriété est héritée de CIM _ ManagedSystemElement.

(« OK »)

(« Erreur »)

(« Détérioré »)

("Inconnu")

(« Échec prédit »)

(« 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 de l’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

Sachez qu’une station de fenêtre associée à la session de console ne peut pas accéder aux méthodes et aux propriétés de cette classe. Si vous tentez de le faire en spécifiant « console » comme valeur de la propriété TerminalName , les méthodes de cet objet retournent WBEM _ E _ non _ pris en charge. Ce code d’erreur est également retourné si une station Windows 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 se connecter à \ l' \ \ espace de noms licences TS cimv2 racine, le niveau d’authentification doit inclure la confidentialité du paquet. Pour les appels C/C++, il s’agit d’un niveau d’authentification de la _ _ _ _ _ confidentialité du niveau d’authentification RPC c. pour les Visual Basic et les appels de script, il s’agit d’un niveau d’authentification WbemAuthenticationLevelPktPrivacy ou « pktPrivacy », avec une valeur de six.

l’exemple VBScript (Visual Basic scripting Edition) suivant montre comment se connecter à un ordinateur distant avec la confidentialité du paquet.

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

les fichiers format MOF (MOF) contiennent les définitions des classes Windows Management Instrumentation (WMI). 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 de l’Gestionnaire de serveur. Pour plus d’informations sur les fichiers MOF, consultez format MOF (MOF).

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
Racine \ cimv2 \ licences TS
MOF
TSCfgWmi. mof
DLL
TSCfgWmi.dll

Voir aussi

_Terminal Win32

_TerminalSetting Win32

_Paramètre CIM