classe Win32_TSNetworkAdapterSetting
La classe WMI Win32_TSNetworkAdapterSetting définit différents paramètres de configuration pour la classe Win32_Terminal , notamment les propriétés liées à la carte réseau et le nombre maximal de connexions autorisées.
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_TSNETWORKADAPTERSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSNetworkAdapterSetting : Win32_TerminalSetting
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
string TerminalName;
string DeviceIDList[];
uint32 MaximumConnections;
string NetworkAdapterID;
uint32 NetworkAdapterLanaID;
string NetworkAdapterList[];
string NetworkAdapterName;
uint32 PolicySourceMaximumConnections;
};
Membres
La classe Win32_TSNetworkAdapterSetting a les types de membres suivants :
Méthodes
La classe Win32_TSNetworkAdapterSetting a ces méthodes.
| Méthode | Description |
|---|---|
| SélectionnerAllNetworkAdapters | Sélectionne toutes les cartes réseau. |
| SélectionnezNetworkAdapterIP | Sélectionne une carte réseau en fonction de l’adresse IP de la carte. |
| SetNetworkAdapterLanaID | Spécifie le numéro de carte réseau locale (LANA) NetBIOS de la carte réseau à définir. |
Propriétés
La classe Win32_TSNetworkAdapterSetting possède 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.
-
-
DeviceIDList
-
-
Type de données : tableau de chaînes
-
Type d'accès : Lecture seule
Tableau de chaînes d’ID d’appareil disponibles retournés dans l’ordre des cartes réseau physiques retournées dans le tableau de propriétés NetworkAdapterList . La valeur de l’ID d’appareil est la propriété DeviceID dans Win32_NetworkAdapter
-
-
InstallDate
-
-
Type de données : datetime
-
Type d'accès : Lecture seule
-
Qualificateurs : mappingstrings (« MIF. DMTF| ComponentID|001.5 »)
Date d’installation de l’objet. 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.
-
-
MaximumConnections
-
-
Type de données : uint32
-
Type d’accès : Lecture/écriture
Nombre maximal de connexions autorisées. La valeur MAXINT indique un nombre illimité de connexions.
-
-
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.
-
-
NetworkAdapterID
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
GUID qui représente l’ID de la carte réseau à définir. Un GUID qui se compose de tous les zéros désigne toutes les cartes réseau.
-
-
NetworkAdapterLanaID
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
Numéro de carte réseau locale (LANA) NetBIOS de la carte réseau utilisée pour identifier la carte réseau affectée au terminal.
-
-
NetworkAdapterList
-
-
Type de données : tableau de chaînes
-
Type d'accès : Lecture seule
Tableau de chaînes de cartes réseau physiques disponibles et les ID d’appareil correspondants. Les ID d’appareil sont la propriété DeviceID dans Win32_NetworkAdapter.
-
-
NetworkAdapterName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Description de la carte réseau à définir. Cette valeur se trouve dans Win32_NetworkAdapterConfiguration.
-
-
PolicySourceMaximumConnections
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété MaximumConnections est configurée par le serveur, la stratégie de groupe ou par défaut.
-
-
0
-
Serveur
-
1
-
Stratégie de groupe
-
2
-
Default
É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étérioré »)
(« 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.
Notes
N’oubliez pas que les winstations associées à la session de console ne peuvent pas accéder aux méthodes et 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_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 les appels Visual Basic et de script, il s’agit d’un niveau d’authentification de WbemAuthenticationLevelPktPrivacy ou « pktPrivacy », avec une valeur de 6. L’exemple Visual Basic Scripting Edition (VBScript) suivant 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 |
|
| DLL |
|