Classe MSFT_NetTransportFilter

Représente le filtre pour le paramètre du protocole de transport pour le fournisseur Microsoft TCP/IP WMI v2.

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées.

Syntaxe

[UMLPackagePath("CIM::Network::Filtering"), ClassVersion("1.0.0"), dynamic, provider("nettcpip"), AMENDMENT]
class MSFT_NetTransportFilter : CIM_FilterEntryBase
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   Name;
  string   SystemCreationClassName;
  string   SystemName;
  string   CreationClassName;
  boolean  IsNegated;
  uint16   Protocol;
  uint16   LocalPortStart;
  uint16   LocalPortEnd;
  uint16   RemotePortStart;
  uint16   RemotePortEnd;
  string   DestinationPrefix;
  string   SettingName;
};

Membres

La classe MSFT_NetTransportFilter possède ces types de membres :

• Propriétés

Propriétés

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

Caption

Type de données : chaîne

Type d’accès : Lecture seule

Qualificateurs : MaxLen (64)

Contient une brève description textuelle de l’objet.

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

CommunicationStatus

Type de données : uint16

Type d’accès : Lecture seule

Indique la capacité de l’instrumentation à communiquer avec cet élément. Une valeur NULL indique que l’instrumentation ne prend pas en charge cette propriété.

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

Valeurs	Signification
Unknown 0	Indique que l’instrumentation ne peut pas signaler la propriété CommunicationStatus pour l’instant.
Non disponible 1	Indique que l’instrumentation est capable de signaler cette propriété, mais qu’elle ne le fait pas intentionnellement pour cet élément.
Communication OK 2	Indique uniquement que la communication est établie avec l’élément.
Perte de communication 3	Indique que l’élément a été contacté dans le passé, mais qu’il est actuellement injoignable.
Aucun contact 4	Indique que l’instrumentation possède des coordonnées pour cet élément, mais n’a jamais pu communiquer avec ces derniers.
DMTF réservé 5 32767	Réservé.
Vendeur réservé 32768 = valeur	Réservé.

CreationClassName

Type de données : chaîne

Type d’accès : Lecture seule

Qualificateurs : clé, MaxLen (256)

Le nom de la classe ou de la sous-classe utilisée dans la création d’une instance. Utilisée avec les autres propriétés clés de cette classe, cette propriété permet d’identifier de manière unique toutes les instances de cette classe et de ses sous-classes.

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

Description

Type de données : chaîne

Type d’accès : Lecture seule

Fournit une description textuelle de l’objet.

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

DestinationPrefix

Type de données : chaîne

Type d’accès : Lecture seule

Le préfixe de destination à filtrer.

DetailedStatus

Type de données : uint16

Type d’accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_EnabledLogicalElement.PrimaryStatus », « CIM_ManagedSystemElement.HealthState »)

Indique des détails d’état supplémentaires qui complètent la propriété PrimaryStatus. Une valeur NULL indique que l’instrumentation ne prend pas en charge cette propriété.

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

Valeurs	Signification
Non disponible 0	Indique que l’instrumentation est capable de signaler cette propriété, mais qu’elle ne la signale pas intentionnellement pour cet élément.
Aucune information supplémentaire 1	Indique qu’aucun détail ne doit être ajouté à la propriété PrimaryStatus, par exemple lorsque PrimaryStatus est défini sur OK.
Sous pression 2	Indique que l’élément fonctionne, mais nécessite une attention particulière. La surcharge et la surchauffe sont des exemples d’états Sous pression.
Prévention d’erreur 3	Indique si un élément fonctionne nominalement, mais prédit une défaillance dans un avenir proche.
Erreur non récupérable 4	Indique que cet élément est dans une condition d’erreur qui nécessite une intervention humaine.
Entité de prise en charge liée à l’erreur 5	Indique qu’un élément sur lequel dépend cet élément est en erreur. Cet élément peut être OK, mais ne peut pas fonctionner en raison de l’état d’un élément dépendant. Par exemple, un service réseau ou un point de terminaison qui ne peut pas fonctionner en raison de problèmes de mise en réseau de couche inférieure.
DMTF réservé 6 32767	Réservé.
Vendeur réservé 32768 = valeur	Réservé.

ElementName

Type de données : chaîne

Type d’accès : Lecture seule

Contient un nom convivial pour l’objet. Cette propriété permet à chaque instance de définir un nom convivial en plus de ses propriétés clés, ses données d’identité et ses informations de description.

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

HealthState

Type de données : uint16

Type d’accès : Lecture seule

Indique l’intégrité actuelle de l’élément. Cet attribut exprime l’intégrité de cet élément, mais pas nécessairement celle de ses sous-composants.

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

Valeurs	Signification
Unknown 0	L’implémentation ne peut rien signaler sur HealthState pour l’instant.
OK 5	L’élément est entièrement fonctionnel et fonctionne dans des paramètres opérationnels normaux et sans erreur.
Détérioré/Avertissement 10	L’élément est dans l’ordre de travail et toutes les fonctionnalités sont fournies. Toutefois, l’élément ne fonctionne pas au meilleur de ses capacités. Par exemple, l’élément peut ne pas fonctionner de manière optimale ou signaler des erreurs récupérables
Échec mineur 15	Toutes les fonctionnalités sont disponibles, mais certaines peuvent être dégradées.
Échec majeur 20	L’élément échoue. Il est possible que certaines ou toutes les fonctionnalités de ce composant soient dégradées ou ne fonctionnent pas.
Échecs critiques 25	L’élément n’est pas fonctionnel et la récupération peut ne pas être possible.
Erreur non récupérable 30	L’élément a échoué complètement et la récupération n’est pas possible. Toutes les fonctionnalités fournies par cet élément ont été perdues.
DMTF réservé 31 = valeur	DMTF a réservé la partie inutilisée du continuum pour des valeurs HealthStates supplémentaires à l’avenir.

InstallDate

Type de données : DateHeure

Type d’accès : Lecture seule

Indique quand 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.

InstanceID

Type de données : chaîne

Type d’accès : Lecture seule

Identifie de manière opaque et unique une instance de cette classe dans le cadre de l’espace de noms contenant.

[!Important]Pour garantir l’unicité dans l’espace de noms, la valeur d’InstanceID doit être construite selon le modèle suivant :

OrgID:LocalID

OrgID doit inclure un nom protégé par droit d’auteur, une marque ou un nom unique appartenant à l’entité commerciale définissant InstanceID, ou être un ID inscrit attribué par une autorité globale reconnue. Il s’agit d’une structure similaire à la structure des noms de classe Schema. De plus, pour garantir l’unicité, le premier signe deux-points dans InstanceID doit être compris entre OrgID et LocalID. Pour cela, OrgID ne doit pas contenir de signe deux-points (’:’).

LocalID est choisi par l’entité commerciale et ne doit pas être réutilisé pour identifier différents éléments sous-jacents du monde réel.

Si le modèle ci-dessus n’est pas utilisé, l’entité de définition doit garantir que l’InstanceID résultant n’est pas réutilisé dans les InstanceID produits par ce fournisseur ou par d’autres pour cet espace de noms.

Pour les instances définies par la DMTF (Distributed Management Task Force), le modèle doit être utilisé avec OrgID défini sur CIM.

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

IsNegated

Type de données : Booléen

Type d’accès : Lecture seule

Boolean indiquant que la condition de correspondance décrite dans les propriétés de la sous-classe FilterEntryBase doit être supprimée. Cette propriété est définie pour faciliter l’utilisation lors du filtrage sur des négations simples, par exemple, pour sélectionner tous les ports sources à l’exception de 162. Il n’est pas recommandé de définir cette valeur booléenne sur Vrai lors du filtrage sur plusieurs critères, comme la définition d’un filtre IPHeadersFilter basé sur les adresses source/destination, les ports et les codes de caractère DiffServ.

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

LocalPortEnd

Type de données : uint16

Type d’accès : Lecture seule

La fin du numéro de port local.

LocalPortStart

Type de données : uint16

Type d’accès : Lecture seule

Le début du numéro de port local.

Nom

Type de données : chaîne

Type d’accès : Lecture seule

Qualificateurs : MaxLen (256), clé

Définit l’étiquette par laquelle l’entrée de filtre est connue et identifiée de manière unique.

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

OperatingStatus

Type de données : uint16

Type d’accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_EnabledLogicalElement.EnabledState »)

Indique la condition opérationnelle actuelle de l’élément. Cette propriété peut être utilisée pour fournir plus de détails sur l’état actuel de l’élément. Elle peut également indiquer des états transitoires. Une valeur NULL indique que l’instrumentation ne prend pas en charge cette propriété.

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

Valeur	Signification
Unknown 0	Indique que l’instrumentation ne peut pas signaler la propriété OperatingStatus pour l’instant.
Non disponible 1	Indique que l’instrumentation est capable de signaler cette propriété, mais qu’elle ne la signale pas intentionnellement pour cet élément.
Maintenance 2	Indique que l’élément est en cours de configuration, de maintenance, de nettoyage ou de gestion.
Démarrage en cours 3	Indique que l’élément est en cours d’initialisation.
En cours d’arrêt 4	Indique que l’élément est en cours d’arrêt de manière ordonnée.
Arrêté 5	Indique que l’élément est volontairement arrêté.
Abandonné 6	Indique que l’élément s’est arrêté de manière inattendue.
Dormant 7	Indique que l’élément est inactif ou suspendu.
Terminé 8	Indique que l’élément a terminé son opération. Il est recommandé d’utiliser une valeur de propriété PrimaryStatus de type OK, Erreur ou Dégradé pour indiquer le succès ou l’échec de l’opération.
Migration 9	Indique que l’élément est déplacé entre les éléments hôtes.
Émigration 10	Indique que l’élément est déplacé de l’élément hôte.
Immigration 11	Indique que l’élément est déplacé vers un nouvel élément hôte.
Instantané 12	Indique qu’une copie instantanée de l’élément est en cours de création.
Arrêt en cours 13	Indique que l’élément s’arrête brusquement.
En test 14	Indique que l’élément exécute des fonctions de test.
Transition en cours 15	Indique que l’élément se trouve entre deux états et qu’il n’est pas entièrement disponible dans l’un ou l’autre état. Utilisez une autre valeur qui indique une transition plus spécifique si elle est disponible.
En service 16	Indique que l’élément est en service et opérationnel.
DMTF réservé 17 32767	Réservé.
Vendeur réservé 32768 = valeur	Réservé.

OperationalStatus

Type de données : tableau uint16

Type d’accès : Lecture seule

Qualificateurs : ArrayType (« Indexed »), ModelCorrespondence (« CIM_ManagedSystemElement.StatusDescriptions »)

Contient des indicateurs de l’état actuel de l’élément. La première valeur de OperationalStatus doit contenir l’état principal de l’élément.

Remarque

OperationalStatus remplace la propriété Status déconseillée. En raison de l’utilisation généralisée de la propriété Status existante dans les applications de gestion, Microsoft recommande vivement aux fournisseurs ou à l’instrumentation de fournir à la fois les propriétés Status et OperationalStatus. Lorsqu’il est instrumenté, Status (car il s’agit d’une propriété à valeur unique) doit également fournir l’état principal de l’élément.

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

Valeurs	Signification
Unknown 0	Indique que l’implémentation ne peut rien signaler sur OperationalStatus pour l’instant.
Autres 1	Indique un état non défini.
OK 2	Indique les fonctionnalités complètes sans erreurs.
Détérioré 3	Indique que l’élément fonctionne et que toutes les fonctionnalités sont fournies. Toutefois, l’élément ne fonctionne pas au meilleur de ses capacités. Par exemple, l’élément peut ne pas fonctionner de manière optimale ou signaler des erreurs récupérables
Sous pression 4	Indique que l’élément fonctionne, mais a besoin d’attention. La surcharge et la surchauffe sont des exemples d’états Sous pression.
Prévention d’erreur 5	Indique qu’un élément fonctionne nominalement, mais prédit une défaillance dans un avenir proche.
Error 6	Indique qu’une erreur s’est produite.
Erreur non récupérable 7	Une erreur non récupérable s’est produite.
Démarrage en cours 8	Le projet commence.
En cours d’arrêt 9	Le projet s’arrête.
Arrêté 10	L’élément a été volontairement arrêté.
En service 11	Indique que l’élément est configuré, géré, nettoyé ou administré.
Aucun contact 12	Indique que le système de surveillance a connaissance de cet élément, mais n’a jamais été en mesure d’établir des communications avec celui-ci.
Perte de communication 13	Indique que le projet est connu pour exister et a été contacté avec succès dans le passé, mais est actuellement inaccessible.
Abandonné 14	Indique que le projet s’est arrêté de manière inattendue. L’état et la configuration du projet doivent peut-être être mis à jour.
Dormant 15	Indique que le projet est inactif.
Entité de prise en charge liée à l’erreur 16	Indique qu’un élément sur lequel dépend ce projet est en erreur. Cet élément peut être OK, mais ne peut pas fonctionner en raison de l’état d’un élément dépendant. Par exemple, un service réseau ou un point de terminaison qui ne peut pas fonctionner en raison de problèmes de mise en réseau de couche inférieure.
Terminé 17	Indique que le projet a terminé son opération. Cette valeur doit être combinée à OK, Erreur ou Détérioré afin qu’un client puisse indiquer si l’opération terminée s’est Terminée avec OK (réussie), Terminée avec erreur (échouée) ou Terminée avec détérioré (l’opération s’est terminée, mais elle n’a pas terminé OK ou n’a pas fait état d’une erreur).
Power Mode 18	Le « mode de puissance » indique que l’élément contient des informations supplémentaires sur le modèle d’alimentation contenues dans l’association PowerManagementService associée.
DMTF réservé 19 32767	DMTF a réservé cette partie de la plage pour des valeurs OperationalStatus supplémentaires à l’avenir.
Vendeur réservé 32768 65535	Microsoft a réservé la partie inutilisée de la plage pour d’autres valeurs OperationalStatus à l’avenir.

PrimaryStatus

Type de données : uint16

Type d’accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_ManagedSystemElement.DetailedStatus », « CIM_ManagedSystemElement.HealthState »)

Indique une valeur d’état de haut niveau.

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

Les valeurs possibles sont les suivantes.

Inconnu (0)

OK (1)

Dégradé (2)

Erreur (3)

DMTF réservé (4 32767)

Réservé au fournisseur (32768 = valeur)

Protocole

Type de données : uint16

Type d’accès : Lecture seule

Spécifie le protocole auquel le filtre s’applique.

TCP (6)

UDP (17)

RemotePortEnd

Type de données : uint16

Type d’accès : Lecture seule

La fin du numéro de port distant.

RemotePortStart

Type de données : uint16

Type d’accès : Lecture seule

Le début du numéro de port distant.

SettingName

Type de données : chaîne

Type d’accès : Lecture seule

Le nom du paramètre associé au filtre. Pour plus d’informations sur ce paramètre, consultez MSFT_NetTCPSetting.

État

Type de données : chaîne

Type d’accès : Lecture seule

Qualificateurs : Déceonseillé (« CIM_ManagedSystemElement.OperationalStatus »), MaxLen (10)

Contient une chaîne indiquant l’état primaire de l’objet.

Remarque

Cette propriété est déconseillée et remplacée par la propriété OperationalStatus. Si vous choisissez d’utiliser la propriété Status pour la compatibilité descendante, elle doit être secondaire à la propriété OperationalStatus.

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

Les valeurs possibles sont les suivantes.

(« OK »)

(« Erreur »)

(« Détérioré »)

(« Inconnu »)

(« Défaillance prédictive »)

(« Démarrage »)

(« Arrêt »)

(« Service »)

(« Sous pression »)

(« Non récupérable »)

(« Aucun contact »)

(« Perte de communication »)

(« Arrêté »)

StatusDescriptions

Type de données : tableau de chaînes

Type d’accès : Lecture seule

Qualificateurs : ArrayType (« Indexed »), ModelCorrespondence (« CIM_ManagedSystemElement.OperationalStatus »)

Indique les descriptions des valeurs correspondantes dans le tableau OperationalStatus. Par exemple, si un élément de la propriété OperationalStatus contient la valeur Arrêt, l’élément au même index de tableau de cette propriété peut contenir une explication quant à la raison pour laquelle un objet est arrêté.

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

SystemCreationClassName

Type de données : chaîne

Type d’accès : Lecture seule

Qualificateurs : clé, MaxLen (256), Propagé (« CIM_ComputerSystem.CreationClassName »)

CreationClassName du système informatique de délimitation de l’étendue.

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

SystemName

Type de données : chaîne

Type d’accès : Lecture seule

Qualificateurs : clé, MaxLen (256), Propagé (« CIM_ComputerSystem.Name »)

Nom du ComputerSystem d’étendue.

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

Spécifications

Voir aussi

CIM_FilterEntryBase

MSFT_NetTCPSetting