Freigeben über

MSFT_NetTransportFilter Klasse

  • Artikel

Stellt den Filter für die Einstellung des Transportprotokollparameters für den Microsoft TCP/IP-WMI v2-Anbieter dar.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften.

Syntax

[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;
};

Member

Die MSFT_NetTransportFilter-Klasse weist folgende Membertypen auf:

Eigenschaften

Die MSFT_NetTransportFilter-Klasse weist diese Eigenschaften auf.

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Kennzeichner: MaxLen (64)

Enthält eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedElement geerbt.

CommunicationStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt die Fähigkeit der Instrumentierung an, mit diesem Element zu kommunizieren. Ein NULL-Wert gibt an, dass die Instrumentierung diese Eigenschaft nicht unterstützt.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Werte Bedeutung
Unbekannt
0
 Gibt an, dass die Instrumentierung momentan nicht über die Eigenschaft CommunicationStatus berichten kann.
Nicht verfügbar
1
 Gibt an, dass die Instrumentierung zwar in der Lage ist, über diese Eigenschaft zu berichten, es aber für dieses Element absichtlich unterlässt.
Kommunikation OK
2
 Gibt nur an, dass die Kommunikation mit dem Element eingerichtet ist.
Kommunikation verloren
3
 Zeigt an, dass das Element in der Vergangenheit kontaktiert wurde, derzeit jedoch nicht erreichbar ist.
Kein Kontakt
4
 Gibt an, dass die Instrumentierung zwar Kontaktinformationen für dieses Element hat, aber nie zur Kommunikation mit ihm der Lage war.
Für DMTF reserviert
5 32767
 Reserviert.
Für Anbieter reserviert
32768 = Wert
Reserviert.

CreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Kennzeichner: key, MaxLen (256)

Der Name der Klasse oder der Unterklasse, die beim Erstellen einer Instanz verwendet wird. In Verbindung mit den anderen Schlüsseleigenschaften dieser Klasse ermöglicht diese Eigenschaft die eindeutige Identifizierung aller Instanzen dieser Klasse und ihrer Unterklassen.

Diese Eigenschaft wird von CIM_FilterEntryBase geerbt.

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Bietet eine Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedElement geerbt.

DestinationPrefix

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Das zu filternde Zielpräfix.

DetailedStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Kennzeichner: ModelCorrespondence ("CIM_EnabledLogicalElement.PrimaryStatus", "CIM_ManagedSystemElement.HealthState")

Gibt zusätzliche Statusdetails in Ergänzung zur PrimaryStatus-Eigenschaft an. Ein NULL-Wert gibt an, dass die Instrumentierung diese Eigenschaft nicht unterstützt.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Werte Bedeutung
Nicht verfügbar
0
 Gibt an, dass die Instrumentierung zwar in der Lage ist, über diese Eigenschaft zu berichten, das Berichten aber für dieses Element absichtlich unterlässt.
Keine zusätzlichen Informationen
1
 Gibt an, dass keine Angaben zur Eigenschaft PrimaryStatus hinzugefügt werden müssen, wenn z. B. PrimaryStatus auf OK gesetzt wird.
Beansprucht
2
 Gibt an, dass das Element zwar funktioniert, aber Aufmerksamkeit erfordert. Beispiele für den Status Beansprucht sind Überlastung, Überhitzung.
Vorhersehbarer Fehler
3
 Ein Element funktioniert nominal, aber es wird ein Fehler in naher Zukunft vorhergesagt.
Nicht behebbarer Fehler
4
 Gibt an, dass sich dieses Element in einem Fehlerzustand befindet, der menschliches Eingreifen erfordert.
Fehler bei unterstützender Entität
5
 Gibt an, dass bei einem Element, von dem dieses Element abhängig ist, ein Fehler aufgetreten ist. Dieses Element ist zwar vielleicht OK, kann aber aufgrund des Status eines abhängigen Elements nicht funktionieren. Ein Beispiel ist ein Netzwerkdienst oder Endpunkt, der aufgrund von Problemen im zugrunde liegenden Netzwerk nicht funktioniert.
Für DMTF reserviert
6 32767
 Reserviert.
Für Anbieter reserviert
32768 = Wert
Reserviert.

ElementName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Enthält einen benutzerfreundlichen Namen für das Objekt. Diese Eigenschaft ermöglicht jeder Instanz, neben den wichtigsten Eigenschaften, den Identitätsdaten und beschreibenden Informationen einen benutzerfreundlichen Namen zu definieren.

Diese Eigenschaft wird von CIM_ManagedElement geerbt.

HealthState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt die aktuelle Integrität des Elements an. Dieses Attribut drückt die Integrität dieses Elements aus, aber nicht unbedingt die seiner Unterkomponenten.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Werte Bedeutung
Unbekannt
0
 Die Implementierung kann momentan nicht über HealthState berichten.
OK
5
 Das Element ist voll funktionsfähig und arbeitet innerhalb normaler Betriebsparameter und ohne Fehler.
Leistungsminderung/Warnung
10
 Das Element ist funktionsfähig und verfügt über alle Funktionalitäten. Das Element funktioniert jedoch nicht nach seinen besten Möglichkeiten. Das Element funktioniert zum Beispiel nicht mit optimaler Leistung oder meldet behebbare Fehler.
Geringfügiger Fehler
15
 Es sind alle Funktionalitäten verfügbar, manche sind aber eventuell in ihrer Leistung gemindert.
Wesentlicher Fehler
20
 Das Element weist einen Fehler auf. Es kann sein, dass einige oder alle Funktionalitäten dieser Komponente in ihrer Leistung gemindert sind oder nicht funktionieren.
Kritischer Fehler
25
 Das Element ist nicht funktionsfähig und die Wiederherstellung eventuell nicht möglich.
Nicht behebbarer Fehler
30
 Das Element hat vollständig versagt und es ist keine Wiederherstellung möglich. Alle Funktionalitäten dieses Elements sind verloren gegangen.
Für DMTF reserviert
31 = Wert
DMTF hat den ungenutzten Teil des Continuums für künftige zusätzliche HealthStates-Werte reserviert.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Gibt an, wann das Objekt installiert wurde. Das Fehlen eines Werts gibt nicht an, dass das Objekt nicht installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InstanceID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Identifiziert eindeutig und nicht transparent eine Instanz dieser Klasse im Bereich des enthaltenden Namespace.

[!Wichtig]Um die Eindeutigkeit innerhalb des Namespace zu gewährleisten, sollte der Wert von InstanceID gemäß folgendem Muster erstellt werden:

OrgID:LocalID

OrgID muss einen urheberrechtlich geschützten, Marken- oder anderweitig eindeutigen Namen enthalten, der der Geschäftsentität gehört, die die InstanceID definiert, oder eine registrierte ID sein, die von einer anerkannten globalen Autorität zugewiesen wird. Dies ähnelt der Struktur der Schemaklassennamen. Um die Eindeutigkeit des ersten Doppelpunkts in InstanceID sicherzustellen, muss er sich außerdem zwischen der OrgID und localID befinden. Daher darf die OrgID keinen Doppelpunkt („:“) enthalten.

LocalID wird von der Geschäftsentität ausgewählt und sollte nicht wiederverwendet werden, um unterschiedliche zugrunde liegende reale Elemente zu identifizieren.

Wenn das vorherige Muster nicht verwendet wird, muss die definierende Entität sicherstellen, dass die resultierende InstanceID nicht in allen InstanceIDs wiederverwendet wird, die von diesem oder anderen Anbietern dieses Namespace erstellt werden.

Für definierte Instanzen der Distributed Management Task Force (DMTF) muss das Muster verwendet werden, wobei die OrgID auf CIM gesetzt wird.

Diese Eigenschaft wird von CIM_ManagedElement geerbt.

IsNegated

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Ein Boolescher Wert, der angibt, dass die in den Eigenschaften der Unterklasse FilterEntryBase beschriebene Übereinstimmungsbedingung negiert werden soll. Diese Eigenschaft wurde definiert, um das Filtern nach einfachen Negationen zu erleichtern – zum Beispiel, um alle Quellports außer 162 auszuwählen. Es wird nicht empfohlen, diesen Booleschen Wert auf Wahr zu setzen, wenn Sie nach mehreren Kriterien filtern, z. B. wenn Sie einen IPHeadersFilter auf der Grundlage von Quell-/Zieladressen, Ports und DiffServ-Codepunkten definieren.

Diese Eigenschaft wird von CIM_FilterEntryBase geerbt.

LocalPortEnd

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Das Ende der lokalen Port-Nummer.

LocalPortStart

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der Start der lokalen Portnummer.

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Kennzeichner: MaxLen (256), key

Definiert die Bezeichnung, unter der der Filtereintrag bekannt und eindeutig identifiziert ist.

Diese Eigenschaft wird von CIM_FilterEntryBase geerbt.

OperatingStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Kennzeichner: ModelCorrespondence („CIM_EnabledLogicalElement.EnabledState“)

Gibt den aktuellen Betriebszustand des Elements an. Diese Eigenschaft kann verwendet werden, um mehr Details über den aktuellen Zustand des Elements bereitzustellen. Sie kann auch Übergangszustände angeben. Ein NULL-Wert gibt an, dass die Instrumentierung diese Eigenschaft nicht unterstützt.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Wert Bedeutung
Unbekannt
0
 Gibt an, dass die Instrumentierung momentan nicht über die Eigenschaft OperatingStatus berichten kann.
Nicht verfügbar
1
 Gibt an, dass die Instrumentierung zwar in der Lage ist, über diese Eigenschaft zu berichten, das Berichten aber für dieses Element absichtlich unterlässt.
Wartung
2
 Gibt an, dass das Element gerade konfiguriert, gewartet, bereinigt oder anderweitig verwaltet wird.
Wird gestartet
3
 Gibt an, dass das Element initialisiert wird.
Wird beendet
4
 Gibt an, dass das Element geordnet angehalten wird.
Beendet
5
 Gibt an, dass das Element absichtlich angehalten wird.
Aborted
6
 Gibt an, dass das Element auf unerwartete Weise beendet wurde.
Inaktiv
7
 Das Element ist inaktiv oder stillgelegt.
Abgeschlossen
8
 Das Element hat seinen Vorgang abgeschlossen. Zur Angabe, ob der Vorgang erfolgreich war oder fehlgeschlagen ist, empfehlen wir als Eigenschaftswert von PrimaryStatusOK, Fehler oder Beeinträchtigt.
Migrieren
9
 Das Element wird zwischen Hostelementen verschoben.
Wird emigriert
10
 Das Element wird vom Hostelement entfernt.
Wird immigriert
11
 Das Element wird in ein neues Hostelement verschoben.
Snapshotting
12
 Gibt an, dass eine Momentaufnahmenkopie des Elements erstellt wird.
Herunterfahren
13
 Gibt an, dass das Element abrupt angehalten wird.
Wird getestet
14
 Das Element führt Testfunktionen aus.
Im Übergang
15
 Gibt an, dass sich das Element zwischen den Zuständen befindet und in beiden Zuständen nicht vollständig verfügbar ist. Verwenden Sie einen anderen Wert, der einen spezifischeren Übergang angibt, sofern verfügbar.
In Betrieb
16
 Gibt an, dass das Element einsatzbereit und im Betrieb ist.
Für DMTF reserviert
17 32767
 Reserviert.
Für Anbieter reserviert
32768 = Wert
Reserviert.

OperationalStatus

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Kennzeichner: ArrayType („Indexed“), ModelCorrespondence („CIM_ManagedSystemElement.StatusDescriptions“)

Enthält Indikatoren für den aktuellen Status des Elements. Der erste Wert OperationalStatus sollte den primären Status für das Element enthalten.

Hinweis

OperationalStatus ersetzt die veraltete Eigenschaft Status. Aufgrund der weit verbreiteten Verwendung der vorhandenen Status-Eigenschaft in Verwaltungsanwendungen wird von Microsoft dringend empfohlen, dass Anbieter oder Instrumentierungen sowohl die Status-Eigenschaft als auch die OperationalStatus-Eigenschaft bereitstellen. Wenn Status instrumentiert wird, sollte auch der primäre Status des Elements angegeben werden (da es sich um eine Eigenschaft mit genau einem Wert handelt).

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Werte Bedeutung
Unbekannt
0
 Gibt an, dass die Implementierung momentan nicht über OperationalStatus berichten kann.
Andere
1
 Gibt einen nicht definierten Zustand an.
OK
2
 Gibt die volle Funktionalität ohne Fehler an.
Beeinträchtigt
3
 Zeigt an, dass das Element funktioniert und alle Funktionen verfügbar sind. Das Element funktioniert jedoch nicht nach seinen besten Möglichkeiten. Das Element funktioniert zum Beispiel nicht mit optimaler Leistung oder meldet behebbare Fehler.
Beansprucht
4
 Zeigt an, dass das Element funktioniert, jedoch Ihre Aufmerksamkeit benötigt. Beispiele für den Status Beansprucht sind Überlastung, Überhitzung.
Vorhersehbarer Fehler
5
 Ein Element funktioniert nominal, aber es wird ein Fehler in naher Zukunft vorhergesagt.
Fehler
6
 Zeigt an, dass ein Fehler vorliegt.
Nicht behebbarer Fehler
7
 Ein nicht behebbarer Fehler ist aufgetreten.
Wird gestartet
8
 Der Job wird gestartet.
Wird beendet
9
 Der Job wird beendet.
Beendet
10
 Das Element wurde absichtlich beendet.
In Betrieb
11
 Zeigt an, dass das Element konfiguriert, gewartet, bereinigt oder anderweitig verwaltet wird.
Kein Kontakt
12
 Zeigt an, dass das Überwachungssystem dieses Element kennt, konnte aber nie eine Kommunikation damit einrichten.
Kommunikation verloren
13
 Zeigt an, dass der Job bekannt ist und in der Vergangenheit erfolgreich kontaktiert wurde, wenngleich er derzeit jedoch nicht erreichbar ist.
Aborted
14
 Gibt an, dass der Job unerwartet beendet wurde. Status und Konfiguration des Jobs müssen gegebenenfalls aktualisiert werden.
Inaktiv
15
 Gibt an, dass der Job inaktiv ist.
Fehler bei unterstützender Entität
16
 Gibt an, dass bei einem Element, von dem dieser Job abhängig ist, ein Fehler aufgetreten ist. Dieses Element ist zwar vielleicht OK, kann aber aufgrund des Status eines abhängigen Elements nicht funktionieren. Ein Beispiel ist ein Netzwerkdienst oder Endpunkt, der aufgrund von Problemen im zugrunde liegenden Netzwerk nicht funktioniert.
Abgeschlossen
17
 Gibt an, dass der Job seinen Vorgang abgeschlossen hat. Dieser Wert sollte entweder mit OK, Fehler oder Beeinträchtigt kombiniert werden, damit ein Client erkennen kann, ob der Vorgang mit OK (erfolgreich), mit Fehler (fehlgeschlagen) oder mit Beeinträchtigt (der Vorgang wurde beendet, aber nicht erfolgreich abgeschlossen, oder es wurde einen Fehler gemeldet) abgeschlossen wurde.
Energiestatus
18
 Der „Energiestatus“ zeigt an, dass das Element über zusätzliche Energiemodellinformationen verfügt, die in der zugehörigen PowerManagementService-Assoziation enthalten sind.
Für DMTF reserviert
19 32767
 DMTF hat diesen Teil des Bereichs für künftige zusätzliche OperationalStatus-Werte reserviert.
Für Anbieter reserviert
32768 65535
 Microsoft hat diesen ungenutzten Teil des Bereichs für künftige zusätzliche OperationalStatus-Werte reserviert.

PrimaryStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Kennzeichner: ModelCorrespondence ("CIM_ManagedSystemElement.DetailedStatus", "CIM_ManagedSystemElement.HealthState")

Gibt einen Statuswert auf hoher Ebene an.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Die möglichen Werte lauten wie folgt.

Unbekannt (0)

OK (1)

Verringert (2)

Fehler (3)

Für DMTF reserviert (4 32767)

Für Anbieter reserviert (32768 = Wert)

Protokoll

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt das Protokoll an, auf das der Filter angewendet wird.

TCP (6)

UDP (17)

RemotePortEnd

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Das Ende der Remote-Port-Nummer.

RemotePortStart

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der Beginn der Remote-Port-Nummer.

SettingName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Name der Einstellung, die mit dem Filter verknüpft ist. Informationen zu dieser Einstellung finden Sie unter MSFT_NetTCPSetting.

Status

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Kennzeichner: Veraltet („CIM_ManagedSystemElement.OperationalStatus“), MaxLen (10)

Enthält eine Zeichenfolge, die den primären Status des Objekts angibt.

Hinweis

Diese Eigenschaft ist veraltet und wird durch die Eigenschaft OperationalStatus ersetzt. Wenn Sie für Abwärtskompatibilität die Status-Eigenschaft verwenden möchten, sollte sie der OperationalStatus-Eigenschaft untergeordnet werden.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Die möglichen Werte lauten wie folgt.

(„OK“)

(„Fehler“)

(„Herabgestuft“)

(„Unbekannt“)

(„Künftiger Fehler“)

(„Wird gestartet“)

(„Wird angehalten“)

(„In Betrieb“)

(„Beansprucht“)

(„Nicht wiederherstellbar“)

(„Kein Kontakt“)

(„Verbindung unterbrochen“)

(„Angehalten“)

StatusDescriptions

Datentyp: string-Array

Zugriffstyp: Schreibgeschützt

Kennzeichner: ArrayType („Indexed“), ModelCorrespondence („CIM_ManagedSystemElement.OperationalStatus“)

Gibt Beschreibungen der entsprechenden Werte im OperationalStatus-Array an. Wenn beispielsweise ein Element in der OperationalStatus-Eigenschaft den Wert Wird angehalten enthält, kann das Element am gleichen Arrayindex in dieser Eigenschaft eine Erläuterung enthalten, warum ein Objekt beendet wird.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

SystemCreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Kennzeichner: key, Max. Länge (256), Verteilt („CIM_ComputerSystem.CreationClassName“)

Der CreationClassName des Bereichs-Computersystems.

Diese Eigenschaft wird von CIM_FilterEntryBase geerbt.

SystemName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Kennzeichner: key, Max. Länge (256), Verteilt („CIM_ComputerSystem.Name“)

Der Name des Bereichs-Computersystems.

Diese Eigenschaft wird von CIM_FilterEntryBase geerbt.

Anforderungen
Unterstützte Mindestversion (Client)
 Windows 8
Unterstützte Mindestversion (Server)
 Windows Server 2012
Namespace
 Root\StandardCimv2
MOF
NetTCPIP.mof
DLL
NetTCPIP.dll

Weitere Informationen

CIM_FilterEntryBase

MSFT_NetTCPSetting