Condividi tramite

Classe Msvm_ExternalEthernetPort

  • Articolo

Rappresenta una porta Ethernet esterna (scheda di rete). Questi tipi di porte Ethernet consentono alle macchine virtuali di accedere alla rete esterna.

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

Sintassi

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_ExternalEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Port";
  string   Description = "Microsoft External Ethernet Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[] = "OK";
  string   Status = "OK";
  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_ExternalEthernetPort";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  string   AdditionalAvailability[];
  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[];
  boolean  IsBound;
};

Members

La classe Msvm_ExternalEthernetPort include questi tipi di membri:

Metodi

La classe Msvm_ExternalEthernetPort include 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_ExternalEthernetPort 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 in byte. Questa proprietà viene ereditata da CIM_NetworkPort.

Disponibilità aggiuntiva

Tipo di dati: matrice di stringhe

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, ma non viene usata.

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 dei supporti di rete collegati. Questa proprietà viene ereditata da CIM_NetworkPort.

Disponibilità

Tipo di dati: uint16

Tipo di accesso: sola lettura

Disponibilità primaria e stato del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene usata.

AvailableRequestedStates

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Indica i valori possibili per il parametro RequestedState del metodo RequestStateChange usato 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

Matrice che specifica le funzionalità della porta. Questa proprietà viene ereditata da CIM_EthernetPort.

Sconosciuto (0)

Altro (1)

AlertOnLan (2)

WakeOnLan (3)

FailOver (4)

LoadBalancing (5)

FunzionalitàDescriptions

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Matrice di stringhe free-form che forniscono spiegazioni più dettagliate per le funzionalità di porta contenute nella matrice Funzionalità . Ogni voce di questa matrice è correlata alla voce corrispondente nella matrice Capabilities che si trova nello stesso indice. Questa proprietà viene ereditata da CIM_EthernetPort.

Didascalia

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64)

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 di creazione del sistema di ambito. Questa proprietà viene ereditata da CIM_LogicalDevice e viene sempre impostata su "Msvm_ExternalEthernetPort".

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 esterna 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 per assegnare un nome univoco al dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice.

ElementName

Tipo di dati: string

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

Specifica le funzionalità abilitate dall'elenco di tutte le funzionalità supportate nella matrice Capabilities . 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 la proprietà EnabledState di un elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement e viene sempre impostata su 2 (Enabled).

EnabledState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Stati abilitati e disabilitati di un elemento. Può anche indicare le transizioni tra questi stati richiesti. Ad esempio, l'arresto (4) e l'avvio (10) sono stati temporanei tra abilitato e disabilitato. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Valore Significato
Unknown
0
Altri
1
Enabled
2
 L'elemento è o potrebbe eseguire comandi, elaborerà eventuali comandi in coda e accoda nuove richieste.
Disabilitato
3
 L'elemento non eseguirà i comandi e rimuoverà eventuali nuove richieste.
Arresto
4
 L'elemento è in corso di passaggio a uno stato Disabled.
Non applicabile
5
 L'elemento non supporta l'abilitazione o la disabilitazione.
Abilitato ma offline
6
 L'elemento potrebbe completare i comandi e rimuoverà eventuali nuove richieste.
In Test
7
 L'elemento si trova in uno stato di test.
Differita
8
 L'elemento potrebbe completare i comandi, ma accoderà eventuali nuove richieste.
Disattivazione
9
 L'elemento è abilitato ma in modalità con restrizioni. Il comportamento dell'elemento è simile allo stato Enabled, ma elabora solo un set limitato di comandi. Tutte le altre richieste vengono accodate.
Avvio in corso
10
 L'elemento è in corso di passaggio a uno stato Enabled. Le nuove richieste vengono accodate.
DMTF Riservato
11 32767
 Riservato.
Fornitore riservato
32768 65535
 Riservato.

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, ma 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, ma 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.

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. I valori possibili sono da 0 a 30, dove 5 indica che l'elemento è completamente integro e 30 indica che l'elemento è completamente non funzionale. 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 di proprietà OtherIdentifyingInfo . Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene utilizzata.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Data e ora di installazione dell'oggetto. Questa proprietà non richiede un valore per indicare che l'oggetto è 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.

IsBound

Tipo di dati: booleano

Tipo di accesso: sola lettura

Se questa proprietà è True, questa porta Ethernet può essere connessa ai commutatori e quindi può fornire connettività a una macchina virtuale. Se questa proprietà è False, questa porta Ethernet non viene usata dall'architettura di rete della macchina virtuale.

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, ma non viene utilizzata.

LinkTechnology

Tipo di dati: uint16

Tipo di accesso: sola lettura

Specifica il tipo di tecnologia di collegamento per la porta. Se impostato su 1 (Other), la proprietà OtherLinkTechnology contiene una descrizione stringa del tipo di collegamento. Questa proprietà viene ereditata da CIM_NetworkPort.

Sconosciuto (0)

Altro (1)

Ethernet (2)

IB (3)

FC (4)

FDDI (5)

BANCOMAT (6)

Anello token (7)

Inoltro cornice (8)

Infrarosso (9)

BlueTooth (10)

LAN wireless (11)

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

La proprietà è stata deprecata. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene utilizzata.

Maxspeed

Tipo di dati: uint64

Tipo di accesso: sola lettura

Qualificatori: unità ("bit al secondo")

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

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

Etichetta in base alla quale è noto l'oggetto. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

NetworkAddresses

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Qualificatori: MaxLen ( 64 )

Matrice di stringhe che contengono gli indirizzi MAC per la porta. Questa proprietà viene ereditata da CIM_NetworkPort.

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

Stati correnti dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedSystemElement e ogni elemento della matrice è sempre impostato 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 1 (Other.) 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 (Altro). Questa proprietà deve essere impostata su Null quando 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 aggiuntivi, oltre alle informazioni sull'ID dispositivo, che possono essere usate per identificare un dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice, ma 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.

OtherNetworkPortType

Tipo di dati: stringa

Tipo di accesso: sola lettura

L'uso di questa proprietà è deprecato al posto della proprietà PortType . Questa proprietà viene ereditata da CIM_NetworkPort.

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.

PermanenteAddress

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64)

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

Il numero della porta. 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_LogicalPort.

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, ma 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, ma non viene usata.

PowerOnHours

Tipo di dati: uint64

Tipo di accesso: sola lettura

Numero di ore consecutive che questo dispositivo è stato attivato dall'ultimo ciclo di alimentazione. Questa proprietà viene ereditata da CIM_LogicalDevice, ma 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

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 l'elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement e viene sempre impostata su 12 (non applicabile).

Velocità

Tipo di dati: uint64

Tipo di accesso: sola lettura

Qualificatori: unità ("bit al secondo")

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

Status

Tipo di dati: string

Tipo di accesso: sola lettura

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

"OK"

OK

Errore

Degradata

Sconosciuto

Pred Fail

A partire

Fermarsi

Servizio

Stressato

NonRecover

Nessun contatto

Perso Comm

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 e ogni elemento della matrice è sempre impostato su "OK".

StatusInfo

Tipo di dati: uint16

Tipo di accesso: sola lettura

Stato corrente del dispositivo logico. 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, in byte. 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 e viene sempre impostata su "Msvm_ComputerSystem".

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 dello stato abilitato dell'elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement ed è sempre impostata su Null.

TotalPowerOnHours

Tipo di dati: uint64

Tipo di accesso: sola lettura

Numero totale di ore di alimentazione del dispositivo. 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, 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. Un esempio di questa situazione è un array di archiviazione che potrebbe avere porte back-end per comunicare con le unità disco e le porte front-end per comunicare con gli host. Se non esiste alcuna restrizione sull'uso della porta, il valore deve essere impostato su "Non limitato". Questa proprietà viene ereditata da CIM_LogicalPort.

Sconosciuto (0)

Solo front-end (2)

Solo back-end (3)

Non limitato (4)

Commenti

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