Condividi tramite

Classe MSFT_NetTransportFilter

  • Articolo

Rappresenta il filtro per l'impostazione del parametro del protocollo di trasporto per il provider WMI v2 TCP/IP Microsoft.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate.

Sintassi

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

Membri

La classe MSFT_NetTransportFilter ha questi tipi di membri:

Proprietà

La classe MSFT_NetTransportFilter ha queste proprietà.

Caption

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64)

Contiene una breve descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedElement.

CommunicationStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Indica la capacità della strumentazione di comunicare con questo elemento. Un valore NULL indica che la strumentazione non supporta questa proprietà.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Valori Significato
Unknown
0
 Indica che la strumentazione non può creare report sulla proprietà CommunicationStatus al momento.
Non disponibile
1
 Indica che la strumentazione è in grado di segnalare questa proprietà, ma intenzionalmente non per questo elemento.
Comunicazione OK
2
 Indica solo che la comunicazione viene stabilita con l'elemento .
Comunicazione persa
3
 Indica che l'elemento è stato contattato in passato, ma non è attualmente raggiungibile.
Nessun contatto
4
 Indica che la strumentazione dispone di informazioni di contatto per questo elemento, ma non è mai stata in grado di comunicare con essa.
DMTF riservato
5 32767
 Riservato.
Fornitore riservato
32768 = valore
Riservato.

CreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: key, MaxLen (256)

Nome della classe o della sottoclasse utilizzata nella creazione di un'istanza di . Se utilizzata con le altre proprietà chiave di questa classe, questa proprietà consente l'identificazione univoca di tutte le istanze di questa classe e delle relative sottoclassi.

Questa proprietà viene ereditata da CIM_FilterEntryBase.

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Fornisce una descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedElement.

DestinationPrefix

Tipo di dati: string

Tipo di accesso: sola lettura

Prefisso di destinazione da filtrare.

DetailedStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

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

Indica dettagli di stato aggiuntivi che integrano la proprietà PrimaryStatus . Un valore NULL indica che la strumentazione non supporta questa proprietà.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Valori Significato
Non disponibile
0
 Indica che la strumentazione è in grado di segnalare questa proprietà, ma intenzionalmente non la segnala per questo elemento.
Nessuna informazione aggiuntiva
1
 Indica che non è necessario aggiungere dettagli alla proprietà PrimaryStatus , ad esempio quando PrimaryStatus è impostato su OK.
Stressato
2
 Indica che le funzioni dell'elemento, ma richiedono attenzione. L'overload e il surriscaldamento sono esempi di stati stressati .
Errore predittivo
3
 Indica che un elemento funziona in modo nominale, ma prevede un errore nel prossimo futuro.
Errore non ripristinabile
4
 Indica che questo elemento si trova in una condizione di errore che richiede l'intervento umano.
Supporto dell'entità in errore
5
 Indica che un elemento da cui dipende questo elemento è in errore. Questo elemento potrebbe essere OK , ma non può funzionare a causa dello stato di un elemento dipendente. Un esempio è un servizio di rete o un endpoint che non può funzionare a causa di problemi di rete di livello inferiore.
DMTF riservato
6 32767
 Riservato.
Fornitore riservato
32768 = valore
Riservato.

ElementName

Tipo di dati: string

Tipo di accesso: sola lettura

Contiene un nome descrittivo per l'oggetto. Questa proprietà consente a ogni istanza di definire un nome descrittivo oltre alle relative proprietà chiave, dati di identità e informazioni sulla descrizione.

Questa proprietà viene ereditata da CIM_ManagedElement.

HealthState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Indica l'integrità corrente dell'elemento. Questo attributo esprime l'integrità di questo elemento, ma non necessariamente quella dei relativi componenti secondari.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Valori Significato
Unknown
0
 L'implementazione non può in questo momento segnalare HealthState .
OK
5
 L'elemento è completamente funzionale ed è operativo all'interno dei normali parametri operativi e senza errori.
Avviso/danneggiato
10
 L'elemento è in ordine di lavoro e viene fornita tutta la funzionalità. Tuttavia, l'elemento non funziona al meglio delle sue capacità. Ad esempio, l'elemento potrebbe non funzionare a prestazioni ottimali o potrebbe segnalare errori ripristinabili
Errore secondario
15
 Tutte le funzionalità sono disponibili, ma alcune potrebbero essere ridotte.
Errore principale
20
 L'elemento ha esito negativo. È possibile che alcune o tutte le funzionalità di questo componente siano ridotte o meno.
Errore critico
25
 L'elemento non è funzionale e il ripristino potrebbe non essere possibile.
Errore non ripristinabile
30
 L'elemento non è riuscito e il ripristino non è possibile. Tutte le funzionalità fornite da questo elemento sono andate perse.
DMTF riservato
31 = valore
DMTF ha riservato la parte inutilizzata del continuum per ulteriori valori di HealthStates in futuro.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Indica quando l'oggetto è stato installato. La mancanza di un valore non indica che l'oggetto non è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

InstanceID

Tipo di dati: string

Tipo di accesso: sola lettura

Identifica in modo univoco e opaco un'istanza di questa classe nell'ambito dello spazio dei nomi contenitore.

[! Importante]Per garantire l'univocità all'interno dello spazio dei nomi, il valore di InstanceID deve essere costruito nel modello seguente:

OrgID:LocalID

OrgID deve includere un nome protetto da copyright, registrato o altrimenti univoco di proprietà dell'entità aziendale che definisce instanceID oppure essere un ID registrato assegnato da un'autorità globale riconosciuta. È simile alla struttura dei nomi delle classi schema. Inoltre, per garantire l'univocità dei primi due punti in InstanceID deve essere tra OrgID eLocalID. L'OrgID non deve contenere due punti (':').

LocalID viene scelto dall'entità aziendale e non deve essere riutilizzato per identificare diversi elementi reali sottostanti.

Se il modello precedente non viene usato, l'entità di definizione deve garantire che l'ID istanza risultante non venga riutilizzato in qualsiasi instanceIDprodotto da questo o da altri provider per questo spazio dei nomi.

Per le istanze definite dmtf (Distributed Management Task Force), il modello deve essere usato con OrgID impostato su CIM.

Questa proprietà viene ereditata da CIM_ManagedElement.

IsNegated

Tipo di dati: booleano

Tipo di accesso: sola lettura

Valore booleano che indica che la condizione di corrispondenza descritta nelle proprietà della sottoclasse FilterEntryBase deve essere negata. Questa proprietà viene definita per semplificare l'uso quando si filtrano in base a semplici negazioni, ad esempio per selezionare tutte le porte di origine ad eccezione di 162. Non è consigliabile impostare questo valore booleano su True quando si filtrano in base a più criteri, ad esempio la definizione di un ipHeadersFilter in base a indirizzi di origine/destinazione, porte e punti di codice DiffServ.

Questa proprietà viene ereditata da CIM_FilterEntryBase.

LocalPortEnd

Tipo di dati: uint16

Tipo di accesso: sola lettura

Fine del numero di porta locale.

LocalPortStart

Tipo di dati: uint16

Tipo di accesso: sola lettura

Inizio del numero di porta locale.

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (256), tasto

Definisce l'etichetta in base alla quale la voce filtro è nota e identificata in modo univoco.

Questa proprietà viene ereditata da CIM_FilterEntryBase.

OperatingStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

Indica la condizione operativa corrente dell'elemento. Questa proprietà può essere utilizzata per fornire maggiori dettagli sullo stato corrente dell'elemento. Può anche indicare stati transitori. Un valore NULL indica che la strumentazione non supporta questa proprietà.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Valore Significato
Unknown
0
 Indica che la strumentazione non può creare report sulla proprietà OperatingStatus al momento.
Non disponibile
1
 Indica che la strumentazione è in grado di segnalare questa proprietà, ma intenzionalmente non la segnala per questo elemento.
Manutenzione
2
 Indica che l'elemento è in corso di configurazione, manutenzione, pulizia o amministrazione.
Avvio
3
 Indica che l'elemento viene inizializzato.
Arresto in corso
4
 Indica che l'elemento viene portato a un arresto ordinato.
Arrestato
5
 Indica che l'elemento è intenzionalmente arrestato.
Interrotta
6
 Indica che l'elemento è stato arrestato in modo imprevisto.
Dormiente
7
 Indica che l'elemento è inattivo o inattivo.
Completato
8
 Indica che l'elemento ha completato l'operazione. È consigliabile usare un valore della proprietà PrimaryStatus OK, Error o Degraded per indicare l'esito positivo o negativo dell'operazione.
Migrazione
9
 Indica che l'elemento viene spostato tra gli elementi host.
Emigrare
10
 Indica che l'elemento viene spostato dall'elemento host.
Emigrare
11
 Indica che l'elemento viene spostato in un nuovo elemento host.
Creazione di snapshot
12
 Indica che viene creata una copia snapshot dell'elemento.
Arresto
13
 Indica che l'elemento viene portato a un arresto improvviso.
In Test
14
 Indica che l'elemento sta eseguendo funzioni di test.
Transizione
15
 Indica che l'elemento è compreso tra gli stati e non è completamente disponibile in entrambi gli stati. Usare un altro valore che indica una transizione più specifica, se disponibile.
In servizio
16
 Indica che l'elemento è in servizio e operativo.
DMTF riservato
17 32767
 Riservato.
Fornitore riservato
32768 = valore
Riservato.

OperationalStatus

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Qualificatori: ArrayType ("Indexed"), ModelCorrespondence ("CIM_ManagedSystemElement.StatusDescriptions")

Contiene indicatori dello stato corrente dell'elemento. Il primo valore di OperationalStatus deve contenere lo stato primario per l'elemento.

Nota

OperationalStatus sostituisce la proprietà Status deprecata. A causa dell'uso diffuso della proprietà Status esistente nelle applicazioni di gestione, Microsoft consiglia vivamente che i provider o la strumentazione forniscano sia le proprietà Status che OperationalStatus. Quando instrumentato, Status (perché è a valore singolo) deve anche fornire lo stato primario dell'elemento.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Valori Significato
Unknown
0
 Indica che l'implementazione non può creare report su OperationalStatus al momento.
Altro
1
 Indica uno stato non definito.
OK
2
 Indica la funzionalità completa senza errori.
Degraded
3
 Indica che l'elemento funziona e vengono fornite tutte le funzionalità. Tuttavia, l'elemento non funziona al meglio delle sue capacità. Ad esempio, l'elemento potrebbe non funzionare a prestazioni ottimali o potrebbe segnalare errori ripristinabili
Stressato
4
 Indica che l'elemento funziona, ma richiede attenzione. L'overload e il surriscaldamento sono esempi di stati stressati .
Errore predittivo
5
 Indica che un elemento funziona in modo nominale, ma prevede un errore nel prossimo futuro.
Errore
6
 Indica che si è verificato un errore.
Errore non ripristinabile
7
 Si è verificato un errore irreversibile.
Avvio
8
 Il processo viene avviato.
Arresto in corso
9
 Il processo viene arrestato.
Arrestato
10
 L'elemento è stato arrestato intenzionalmente.
In servizio
11
 Indica che l'elemento è in corso di configurazione, manutenzione, pulizia o amministrazione diversa.
Nessun contatto
12
 Indica che il sistema di monitoraggio ha conoscenza di questo elemento, ma non è mai stato in grado di stabilire comunicazioni con esso.
Comunicazione persa
13
 Indica che il processo è noto e che è stato contattato correttamente in passato, ma attualmente non è raggiungibile.
Interrotta
14
 Indica che il processo è stato arrestato in modo imprevisto. Potrebbe essere necessario aggiornare lo stato e la configurazione del processo.
Dormiente
15
 Indica che il processo è inattivo.
Supporto dell'entità in errore
16
 Indica che un elemento da cui dipende questo processo è in errore. Questo elemento può essere OK , ma non è in grado di funzionare a causa dello stato di un elemento dipendente. Un esempio è un servizio di rete o un endpoint che non può funzionare a causa di problemi di rete di livello inferiore.
Completato
17
 Indica che il processo ha completato l'operazione. Questo valore deve essere combinato con OK, Errore o Danneggiato in modo che un client possa indicare se l'operazione completa Completata con OK (superato), Completato con errore (non riuscito) o Completato con danneggiato (operazione completata, ma non è stata completata o non ha registrato un errore).
Power Mode
18
 "Power Mode" indica che l'elemento dispone di informazioni aggiuntive sul modello di alimentazione contenute nell'associazione PowerManagementService associata.
DMTF riservato
19 32767
 DMTF ha riservato questa parte dell'intervallo per valori OperationalStatus aggiuntivi in futuro.
Fornitore riservato
32768 65535
 Microsoft ha riservato la parte inutilizzata dell'intervallo per ulteriori valori OperationalStatus in futuro.

PrimaryStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

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

Indica un valore di stato di alto livello.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

I valori possibili sono.

Sconosciuto (0)

OK (1)

Degradato (2)

Errore (3)

DMTF riservato (4 32767)

Fornitore riservato (32768 = valore )

Protocollo

Tipo di dati: uint16

Tipo di accesso: sola lettura

Specifica il protocollo a cui si applica il filtro.

TCP (6)

UDP (17)

RemotePortEnd

Tipo di dati: uint16

Tipo di accesso: sola lettura

Fine del numero di porta remota.

RemotePortStart

Tipo di dati: uint16

Tipo di accesso: sola lettura

Inizio del numero di porta remota.

SettingName

Tipo di dati: string

Tipo di accesso: sola lettura

Nome dell'impostazione associata al filtro. Per informazioni sull'impostazione, vedere MSFT_NetTCPSetting.

Stato

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Deprecato ("CIM_ManagedSystemElement.OperationalStatus"), MaxLen (10)

Contiene una stringa che indica lo stato primario dell'oggetto.

Nota

Questa proprietà è deprecata e sostituita dalla proprietà OperationalStatus . Se si sceglie di utilizzare la proprietà Status per la compatibilità con le versioni precedenti, deve essere secondaria alla proprietà OperationalStatus .

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

I valori possibili sono.

("OK")

("Errore")

("Degradato")

("Sconosciuto")

("Pred Fail")

("Avvio")

("Arresto")

("Servizio")

("Sottolineato")

("NonRecover")

("Nessun contatto")

("Lost Comm")

("Arrestato")

StatusDescriptions

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Qualificatori: ArrayType ("Indexed"), ModelCorrespondence ("CIM_ManagedSystemElement.OperationalStatus")

Indica le descrizioni dei valori corrispondenti nella matrice OperationalStatus . Ad esempio, se un elemento nella proprietà OperationalStatus contiene il valore Stopping, l'elemento con lo stesso indice di matrice in questa proprietà potrebbe contenere una spiegazione del motivo per cui un oggetto viene arrestato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

SystemCreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: key, MaxLen (256), Propagated ("CIM_ComputerSystem.CreationClassName")

Oggetto CreationClassName del sistema informatico di ambito.

Questa proprietà viene ereditata da CIM_FilterEntryBase.

Systemname

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: key, MaxLen (256), Propagated ("CIM_ComputerSystem.Name")

Nome del computer di ambito.

Questa proprietà viene ereditata da CIM_FilterEntryBase.

Requisiti
Client minimo supportato
 Windows 8
Server minimo supportato
 Windows Server 2012
Spazio dei nomi
 Root\StandardCimv2
MOF
NetTCPIP.mof
DLL
NetTCPIP.dll

Vedi anche

CIM_FilterEntryBase

MSFT_NetTCPSetting