Freigeben über


MSFT_NetTransportFilter Klasse

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

Die folgende Syntax wird aus dem MOF-Code (Managed Object Format) 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;
};

Angehörige

Die MSFT_NetTransportFilter Klasse verfügt über die folgenden Membertypen:

Eigenschaften

Die MSFT_NetTransportFilter Klasse weist diese Eigenschaften auf.

Beschriftungs-

Datentyp: Zeichenfolgen-

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen- (64)

Enthält eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedElementgeerbt.

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 Instrumentation diese Eigenschaft nicht unterstützt.

Diese Eigenschaft wird von CIM_ManagedSystemElementgeerbt.

Werte Bedeutung
Unbekannter
0
Gibt an, dass die Instrumentierung derzeit nicht über die CommunicationStatus-eigenschaft berichten kann.
nicht verfügbar
1
Gibt an, dass die Instrumentierung in der Lage ist, diese Eigenschaft zu melden, aber absichtlich nicht für dieses Element.
Kommunikation OK
2
Gibt nur an, dass die Kommunikation mit dem Element hergestellt wird.
Verlorene Kommunikation
3
Gibt an, dass das Element in der Vergangenheit kontaktiert wurde, derzeit aber nicht erreichbar ist.
Kein Kontakt
4
Gibt an, dass die Instrumentierung Kontaktinformationen für dieses Element enthält, aber nie mit ihr kommunizieren konnte.
reservierte DMTF-
5 32767
Reserviert.
reservierte
32768 = Wert
Reserviert.

CreationClassName-

Datentyp: Zeichenfolgen-

Zugriffstyp: Schreibgeschützt

Qualifizierer: Key, MaxLen (256)

Der Name der Klasse oder der Unterklasse, die beim Erstellen einer Instanz verwendet wird. Wenn diese Eigenschaft mit den anderen Schlüsseleigenschaften dieser Klasse verwendet wird, können alle Instanzen dieser Klasse und deren Unterklassen eindeutig identifiziert werden.

Diese Eigenschaft wird von CIM_FilterEntryBasegeerbt.

Beschreibung

Datentyp: Zeichenfolgen-

Zugriffstyp: Schreibgeschützt

Stellt eine Textbeschreibung des Objekts bereit.

Diese Eigenschaft wird von CIM_ManagedElementgeerbt.

DestinationPrefix-

Datentyp: Zeichenfolgen-

Zugriffstyp: Schreibgeschützt

Das zu filternde Zielpräfix.

DetailedStatus-

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

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

Gibt zusätzliche Statusdetails an, die die PrimaryStatus-eigenschaft ergänzen. Ein NULL--Wert gibt an, dass die Instrumentation diese Eigenschaft nicht unterstützt.

Diese Eigenschaft wird von CIM_ManagedSystemElementgeerbt.

Werte Bedeutung
nicht verfügbar
0
Gibt an, dass die Instrumentierung in der Lage ist, diese Eigenschaft zu melden, sie aber absichtlich nicht für dieses Element zu melden.
keine zusätzlichen Informationen
1
Gibt an, dass der PrimaryStatus- eigenschaft keine Details hinzugefügt werden müssen, z. B. wenn die PrimaryStatus- auf OKfestgelegt ist.
betonten
2
Gibt an, dass die Elementfunktionen, aber Aufmerksamkeit erfordern. Überlastung und Überhitzung sind Beispiele für Betonten Zuständen.
Predictive Failure
3
Gibt an, dass ein Element nominal funktioniert, aber in naher Zukunft einen Fehler vorhersagt.
nicht wiederherstellbaren Fehler
4
Gibt an, dass sich dieses Element in einer Fehlerbedingung befindet, die menschliche Intervention erfordert.
unterstützende Entität im Fehler-
5
Gibt an, dass ein Element, von dem dieses Element abhängt, fehlerhaft ist. Dieses Element ist möglicherweise OK, kann aber aufgrund des Zustands eines abhängigen Elements nicht funktionieren. Ein Beispiel ist ein Netzwerkdienst oder Endpunkt, der aufgrund von Netzwerkproblemen mit niedrigerer Ebene nicht funktionieren kann.
reservierte DMTF-
6 32767
Reserviert.
reservierte
32768 = Wert
Reserviert.

ElementName-

Datentyp: Zeichenfolgen-

Zugriffstyp: Schreibgeschützt

Enthält einen benutzerfreundlichen Namen für das Objekt. Mit dieser Eigenschaft kann jede Instanz zusätzlich zu den wichtigsten Eigenschaften, Identitätsdaten und Beschreibungsinformationen einen benutzerfreundlichen Namen definieren.

Diese Eigenschaft wird von CIM_ManagedElementgeerbt.

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

Werte Bedeutung
Unbekannter
0
Die Implementierung kann derzeit nicht über HealthState- berichten.
OK
5
Das Element ist voll funktionsfähig und wird in normalen Betriebsparametern und ohne Fehler ausgeführt.
herabgestuften/Warnungs-
10
Das Element befindet sich in der Arbeitsreihenfolge, und alle Funktionen werden bereitgestellt. Das Element funktioniert jedoch nicht am besten seiner Fähigkeiten. Beispielsweise funktioniert das Element möglicherweise nicht bei optimaler Leistung oder meldet wiederherstellbare Fehler.
Kleinere Fehler
15
Alle Funktionen sind verfügbar, aber einige werden möglicherweise beeinträchtigt.
Hauptfehler
20
Das Element ist fehlgeschlagen. Es ist möglich, dass einige oder alle Funktionen dieser Komponente beeinträchtigt oder nicht funktionieren.
kritischen Fehler
25
Das Element ist nicht funktionsfähig und die Wiederherstellung ist möglicherweise nicht möglich.
nicht wiederherstellbare Fehler
30
Das Element ist vollständig fehlgeschlagen, und die Wiederherstellung ist nicht möglich. Alle funktionen, die von diesem Element bereitgestellt werden, sind verloren gegangen.
reservierte DMTF-
31 = Wert
DMTF hat den nicht verwendeten Teil des Kontinuums für zusätzliche HealthStates-Werte in Zukunft 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_ManagedSystemElementgeerbt.

InstanceID-

Datentyp: Zeichenfolgen-

Zugriffstyp: Schreibgeschützt

Identifiziert eindeutig und undurchsichtig eine Instanz dieser Klasse im Bereich des enthaltenden Namespaces.

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

OrgID-:LocalID-

OrgID- muss einen urheberrechtlich geschützten, geschützten 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 Behörde zugewiesen wird. Dies ähnelt der Struktur der Schemaklassennamen. Um die Eindeutigkeit des ersten Doppelpunkts in InstanceID sicherzustellen, muss zwischen der OrgID- undLocalID-sein. Daher darf die OrgID- keinen Doppelpunkt (':') enthalten.

LocalID- wird von der Geschäftsentität ausgewählt und sollte nicht erneut verwendet 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 InstanceID-, die von diesem oder anderen Anbietern für diesen Namespace erstellt werden, wieder verwendet wird.

Für definierte Instanzen der distributed Management Task Force (DMTF) muss das Muster verwendet werden, wobei die OrgID- auf CIM festgelegt ist.

Diese Eigenschaft wird von CIM_ManagedElementgeerbt.

IsNegated

Datentyp: booleschen

Zugriffstyp: Schreibgeschützt

Boolescher Wert, der angibt, dass die in den Eigenschaften der FilterEntryBase-Unterklasse beschriebene Übereinstimmungsbedingung negiert werden soll. Diese Eigenschaft ist für eine einfache Verwendung beim Filtern nach einfachen Negationen definiert , z. B. zum Auswählen aller Quellports mit Ausnahme von 162. Es wird nicht empfohlen, diesen booleschen Wert auf "True" festzulegen, wenn nach mehreren Kriterien gefiltert wird, z. B. das Definieren eines IPHeadersFilters basierend auf Quell-/Zieladressen, Ports und DiffServ-Codepunkten.

Diese Eigenschaft wird von CIM_FilterEntryBasegeerbt.

LocalPortEnd-

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Das Ende der lokalen Portnummer.

LocalPortStart-

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der Start der lokalen Portnummer.

Name

Datentyp: Zeichenfolgen-

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (256), Taste

Definiert die Beschriftung, nach der der Filtereintrag bekannt und eindeutig identifiziert wird.

Diese Eigenschaft wird von CIM_FilterEntryBasegeerbt.

OperatingStatus-

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Qualifizierer: ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

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

Diese Eigenschaft wird von CIM_ManagedSystemElementgeerbt.

Wert Bedeutung
Unbekannter
0
Gibt an, dass die Instrumentation zurzeit nicht über die OperatingStatus -Eigenschaft berichten kann.
nicht verfügbar
1
Gibt an, dass die Instrumentierung in der Lage ist, diese Eigenschaft zu melden, sie aber absichtlich nicht für dieses Element zu melden.
Servicing
2
Gibt an, dass das Element im Prozess konfiguriert, verwaltet, bereinigt oder anderweitig verwaltet werden soll.
Starten von
3
Gibt an, dass das Element initialisiert wird.
beenden
4
Gibt an, dass das Element an einen geordneten Stopp gebracht wird.
beendet
5
Gibt an, dass das Element absichtlich beendet wird.
abgebrochen
6
Gibt an, dass das Element unerwartet beendet wurde.
ruhenden
7
Gibt an, dass das Element inaktiv ist oder nicht mehr aktiviert ist.
Abgeschlossene
8
Gibt an, dass das Element seinen Vorgang abgeschlossen hat. Es wird empfohlen, einen PrimaryStatus Eigenschaftswert von OK, Erroroder Degraded auf Erfolg oder Fehler des Vorgangs hinzuweisen.
Migrieren von
9
Gibt an, dass das Element zwischen Hostelementen verschoben wird.
Emigrating
10
Gibt an, dass das Element vom Hostelement weg verschoben wird.
Immigrating
11
Gibt an, dass das Element in ein neues Hostelement verschoben wird.
Momentaufnahme
12
Gibt an, dass eine Momentaufnahmekopie des Elements erstellt wird.
Herunterfahren
13
Gibt an, dass das Element an einen abrupten Stopp gebracht wird.
im Test-
14
Gibt an, dass das Element Testfunktionen ausführt.
Übergang
15
Gibt an, dass das Element zwischen den Zuständen liegt und in beiden Zuständen nicht vollständig verfügbar ist. Verwenden Sie einen anderen Wert, der einen spezifischeren Übergang angibt, wenn eins verfügbar ist.
im Dienst-
16
Gibt an, dass sich das Element im Dienst und im Betrieb befindet.
reservierte DMTF-
17 32767
Reserviert.
reservierte
32768 = Wert
Reserviert.

OperationalStatus-

Datentyp: uint16 Array

Zugriffstyp: Schreibgeschützt

Qualifizierer: ArrayType ("Indiziert"), ModelCorrespondence ("CIM_ManagedSystemElement.StatusDescriptions")

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

Anmerkung

OperationalStatus ersetzt die veraltete Status-eigenschaft. Aufgrund der weit verbreiteten Verwendung der vorhandenen Status Eigenschaft in Verwaltungsanwendungen empfiehlt Microsoft dringend, dass Anbieter oder Instrumentierung sowohl die eigenschaften Status als auch OperationalStatus bereitstellen. Wenn sie instrumentiert ist, sollte Status (da es einwertig ist) auch den primären Status des Elements bereitstellen.

Diese Eigenschaft wird von CIM_ManagedSystemElementgeerbt.

Werte Bedeutung
Unbekannter
0
Gibt an, dass die Implementierung derzeit nicht über OperationalStatus- berichten kann.
Andere
1
Gibt einen nicht definierten Zustand an.
OK
2
Gibt die vollständige Funktionalität ohne Fehler an.
beeinträchtigte
3
Gibt an, dass das Element funktioniert und alle Funktionen bereitgestellt werden. Das Element funktioniert jedoch nicht am besten seiner Fähigkeiten. Beispielsweise funktioniert das Element möglicherweise nicht bei optimaler Leistung oder meldet wiederherstellbare Fehler.
betonten
4
Gibt an, dass das Element funktioniert, aber Aufmerksamkeit benötigt. Überlastung und Überhitzung sind Beispiele für Betonten Zuständen.
Predictive Failure
5
Gibt an, dass ein Element nominal funktioniert, aber in naher Zukunft einen Fehler vorhergesagt hat.
Fehler
6
Gibt an, dass ein Fehler aufgetreten ist.
nicht wiederherstellbaren Fehler
7
Ein nicht behebbarer Fehler ist aufgetreten.
Starten von
8
Der Auftrag wird gestartet.
beenden
9
Der Auftrag wird beendet.
beendet
10
Das Element wurde absichtlich beendet.
im Dienst-
11
Gibt an, dass das Element konfiguriert, verwaltet, bereinigt oder anderweitig verwaltet wird.
Kein Kontakt
12
Gibt an, dass das Überwachungssystem über Kenntnisse dieses Elements verfügt, aber nie in der Lage war, eine Kommunikation damit herzustellen.
Verlorene Kommunikation
13
Gibt an, dass der Auftrag bekannt ist und in der Vergangenheit erfolgreich kontaktiert wurde, aber derzeit nicht erreichbar ist.
abgebrochen
14
Gibt an, dass der Auftrag unerwartet beendet wurde. Möglicherweise muss der Status und die Konfiguration des Auftrags aktualisiert werden.
ruhenden
15
Gibt an, dass der Auftrag inaktiv ist.
unterstützende Entität im Fehler-
16
Gibt an, dass ein Element, von dem dieser Auftrag abhängt, fehlerhaft ist. Dieses Element ist möglicherweise OK, kann aber aufgrund des Zustands eines abhängigen Elements nicht funktionieren. Ein Beispiel ist ein Netzwerkdienst oder Endpunkt, der aufgrund von Netzwerkproblemen mit niedrigerer Ebene nicht funktionieren kann.
Abgeschlossene
17
Gibt an, dass der Auftrag seinen Vorgang abgeschlossen hat. Dieser Wert sollte mit OK, ErrorError kombiniert werden, oder herabgestufte, damit ein Client erkennen kann, ob der vollständige Vorgang Abgeschlossen mit OK- (übergeben), mit Fehler (fehlgeschlagen) oder mit Herabgestuften abgeschlossen (der Vorgang wurde abgeschlossen, aber er hat nicht abgeschlossen oder keinen Fehler gemeldet).
Power Mode
18
"Power Mode" gibt an, dass das Element zusätzliche Energiemodellinformationen enthält, die in der zugeordneten PowerManagementService-Zuordnung enthalten sind.
reservierte DMTF-
19 32767
DMTF hat diesen Teil des Bereichs für zusätzliche OperationalStatus- in Zukunft reserviert.
reservierte
32768 65535
Microsoft hat den nicht verwendeten Teil des Bereichs für zusätzliche OperationalStatus- in Zukunft reserviert.

PrimaryStatus-

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

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

Gibt einen Statuswert auf hoher Ebene an.

Diese Eigenschaft wird von CIM_ManagedSystemElementgeerbt.

Die möglichen Werte sind.

Unbekannter (0)

OK (1)

beeinträchtigte (2)

Fehler (3)

RESERVIERTe DMTF- (4 32767)

Vendor Reserved (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 Remoteportnummer.

RemotePortStart-

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der Start der Remoteportnummer.

SettingName-

Datentyp: Zeichenfolgen-

Zugriffstyp: Schreibgeschützt

Der Name der Einstellung, die dem Filter zugeordnet ist. Informationen zur Einstellung finden Sie unter MSFT_NetTCPSetting.

Status-

Datentyp: Zeichenfolgen-

Zugriffstyp: Schreibgeschützt

Qualifizierer: veraltete ("CIM_ManagedSystemElement.OperationalStatus"), MaxLen (10)

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

Anmerkung

Diese Eigenschaft ist veraltet und wird durch die eigenschaft OperationalStatus ersetzt. Wenn Sie die eigenschaft Status für die Abwärtskompatibilität verwenden, sollte sie der OperationalStatus-eigenschaft sekundär sein.

Diese Eigenschaft wird von CIM_ManagedSystemElementgeerbt.

Die möglichen Werte sind.

("OK")

("Fehler")

("Herabgestuft")

("Unbekannt")

("Pred Fail")

("Start")

("Beenden")

("Service")

("Betont")

("NonRecover")

("Kein Kontakt")

("Lost Comm")

("Beendet")

StatusDescriptions-

Datentyp: Zeichenfolge Array

Zugriffstyp: Schreibgeschützt

Qualifizierer: ArrayType ("Indiziert"), ModelCorrespondence ("CIM_ManagedSystemElement.OperationalStatus")

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

Diese Eigenschaft wird von CIM_ManagedSystemElementgeerbt.

SystemCreationClassName-

Datentyp: Zeichenfolgen-

Zugriffstyp: Schreibgeschützt

Qualifizierer: Key, MaxLen (256), verteilte ("CIM_ComputerSystem.CreationClassName")

Die Bereichsdefinition des CreationClassName des Computersystems.

Diese Eigenschaft wird von CIM_FilterEntryBasegeerbt.

SystemName-

Datentyp: Zeichenfolgen-

Zugriffstyp: Schreibgeschützt

Qualifizierer: Key, MaxLen (256), verteilten ("CIM_ComputerSystem.Name")

Der Name des Bereichs "ComputerSystem".

Diese Eigenschaft wird von CIM_FilterEntryBasegeerbt.

Anforderungen

Mindestens unterstützter Client
Windows 8
Mindestens unterstützter Server
Windows Server 2012
Namespace
Root\StandardCimv2
MOF
NetTCPIP.mof
DLL
NetTCPIP.dll

Siehe auch

CIM_FilterEntryBase

MSFT_NetTCPSetting