Condividi tramite

Classe Msvm_SyntheticEthernetPort

  • Articolo

Rappresenta una scheda Ethernet sintetica. Questa scheda è la scheda di rete preferita a causa delle prestazioni e perché le modifiche apportate possono essere applicate immediatamente, mentre è in uso (configurabilità ad accesso frequente).

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

Sintassi

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

Members

La classe Msvm_SyntheticEthernetPort include questi tipi di membri:

Metodi

La classe Msvm_SyntheticEthernetPort 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.
RestoreProperties Questo metodo non è supportato.
SaveProperties Questo metodo non è supportato.
SetPowerState Questo metodo non è supportato.

Proprietà

La classe Msvm_SyntheticEthernetPort ha queste proprietà.

ActiveMaximumTransmissionUnit

Tipo di dati: uint64

Tipo di accesso: sola lettura

Qualificatori: unità ("byte")

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

Disponibilità e stato aggiuntivi del dispositivo, oltre a quello specificato nella proprietà Availability . Questa proprietà viene ereditata da CIM_LogicalDevice ed è sempre impostata su 6 (Non applicabile).

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.

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

Abilitato (2)

Disabilitato (3)

Arresto (4)

Offline (6)

Test (7)

Rinvio (8)

Quiesce (9)

Riavvio (10)

Reimpostazione (11)

DMTF Riservato (.. )

Capabilities

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Funzionalità della porta Ethernet. Ad esempio, il dispositivo potrebbe supportare AlertOnLan, WakeOnLan, Bilanciamento del carico o FailOver. Se sono elencate le funzionalità di failover o bilanciamento del carico, è necessario definire anche un SpareGroup (failover) o ExtraCapacityGroup (bilanciamento del carico) per descrivere completamente la funzionalità. Questa proprietà viene ereditata da CIM_EthernetPort e non viene utilizzata.

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à EthernetPort indicate nella matrice di proprietà Capabilities . Si noti che ogni voce di questa matrice è correlata alla voce nella matrice di proprietà Capabilities che si trova nello stesso indice. Questa proprietà viene ereditata da CIM_EthernetPort e non viene utilizzata.

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 . Questa proprietà viene ereditata da CIM_LogicalDevice.

Descrizione

Tipo di dati: stringa

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.

ElementName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome visualizzato per l'oggetto. Questa proprietà viene ereditata da CIM_ManagedElement.

EnabledCapabilities

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Le funzionalità abilitate dall'elenco di tutte le funzionalità supportate, definite nella matrice di proprietà Capabilities . Questa proprietà viene ereditata da CIM_EthernetPort, ma non viene usata.

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 questo elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

ErrorCleared

Tipo di dati: booleano

Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene usata.

ErrorDescription

Tipo di dati: stringa

Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_LogicalDevice, ma 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. 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 OtherIdentifyingInfo . Questa proprietà viene ereditata da CIM_LogicalDevice e non viene usata.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Data di aggiunta della porta Ethernet alla macchina virtuale. 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

Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene usata.

LinkTechnology

Tipo di dati: uint16

Tipo di accesso: sola lettura

Enumerazione dei 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.

Ethernet (2)

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

Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene usata.

Maxspeed

Tipo di dati: uint64

Tipo di accesso: sola lettura

Qualificatori: unità ("bit al secondo")

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

Nome visualizzato per l'oggetto. 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 ottetti dell'indirizzo MAC in ordine di bit canonico (il bit di indirizzo del gruppo si trova nel bit di ordine basso del primo carattere della stringa). Questa proprietà viene ereditata da CIM_EthernetPort e non viene utilizzata.

OperatingStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Fornisce informazioni sullo stato correnti per la condizione operativa dell'elemento e può essere utilizzata 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 ed è sempre impostata su 2 (OK).

OtherEnabledCapabilities

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à abilitate specificate come "Altro". Questa proprietà viene ereditata da CIM_EthernetPort e non viene utilizzata.

OtherEnabledState

Tipo di dati: string

Tipo di accesso: sola lettura

Stato abilitato o disabilitato dell'elemento quando la proprietà EnabledState è impostata su 1 (Other). 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 usati per identificare un dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene utilizzata.

OtherLinkTechnology

Tipo di dati: string

Tipo di accesso: sola lettura

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

OtherNetworkPortType

Tipo di dati: string

Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_NetworkPort ed è impostata su Null.

OtherPortType

Tipo di dati: string

Tipo di accesso: sola lettura

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

PermanentAddress

Tipo di dati: string

Tipo di accesso: sola lettura

Indirizzo di rete hardcoded nella porta. Questo indirizzo hardcoded può essere modificato usando un aggiornamento del firmware o una configurazione software. Quando viene apportata questa modifica, il campo deve essere aggiornato contemporaneamente. La proprietà PermanentAddress 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 sono 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 tutti gli altri. 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.

PowerManagementCapabilities

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

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

PowerManagementSupported

Tipo di dati: booleano

Tipo di accesso: sola lettura

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

PowerOnHours

Tipo di dati: uint64

Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_LogicalDevice, ma 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

Qualificatori: unità ("bit al secondo")

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. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Velocità

Tipo di dati: uint64

Tipo di accesso: sola lettura

Qualificatori: 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'elemento. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

StatusDescriptions

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Stringhe che descrivono i vari valori della matrice OperationalStatus . Questa proprietà viene ereditata da CIM_ManagedSystemElement.

StatusInfo

Tipo di dati: uint16

Tipo di accesso: sola lettura

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

SupportedMaximumTransmissionUnit

Tipo di dati: uint64

Tipo di accesso: sola lettura

Qualificatori: unità ("byte")

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.

Systemname

Tipo di dati: string

Tipo di accesso: sola lettura

Nome NetBIOS del sistema computer di hosting. Questa proprietà conterrà l'ID macchina virtuale nel formato GUID . Questa proprietà viene ereditata da CIM_LogicalDevice.

TimeOfLastStateChange

Tipo di dati: datetime

Tipo di accesso: sola lettura

Data o ora dell'ultima modifica dello stato abilitato dell'elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

TotalPowerOnHours

Tipo di dati: uint64

Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_LogicalDevice, ma 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.

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. Se non esiste alcuna restrizione per l'uso della porta, il valore deve essere impostato su 4 (Senza restrizioni). Questa proprietà viene ereditata da CIM_LogicalPort.

Commenti

L'accesso alla classe Msvm_SyntheticEthernetPort potrebbe essere limitato dal filtro controllo dell'account utente. Per altre informazioni, vedere Controllo dell'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