Classe Msvm_EmulatedEthernetPort

Articolo
06/12/2023

Rappresenta una scheda Ethernet emulata. Questa scheda viene usata quando una macchina virtuale non è in grado di eseguire la porta Ethernet sintetica quando non vengono installati circuiti integrati nel guest.

Nota

Questa classe non è disponibile per le macchine virtuali di seconda generazione.

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

Sintassi

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_EmulatedEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Port";
  string   Description = "Microsoft Emulated Ethernet Port";
  string   ElementName = "Legacy Network Adapter";
  datetime InstallDate;
  string   Name = "Ethernet Port";
  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_EmulatedEthernetPort";
  string   DeviceID = "Microsoft:GUID\device-specific data";
  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   Speed = 1000000000;
  uint64   MaxSpeed = 1000000000;
  uint64   RequestedSpeed = 1000000000;
  uint16   UsageRestriction = 4;
  uint16   PortType = 1;
  string   OtherPortType = "Virtual Ethernet";
  string   OtherNetworkPortType;
  uint16   PortNumber;
  uint16   LinkTechnology = 2;
  string   OtherLinkTechnology;
  string   PermanentAddress;
  string   NetworkAddresses[];
  boolean  FullDuplex = True;
  boolean  AutoSense = True;
  string   SupportedMaximumTransmissionUnit = 1500;
  uint64   ActiveMaximumTransmissionUnit = 1500;
  uint32   MaxDataSize = 1500;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  uint16   EnabledCapabilities[];
  string   OtherEnabledCapabilities[];
};

Members

La classe Msvm_EmulatedEthernetPort ha questi tipi di membri:

Metodi
Proprietà

Metodi

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

Proprietà

La classe Msvm_EmulatedEthernetPort 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 e viene sempre impostata su 1500.

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 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 ed è sempre impostata su True.

Disponibilità

Tipo di dati: uint16
Tipo di accesso: sola lettura

Disponibilità e stato primari del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice e viene sempre impostata su Null.

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. 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à 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 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 ed è sempre impostata su "Porta Ethernet".

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 ed è sempre impostata su "Msvm_EmulatedEthernetPort".

Descrizione

Tipo di dati: string
Tipo di accesso: sola lettura

Descrizione dell'oggetto . Questa proprietà viene ereditata da CIM_ManagedElement ed è sempre impostata su "Porta Ethernet emulata di Microsoft".

DetailedStatus

Tipo di dati: uint16
Tipo di accesso: sola lettura

Completa 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: string
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 ed è sempre impostata su "Dati specifici del dispositivo Microsoft:GUID\".

ElementName

Tipo di dati: string
Tipo di accesso: sola lettura

Nome visualizzato per l'oggetto. Questa proprietà viene ereditata da CIM_ManagedElement e viene sempre impostata su "Scheda di rete legacy".

EnabledCapabilities

Tipo di dati: matrice uint16
Tipo di accesso: sola lettura

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

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 ed è sempre impostata su 2 ("Enabled").

EnabledState

Tipo di dati: uint16
Tipo di accesso: sola lettura

Stati abilitati e disabilitati di un elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement ed è sempre impostata su 5 ("Non applicabile").

ErrorCleared

Tipo di dati: booleano
Tipo di accesso: sola lettura

Indica se l'errore segnalato in LastErrorCode è stato cancellato. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene utilizzata.

ErrorDescription

Tipo di dati: string
Tipo di accesso: sola lettura

Stringa che fornisce altre informazioni sull'errore registrato in LastErrorCode e informazioni sulle azioni correttive che è possibile eseguire. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene utilizzata.

FullDuplex

Tipo di dati: booleano
Tipo di accesso: sola lettura

Indica se la porta funziona in modalità full duplex. Questa proprietà viene ereditata da CIM_NetworkPort ed è sempre impostata su True.

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 e viene sempre impostata su 5 ("OK").

IdentifyingDescriptions

Tipo di dati: matrice di stringhe
Tipo di accesso: sola lettura

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

InstallDate

Tipo di dati: datetime
Tipo di accesso: sola lettura

Valore datetime che indica quando è stato installato l'oggetto. 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
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

Ultimo codice di errore segnalato dal dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice e non viene utilizzata.

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 ed è sempre impostata su 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 e viene sempre impostata su 1500.

MaxQuiesceTime

Tipo di dati: uint64
Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_LogicalDevice e non viene utilizzata.

Maxspeed

Tipo di dati: uint64
Tipo di accesso: sola lettura

Larghezza di banda massima della porta, espressa in bit al secondo. Questa proprietà viene ereditata da CIM_LogicalPort e viene sempre impostata su 1000000000000.

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 ed è sempre impostata su "Porta Ethernet".

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 nell'ordine di bit canonico (il bit di indirizzo del gruppo si trova nel bit di basso ordine del primo carattere della stringa). Questa proprietà viene ereditata da CIM_EthernetPort e non viene usata.

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 ed è sempre impostata su 2 ("OK").

OtherEnabledCapabilities

Tipo di dati: matrice di stringhe
Tipo di accesso: sola lettura

Matrice di stringhe free-form che forniscono spiegazioni più dettagliate per una delle funzionalità abilitate specificate come "Other". Questa proprietà viene ereditata da CIM_EthernetPort e non viene usata.

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 ("Altro"). Questa proprietà deve essere impostata su Null quando EnabledState è qualsiasi valore diverso da 1. Questa proprietà viene ereditata da CIM_EnabledLogicalElement e non viene usata.

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 LinkTechnology quando è impostato su 1 ("Altro"). Questa proprietà viene ereditata da CIM_NetworkPort, ma non viene usata.

OtherNetworkPortType

Tipo di dati: stringa
Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_NetworkPort e viene impostata su Null.

OtherPortType

Tipo di dati: stringa
Tipo di accesso: sola lettura

Tipo di modulo, quando PortType è impostato su 1 ("Altro"). Questa proprietà viene ereditata da CIM_LogicalPort ed è sempre impostata su "Virtual Ethernet".

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

Valore	Significato
0	La scheda di interfaccia di rete non è emulata.
1	La scheda di interfaccia di rete viene emulata.

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 e viene sempre impostata su 1 ("Altro").

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

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

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

PrimaryStatus

Tipo di dati: uint16
Tipo di accesso: sola lettura

Fornisce informazioni di stato di alto livello. Questa proprietà deve essere usata insieme alla proprietà DetailedStatus per fornire informazioni dettagliate sullo stato di integrità e livello elevato 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 in LogicalPort.Speed. Questa proprietà viene ereditata da CIM_LogicalPort e viene sempre impostata su 1000000000000.

RequestedState

Tipo di dati: uint16
Tipo di accesso: sola lettura

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

Velocità

Tipo di dati: uint64
Tipo di accesso: sola lettura

Larghezza di banda corrente della porta, in bit al secondo. Per le porte che variano in larghezza di banda o per quelle in cui non è possibile effettuare una stima accurata, questa proprietà deve contenere la larghezza di banda nominale. Questa proprietà viene ereditata da CIM_NetworkPort e viene sempre impostata su 1000000000000.

Status

Tipo di dati: stringa
Tipo di accesso: sola lettura

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

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 con lo stesso indice di matrice in OperationalStatus. Questa proprietà viene ereditata da CIM_ManagedSystemElement ed è sempre impostata su "OK".

StatusInfo

Tipo di dati: uint16
Tipo di accesso: sola lettura

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

SupportatoMaximumTransmissionUnit

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: unità ("byte")

Unità di trasmissione massima (MTU) che può essere supportata in byte. Questa proprietà viene ereditata da CIM_NetworkPort ed è sempre impostata su 1500.

SystemCreationClassName

Tipo di dati: stringa
Tipo di accesso: sola lettura

Nome della classe di creazione del sistema di ambito. Questa proprietà viene ereditata da CIM_LogicalDevice ed è sempre impostata su " Msvm_ComputerSystem".

Systemname

Tipo di dati: stringa
Tipo di accesso: sola lettura

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 dell'elemento EnabledState . 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 usata.

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

Transizione diToState

Tipo di dati: uint16
Tipo di accesso: sola lettura

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

UsageRestriction

Tipo di dati: uint16
Tipo di accesso: sola lettura

In alcune circostanze, una porta logica potrebbe essere identificabile come porta front-end o back-end. Se non esiste alcuna restrizione sull'uso della porta, il valore deve essere impostato su 4 ("Non limitato"). Questa proprietà viene ereditata da CIM_LogicalPort ed è sempre impostata su 4 ("Non limitato").

Commenti

L'accesso alla classe Msvm_EmulatedEthernetPort 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

Condividi tramite