Win32_TSSessionDirectory classe
Définit les paramètres de configuration du service Broker pour les connexions Bureau à distance pour la classe Win32_TSSessionDirectorySetting .
Notes
Dans Windows Server 2008 R2, le nom de Terminal Services Session Broker (TS Session Broker) a été modifié en Broker pour les connexions Bureau à distance. Ces propriétés s’appliquent à tous les systèmes d’exploitation pris en charge, sauf indication contraire.
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_TSSESSIONDIRECTORY_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TSSessionDirectory : CIM_Setting
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
string SessionDirectoryLocation;
uint32 PolicySourceSessionDirectoryLocation;
uint32 SessionDirectoryActive;
uint32 PolicySourceSessionDirectoryActive;
uint32 SessionDirectoryExposeServerIP;
uint32 PolicySourceSessionDirectoryExposeServerIP;
string SessionDirectoryClusterName;
uint32 PolicySourceLoadBalancing;
uint32 GetLoadBalancingState;
uint32 GetServerWeight;
uint32 PolicySourceSessionDirectoryClusterName;
string SessionDirectoryIPAddress;
uint32 GetTSRedirectorMode;
uint32 PolicySourceTSRedirectorMode;
};
Membres
La classe Win32_TSSessionDirectory a les types de membres suivants :
Méthodes
La classe Win32_TSSessionDirectory a ces méthodes.
| Méthode | Description |
|---|---|
| CreateUserDiskTemplate | Crée un modèle de disque utilisateur. |
| DisableUserVhd | Désactive un disque dur virtuel de profil utilisateur. |
| EnableUserVhd | Active un disque dur virtuel de profil utilisateur sur un serveur RDSH. |
| GetCurrentRedirectableAddresses | Obtient la liste actuellement configurée des adresses DNS éligibles et le type de redirection. |
| GetRedirectableAddresses | Obtient la liste complète des adresses ÉLIGIBLES DNS. |
| PingSessionDirectory | Vérifie si le serveur Broker pour les connexions Bureau à distance est disponible. |
| SetCurrentRedirectableAddresses | Définit la liste configurée des adresses DNS éligibles et le type de redirection. |
| SetLoadBalancingState | Définit la valeur pour indiquer si le serveur participera à l’équilibrage de charge du service Broker pour les connexions Bureau à distance. |
| SetServerWeight | Définit la valeur de pondération du serveur pour l’équilibrage de charge du service Broker pour les connexions Bureau à distance. |
| SetSessionDirectoryActive | Désactive et active le service Broker pour les connexions Bureau à distance. |
| SetSessionDirectoryExposeServerIP | Définit la propriété SessionDirectoryExposeServerIP . |
| SetSessionDirectoryProperty | Définit la propriété SessionDirectoryLocation ou la propriété SessionDirectoryClusterName . |
| SetTSRedirectorMode | Cette méthode n’est pas disponible. |
Propriétés
La classe Win32_TSSessionDirectory a ces propriétés.
-
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.
-
-
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.
-
-
GetLoadBalancingState
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si le serveur est configuré pour participer à l’équilibrage de charge du service Broker pour les connexions Bureau à distance.
-
-
0
-
Le serveur n’est pas configuré pour participer à l’équilibrage de charge du service Broker pour les connexions Bureau à distance.
-
1
-
Le serveur est configuré pour participer à l’équilibrage de charge du service Broker pour les connexions Bureau à distance.
GetServerWeight
-
Type de données : uint32
-
Type d'accès : Lecture seule
Récupère la valeur de poids du serveur utilisée dans l’équilibrage de charge du service Broker pour les connexions Bureau à distance.
GetTSRedirectorMode
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si le serveur est configuré pour agir en tant que redirecteur des services Bureau à distance.
0
Le serveur est configuré pour agir comme redirecteur des services Bureau à distance.
1
Le serveur n’est pas configuré pour agir en tant que redirecteur des services Bureau à distance.
Windows Server 2008 : Cette propriété n’est pas disponible.
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.
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.
PolicySourceLoadBalancing
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété GetLoadBalancingState est configurée par le serveur ou par la stratégie de groupe.
0 (0x0)
Serveur
1 (0x1)
Stratégie de groupe
PolicySourceSessionDirectoryActive
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété SessionDirectoryActive est configurée par le serveur ou par la stratégie de groupe.
0 (0x0)
Serveur
1 (0x1)
Stratégie de groupe
PolicySourceSessionDirectoryClusterName
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété SessionDirectoryClusterName est configurée par le serveur ou par la stratégie de groupe.
0 (0x0)
Serveur
1 (0x1)
Stratégie de groupe
PolicySourceSessionDirectoryExposeServerIP
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété SessionDirectoryExposeServerIP est configurée par le serveur ou par la stratégie de groupe.
0 (0x0)
Serveur
1 (0x1)
Stratégie de groupe
PolicySourceSessionDirectoryLocation
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété SessionDirectoryLocation est configurée par le serveur ou par la stratégie de groupe.
0 (0x0)
Serveur
1 (0x1)
Stratégie de groupe
PolicySourceTSRedirectorMode
-
Type de données : uint32
-
Type d'accès : Lecture seule
Cette propriété n’est pas disponible.
Windows Server 2008 R2 : Indique si la propriété GetTSRedirectorMode est configurée par le serveur ou par la stratégie de groupe.
0 (0x0)
Serveur
1 (0x1)
Stratégie de groupe
SessionDirectoryActive
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : clé
Spécifie si les services Bureau à distance participent au répartiteur de connexions Bureau à distance.
FALSE (0)
La participation aux services Bureau à distance dans le répartiteur de connexion Bureau à distance est désactivée.
TRUE (1)
La participation aux services Bureau à distance dans le répartiteur de connexions Bureau à distance est activée.
SessionDirectoryClusterName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Adresse IP virtuelle du cluster auquel appartient le serveur hôte de session Bureau à distance.
SessionDirectoryExposeServerIP
-
Type de données : uint32
-
Type d'accès : Lecture seule
Spécifie si la récupération de l’adresse IP du répartiteur de connexions Bureau à distance est autorisée.
FALSE (0)
La récupération est refusée.
TRUE (1)
La récupération est autorisée.
SessionDirectoryIPAddress
-
Type de données : chaîne
-
Type d’accès : Lecture/écriture
Adresse IP de l’adaptateur LAN utilisé par le répertoire de session.
SessionDirectoryLocation
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom DNS réseau ou adresse IP du serveur sur lequel le service Broker de connexions Bureau à distance est en cours d’exécution.
É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 »)
Notes
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")
Dans Windows Server 2008, le nom de la fonctionnalité Répertoire de session des services Terminal Server a été modifié en Broker de session Terminal Services.
Dans Windows Server 2008 R2, le nom de la fonctionnalité Service Terminal Services Session Broker a été remplacé par Broker de connexion Bureau à distance.
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 |
|