Classe Msvm_EthernetSwitchPort

Articolo
06/12/2023

Rappresenta una porta sul commutatore.

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

Sintassi

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_EthernetSwitchPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Switch Port";
  string   Description = "Microsoft Virtual Ethernet Switch Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_VirtualEthernetSwitch";
  string   SystemName;
  string   CreationClassName = "Msvm_EthernetSwitchPort";
  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[];
  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[];
  uint32   VMQOffloadUsage;
  uint32   IOVOffloadUsage;
};

Members

La classe Msvm_EthernetSwitchPort ha questi tipi di membri:

Metodi
Proprietà

Metodi

La classe Msvm_EthernetSwitchPort 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_EthernetSwitchPort 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.

AdditionalAvailability

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

Qualsiasi disponibilità e stato aggiuntivo del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene utilizzata.

AutoSense

Tipo di dati: booleano
Tipo di accesso: sola lettura

Indica se la porta è 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, ma 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 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 )

CapabilityDescriptions

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

Matrice di stringhe in formato libero che fornisce spiegazioni più dettagliate per le funzionalità di porta contenute nella matrice Capabilities . 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: string
Tipo di accesso: sola lettura

Breve descrizione dell'oggetto. Questa proprietà viene ereditata dalla classe CIM_ManagedElement ed è sempre impostata su "Porta commutatore 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: stringa
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_EthernetSwitchPort".

Descrizione

Tipo di dati: stringa
Tipo di accesso: sola lettura

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

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

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

EnabledState

Tipo di dati: uint16
Tipo di accesso: sola lettura

Stati abilitati e disabilitati di un elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement e sarà uno dei valori seguenti.

Valore	Significato
Enabled 2	L'elemento è in esecuzione.
Disabilitato 3	L'elemento viene disattivato.

ErrorCleared

Tipo di dati: booleano
Tipo di accesso: sola lettura

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

ErrorDescription

Tipo di dati: stringa
Tipo di accesso: sola lettura

Stringa che fornisce altre informazioni sull'errore registrato in LastErrorCode e informazioni su eventuali azioni correttive che possono essere eseguite. 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 e viene sempre impostata su 5 (OK).

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

InstallDate

Tipo di dati: datetime
Tipo di accesso: sola lettura

Data e ora dell'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: stringa
Tipo di accesso: sola lettura
Qualificatori: Chiave

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

IOVOffloadUsage

Tipo di dati: uint32
Tipo di accesso: sola lettura

Utilizzo di offload di I/O corrente su questa porta. L'utilizzo è la quantità di risorse IOV in uso sulla porta.

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, 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 in formato libero che fornisce spiegazioni più dettagliate per tutte le funzionalità abilitate specificate come 1 (Altro). Questa proprietà viene ereditata da CIM_EthernetPort.

OtherEnabledState

Tipo di dati: string
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 è un valore diverso da 1. Questa proprietà viene ereditata da CIM_EnabledLogicalElement ed è sempre impostata su Null.

OtherIdentifyingInfo

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

Eventuali dati aggiuntivi, oltre alle informazioni sull'ID dispositivo, che possono essere usati per identificare un dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice, ma 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

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

OtherPortType

Tipo di dati: string
Tipo di accesso: sola lettura

Descrive il 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
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 viene apportata questa modifica, 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 (Other), la proprietà OtherPortType correlata 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 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, ma non viene utilizzata.

PowerOnHours

Tipo di dati: uint64
Tipo di accesso: sola lettura

Numero di ore consecutive attivate da questo dispositivo dall'ultimo ciclo di alimentazione. 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: solo scrittura
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, 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 . Questa proprietà viene ereditata da CIM_ManagedSystemElement.

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

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

Sconosciuto (0)
Solo front-end (2)
Solo back-end (3)
Non limitato (4 )

VMQOffloadUsage

Tipo di dati: uint32
Tipo di accesso: sola lettura

L'offload dell'utilizzo corrente della coda di macchine virtuali (VMQ) su questa porta. L'utilizzo è la quantità di risorse VMQ in uso sulla porta.

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

Share via