Condividi tramite

Classe Msvm_InternalEthernetPort

  • Articolo

Rappresenta una porta Ethernet interna (scheda di rete). Questo tipo di porta Ethernet consente alle macchine virtuali di accedere al server di virtualizzazione che esegue il software di rete. Le schede di rete interne consentono di instradare o filtrare il traffico di rete delle macchine virtuali prima di uscire dal sistema fisico.

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

Sintassi

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_InternalEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Port";
  string   Description = "Microsoft Internal Ethernet Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_InternalEthernetPort";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint16   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = 6;
  uint64   MaxQuiesceTime;
  uint64   MaxSpeed = 1000000000;
  uint64   RequestedSpeed = 1000000000;
  uint16   UsageRestriction = 4;
  string   OtherPortType;
  uint64   Speed;
  string   OtherNetworkPortType;
  uint16   PortNumber;
  uint16   LinkTechnology = 2;
  string   OtherLinkTechnology;
  string   PermanentAddress;
  boolean  FullDuplex = True;
  boolean  AutoSense = True;
  uint64   SupportedMaximumTransmissionUnit = 1500;
  uint64   ActiveMaximumTransmissionUnit = 1500;
  uint16   PortType;
  string   NetworkAddresses[];
  uint32   MaxDataSize = 1500;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  uint16   EnabledCapabilities[];
  string   OtherEnabledCapabilities[];
};

Members

La classe Msvm_InternalEthernetPort ha questi tipi di membri:

Metodi

La classe Msvm_InternalEthernetPort dispone di questi metodi.

Metodo Descrizione
EnableDevice Questo metodo non è supportato.
OnlineDevice Questo metodo non è supportato.
QuiesceDevice Questo metodo non è supportato.
RequestStateChange Richiede una modifica dello stato.
Reimpostazione Reimposta il dispositivo virtuale.
RestoreProperties Questo metodo non è supportato.
SaveProperties Questo metodo non è supportato.
SetPowerState Questo metodo non è supportato.

Proprietà

La classe Msvm_InternalEthernetPort ha queste proprietà.

ActiveMaximumTransmissionUnit

Tipo di dati: uint64

Tipo di accesso: sola lettura

Unità di trasmissione massima attiva o negoziata (MTU) che può essere supportata. Questa proprietà viene ereditata da CIM_NetworkPort.

AdditionalAvailability

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Qualsiasi disponibilità e stato aggiuntivo del dispositivo, oltre a quello specificato nella proprietà Availability . Questa proprietà viene ereditata da CIM_LogicalDevice.

AutoSense

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se la porta di rete è in grado di determinare automaticamente la velocità o altre caratteristiche di comunicazione del supporto di rete collegato. Questa proprietà viene ereditata da CIM_NetworkPort.

Disponibilità

Tipo di dati: uint16

Tipo di accesso: sola lettura

Disponibilità e stato primari del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene utilizzata.

AvailableRequestedStates

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Indica i valori possibili per il parametro RequestedState del metodo RequestStateChange utilizzato per avviare una modifica dello stato. I valori elencati saranno un subset dei valori contenuti nella proprietà RequestedStatesSupported dell'istanza associata di CIM_EnabledLogicalElementCapabilities, in cui i valori selezionati sono una funzione dello stato corrente dell'oggetto CIM_EnabledLogicalElement . Questa proprietà può essere non Null se un'implementazione è in grado di annunciare il set di valori possibili come funzione dello stato corrente. Questa proprietà sarà Null se un'implementazione non è in grado di determinare il set di valori possibili come funzione dello stato corrente.

Questa proprietà viene ereditata da CIM_EnabledLogicalElement, ma non viene utilizzata.

Capabilities

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Funzionalità della porta Ethernet. Se sono elencate le funzionalità di failover o bilanciamento del carico, è necessario definire anche un CIM_SpareGroup (failover) o CIM_ExtraCapacityGroup (bilanciamento del carico) per descrivere completamente la funzionalità. Questa proprietà viene ereditata da CIM_EthernetPort.

Sconosciuto (0)

Altro (1)

AlertOnLan (2)

WakeOnLan (3)

FailOver (4)

LoadBalancing (5)

CapabilityDescriptions

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Matrice di stringhe in formato libero che fornisce spiegazioni più dettagliate per tutte le funzionalità della porta Ethernet indicate nella matrice Capabilities . Si noti che ogni voce di questa matrice è correlata alla voce nella matrice Capabilities che si trova nello stesso indice. Questa proprietà viene ereditata da CIM_EthernetPort.

Didascalia

Tipo di dati: string

Tipo di accesso: sola lettura

Breve descrizione 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 l'elemento gestito sottostante. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

CreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

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

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Descrizione dell'oggetto . Questa proprietà viene ereditata da CIM_ManagedElement.

DetailedStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Integra la proprietà PrimaryStatus con dettagli di stato aggiuntivi. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Deviceid

Tipo di dati: stringa

Tipo di accesso: sola lettura

Indirizzo o altre informazioni di identificazione usate per assegnare un nome univoco al dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice e viene impostata su "Dati specifici del dispositivo Microsoft:GUID\".

ElementName

Tipo di dati: stringa

Tipo di accesso: Lettura/scrittura

Nome visualizzato per l'oggetto. Questa proprietà consente a ogni istanza di definire un nome visualizzato oltre alle relative proprietà chiave, dati di identità e informazioni sulla descrizione. Questa proprietà viene ereditata da CIM_ManagedElement e viene generata in base alla scheda di interfaccia di rete presente nell'host.

EnabledCapabilities

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Specifica le funzionalità abilitate dall'elenco di tutte le funzionalità supportate, definite nella matrice Funzionalità . Questa proprietà viene ereditata da CIM_EthernetPort.

Sconosciuto (0)

Altro (1)

AlertOnLan (2)

WakeOnLan (3)

FailOver (4)

LoadBalancing (5)

EnabledDefault

Tipo di dati: uint16

Tipo di accesso: sola lettura

Configurazione predefinita o di avvio di un amministratore per lo stato abilitato di un elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

EnabledState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Stati abilitati e disabilitati di un elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

ErrorCleared

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se l'errore segnalato nella proprietà LastErrorCode è ora cancellato. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene usata.

ErrorDescription

Tipo di dati: stringa

Tipo di accesso: sola lettura

Stringa che fornisce altre informazioni sull'errore registrato nella proprietà LastErrorCode e informazioni su eventuali azioni correttive che possono essere eseguite. Questa proprietà viene ereditata dalla proprietà CIM_LogicalDevice e non viene usata.

FullDuplex

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se la porta è operativa in modalità full duplex. Questa proprietà viene ereditata da CIM_NetworkPort.

HealthState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Integrità corrente dell'elemento. Questo attributo esprime l'integrità di questo elemento, ma non necessariamente quella dei relativi sottocomponenti. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

IdentifyingDescriptions

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Matrice di stringhe free-form che forniscono spiegazioni e dettagli dietro le voci nella matrice di proprietà OtherIdentifyingInfo . Ogni voce di questa matrice è correlata alla voce nella matrice di proprietà OtherIdentifyingInfo che si trova nello stesso indice. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene usata.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Valore datetime che 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: stringa

Tipo di accesso: sola lettura

Qualificatori: Chiave

Identifica in modo univoco un'istanza di questa classe. Questa proprietà viene ereditata da CIM_ManagedElement.

LastErrorCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

L'ultimo codice di errore segnalato dal dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene usata.

LinkTechnology

Tipo di dati: uint16

Tipo di accesso: sola lettura

Tipi di collegamenti. Se impostato su 1 (Altro), la proprietà correlata OtherLinkTechnology contiene una descrizione stringa del tipo di collegamento. Questa proprietà viene ereditata da CIM_NetworkPort.

Valore Significato
2
 Ethernet

MaxDataSize

Tipo di dati: uint32

Tipo di accesso: sola lettura

Dimensione massima del campo INFO (non MAC) che verrà ricevuto o trasmesso. Questa proprietà viene ereditata da CIM_EthernetPort.

MaxQuiesceTime

Tipo di dati: uint64

Tipo di accesso: sola lettura

La proprietà è stata deprecata. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene usata.

Maxspeed

Tipo di dati: uint64

Tipo di accesso: sola lettura

Larghezza di banda massima della porta, in bit al secondo. Questa proprietà viene ereditata da CIM_LogicalPort.

Nome

Tipo di dati: stringa

Tipo di accesso: sola lettura

Etichetta in base alla quale l'oggetto è noto. Quando viene sottoclassata, questa proprietà può essere sottoposta a override per essere una proprietà chiave. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

NetworkAddresses

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Gli indirizzi MAC Ethernet/802.3 formattati come dodici cifre esadecimali ,ad esempio "010203040506"), con ogni coppia che rappresenta uno dei sei ottet dell'indirizzo MAC nell'ordine di bit canonico (il bit di indirizzo gruppo viene trovato nel bit di ordine basso del primo carattere della stringa). Questa proprietà viene ereditata da CIM_EthernetPort.

OperatingStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Fornisce informazioni sullo stato correnti per la condizione operativa dell'elemento e può essere usato per fornire maggiori dettagli rispetto al valore della proprietà EnabledState . Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

OperationalStatus

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Stato corrente dell'elemento. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

OtherEnabledCapabilities

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Matrice di stringhe free-form che forniscono spiegazioni più dettagliate per una qualsiasi delle funzionalità abilitate specificate come 1 (Altro). Questa proprietà viene ereditata da CIM_EthernetPort.

OtherEnabledState

Tipo di dati: stringa

Tipo di accesso: sola lettura

Stringa che descrive lo stato abilitato o disabilitato dell'elemento quando la proprietà EnabledState è impostata su 1 (Other.) Questa proprietà deve essere impostata su Null quando la proprietà EnabledState è qualsiasi valore diverso da 1. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

OtherIdentifyingInfo

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Tutti i dati, oltre alle informazioni sull'ID dispositivo, che possono essere usate per identificare un dispositivo logico. Ad esempio, è possibile usare questa proprietà per contenere il nome visualizzato del sistema operativo per il dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene usata.

OtherLinkTechnology

Tipo di dati: stringa

Tipo di accesso: sola lettura

Valore stringa che descrive la proprietà LinkTechnology quando è impostata su 1 (Altro). Questa proprietà viene ereditata da CIM_NetworkPort.

OtherNetworkPortType

Tipo di dati: stringa

Tipo di accesso: sola lettura

Questa proprietà è deprecata. Utilizzare la proprietà PortType . Questa proprietà viene ereditata da CIM_NetworkPort.

Descrizione deprecata: tipo di modulo, quando la proprietà PortType è impostata su 1 (Altro).

OtherPortType

Tipo di dati: stringa

Tipo di accesso: sola lettura

Tipo di modulo, quando la proprietà PortType è impostata su 1 (Altro). Questa proprietà viene ereditata da CIM_LogicalPort .

PermanenteAddress

Tipo di dati: stringa

Tipo di accesso: sola lettura

Indirizzo di rete hardcoded in una porta. Questo indirizzo può essere modificato usando un aggiornamento del firmware o una configurazione software. Quando questa modifica viene apportata, il campo deve essere aggiornato contemporaneamente. Questa operazione deve essere lasciata vuota se non esiste alcun indirizzo hardcoded per la scheda di rete. Questa proprietà viene ereditata da CIM_NetworkPort.

Portnumber

Tipo di dati: uint16

Tipo di accesso: sola lettura

Le porte di rete vengono spesso numerate rispetto a un modulo logico o a un elemento di rete. Questo valore è 1 per le schede di interfaccia di rete emulate, 0 per tutte le altre. Questa proprietà viene ereditata da CIM_NetworkPort.

Porttype

Tipo di dati: uint16

Tipo di accesso: sola lettura

Modalità specifica attualmente abilitata per la porta. Se impostato su 1 (Altro), la proprietà correlata OtherPortType contiene una descrizione stringa del tipo di porta. Questa proprietà viene ereditata da CIM_EthernetPort.

Sconosciuto (0)

Altro (1)

//50 Rame 10BaseT (50 )

10-100BaseT (51)

100BaseT (52)

1000BaseT (53)

2500BaseT (54 )

10GBaseT (55)

10GBase-CX4 (56)

//100 Fibre 100Base-FX (100 )

100Base-SX (101 )

1000Base-SX (102 )

1000Base-LX (103 )

1000Base-CX (104 )

10GBase-SR (105 )

10GBase-SW (106 )

10GBase-LX4 (107 )

10GBase-LR (108)

10GBase-LW (109)

10GBase-ER (110)

10GBase-EW (111)

Fornitore riservato (16000 65535)

PowerManagementCapabilities

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Funzionalità di risparmio energia del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene utilizzata.

PowerManagementSupported

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se il dispositivo può essere gestito dall'alimentazione. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene utilizzata.

PowerOnHours

Tipo di dati: uint64

Tipo di accesso: sola lettura

Numero di ore consecutive che questo dispositivo è stato alimentato, dall'ultimo ciclo di alimentazione. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene utilizzata.

PrimaryStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Fornisce informazioni generali sullo stato. Questa proprietà deve essere utilizzata insieme alla proprietà DetailedStatus per fornire informazioni dettagliate e dettagliate sullo stato di integrità per l'elemento e i relativi sottocomponenti. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

RequestedSpeed

Tipo di dati: uint64

Tipo di accesso: sola lettura

Larghezza di banda richiesta della porta, in bit al secondo. La larghezza di banda effettiva viene segnalata nella proprietà Speed . Questa proprietà viene ereditata da CIM_LogicalPort.

RequestedState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Ultimo stato richiesto o desiderato per il servizio di gestione. Quando la proprietà EnabledState è impostata su 5 (Non applicabile), questa proprietà non ha alcun significato. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Velocità

Tipo di dati: uint64

Tipo di accesso: sola lettura

Qualificatori: override, unità ("bit al secondo")

Larghezza di banda corrente della porta in bit al secondo. Per le porte che variano in termini di larghezza di banda o per quelle in cui non è possibile eseguire stime accurate, questa proprietà deve contenere la larghezza di banda nominale. Questa proprietà viene ereditata da CIM_NetworkPort.

Status

Tipo di dati: string

Tipo di accesso: sola lettura

Stato corrente dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedSystemElement, ma non viene utilizzata.

StatusDescriptions

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Stringhe che descrivono i vari valori della matrice OperationalStatus . Le voci in questa matrice sono correlate a quelle nello stesso indice di matrice in OperationalStatus. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

StatusInfo

Tipo di dati: uint16

Tipo di accesso: sola lettura

Stato del dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene utilizzata.

SupportedMaximumTransmissionUnit

Tipo di dati: uint64

Tipo di accesso: sola lettura

Unità di trasmissione massima (MTU) che può essere supportata. Questa proprietà viene ereditata da CIM_NetworkPort.

SystemCreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Nome della classe di creazione del sistema di ambito. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non è supportata

Systemname

Tipo di dati: string

Tipo di accesso: sola lettura

Nome del sistema di definizione dell'ambito. Questa proprietà viene ereditata da CIM_LogicalDevice.

TimeOfLastStateChange

Tipo di dati: datetime

Tipo di accesso: sola lettura

Data o ora dell'ultima modifica della proprietà EnabledState dell'elemento. Se lo stato dell'elemento non è stato modificato e questa proprietà viene popolata, deve essere impostata su un valore di intervallo 0. Se è stata richiesta una modifica dello stato, ma rifiutata o non ancora elaborata, la proprietà non deve essere aggiornata. Questa proprietà viene ereditata da CIM_EnabledLogicalElement e non viene utilizzata.

TotalPowerOnHours

Tipo di dati: uint16

Tipo di accesso: sola lettura

Numero totale di ore di alimentazione del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene utilizzata.

TransitioningToState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Indica lo stato di destinazione in cui viene eseguita la transizione dell'istanza. Questa proprietà viene ereditata da CIM_EnabledLogicalElement, ma non viene utilizzata.

UsageRestriction

Tipo di dati: uint16

Tipo di accesso: sola lettura

In alcuni casi, una porta logica potrebbe essere identificabile come porta front-end o back-end. Questa proprietà viene ereditata da CIM_LogicalPort.

Valore Significato
4
 Non limitato

Commenti

L'accesso alla classe Msvm_InternalEthernetPort potrebbe essere limitato dal filtro dell'interfaccia utente. Per altre informazioni, vedere Controllo account utente e WMI.

Esempio

Vedere Esecuzione di query sugli oggetti di rete.

Requisiti

Requisito Valore
Client minimo supportato
 Windows 8 [solo app desktop]
Server minimo supportato
 Windows Server 2012 [solo app desktop]
Spazio dei nomi
 Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Vedi anche

CIM_EthernetPort

CIM_EthernetPort