Condividi tramite

classe Msvm_SyntheticEthernetPortSettingData

  • Articolo

Rappresenta lo stato configurato di una scheda Ethernet sintetica.

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

Sintassi

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SyntheticEthernetPortSettingData : CIM_EthernetPortAllocationSettingData
{
  string  InstanceID;
  string  Caption = "Virtual Ethernet Port Default Settings";
  string  Description = "Describes the default settings for the virtual Ethernet port resources.";
  string  ElementName;
  uint16  ResourceType = 10;
  string  OtherResourceType;
  string  ResourceSubType = "Microsoft:Hyper-V:Synthetic Ethernet Port";
  string  PoolID;
  uint16  ConsumerVisibility = 3;
  string  HostResource[];
  string  AllocationUnits = "count";
  uint64  VirtualQuantity = 1;
  uint64  Reservation = 1;
  uint64  Limit = 1;
  uint32  Weight = 0;
  boolean AutomaticAllocation = True;
  boolean AutomaticDeallocation = True;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  string  AddressOnParent;
  string  VirtualQuantityUnits = "count";
  uint16  DesiredVLANEndpointMode;
  string  OtherEndpointMode;
  string  VirtualSystemIdentifiers[];
  boolean DeviceNamingEnabled = FALSE;
  boolean AllowPacketDirect = FALSE;
  boolean StaticMacAddress = False;
  boolean ClusterMonitored = TRUE;
};

Members

La classe Msvm_SyntheticEthernetPortSettingData ha questi tipi di membri:

Proprietà

La classe Msvm_SyntheticEthernetPortSettingData ha queste proprietà.

Indirizzo

Tipo di dati: string

Tipo di accesso: sola lettura

Indirizzo della risorsa. Ad esempio, l'indirizzo MAC di una porta Ethernet. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

AddressOnParent

Tipo di dati: string

Tipo di accesso: sola lettura

Descrive l'indirizzo di questa risorsa nel contesto dell'elemento padre. Le proprietà Parent e AddressOnParent vengono usate per descrivere la relazione del controller e l'ordinamento dei dispositivi in un controller. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

AllocationUnits

Tipo di dati: string

Tipo di accesso: sola lettura

Unità di allocazione utilizzate dalle proprietà Reservation e Limit . Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

AllowPacketDirect

Tipo di dati: booleano

Tipo di accesso: lettura/scrittura

Indica se la proiezione PacketDirect è abilitata per la macchina virtuale.

Nota

Aggiunta in Windows 10 versione 1703 e Windows Server 2016.

AutomaticAllocation

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se la risorsa verrà allocata automaticamente. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

AutomaticDeallocation

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se la risorsa verrà deallocata automaticamente. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

Didascalia

Tipo di dati: string

Tipo di accesso: sola lettura

Breve descrizione dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedElement.

ClusterMonitored

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se questa scheda Ethernet viene monitorata da un cluster. Questa proprietà viene impostata su true se non configurata.

Si tratta di una proprietà di sola lettura, ma può essere modificata usando il metodo ModifyResourceSettings della classe Msvm_VirtualSystemManagementService .

Windows 8.1: questo valore non è supportato fino a Windows 8.1 e Windows Server 2012 R2.

Connection

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

L'elemento a cui è connessa questa risorsa. Ad esempio, una porta denominata network o switch. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

ConsumerVisibility

Tipo di dati: uint16

Tipo di accesso: sola lettura

Visibilità dei consumer sulla risorsa allocata. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData ed è sempre impostata su 3 (Virtualized).

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

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

DesiredVLANEndpointMode

Tipo di dati: uint16

Tipo di accesso: sola lettura

Modalità di configurazione desiderata per l'endpoint VLAN. Questa proprietà viene utilizzata per impostare il valore iniziale della proprietà OperationalEndpointMode nell'istanza della classe Msvm_VLANEndpoint associata alla porta Ethernet di destinazione. Per i valori possibili, vedere la proprietà OperationalEndpointMode della classe Msvm_VLANEndpoint . Questa proprietà viene ereditata da CIM_EthernetPortAllocationSettingData.

DeviceNamingEnabled

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se questa scheda Ethernet supporta la denominazione dei dispositivi.

Si tratta di una proprietà di sola lettura, ma può essere modificata usando il metodo ModifyVirtualSystemResources della classe Msvm_VirtualSystemManagementService .

Nota

Aggiunta in Windows 10 e Windows Server 2016.

ElementName

Tipo di dati: string

Tipo di accesso: sola lettura

Breve descrizione dell'oggetto. Questa proprietà viene ereditata da CIM_SettingData.

HostResource

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData e viene sempre impostata su Null.

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.

Limite

Tipo di dati: uint64

Tipo di accesso: sola lettura

Limite superiore o quantità massima di risorsa che verrà concessa per questa allocazione. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

MappingBehavior

Tipo di dati: uint16

Tipo di accesso: sola lettura

Specifica il mapping di questa risorsa alle risorse sottostanti. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

OtherEndpointMode

Tipo di dati: string

Tipo di accesso: sola lettura

Stringa che descrive il tipo di modello di endpoint VLAN supportato da questo endpoint VLAN. Questa proprietà viene utilizzata solo quando la proprietà DesiredVLANEndpointMode è impostata su 1 (Other). Questa proprietà deve essere impostata su Null quando la proprietà DesiredVLANEndpointMode è un valore diverso da 1. Questa proprietà viene ereditata da CIM_EthernetPortAllocationSettingData.

OtherResourceType

Tipo di dati: string

Tipo di accesso: sola lettura

Stringa che descrive il tipo di risorsa quando un valore ben definito non è disponibile e ResourceType è impostato su "Other" (0). Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData e non viene utilizzata.

Parent

Tipo di dati: string

Tipo di accesso: sola lettura

Elemento padre della risorsa. Ad esempio, un controller per l'allocazione corrente. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

PoolID

Tipo di dati: string

Tipo di accesso: sola lettura

Il pool da cui è attualmente allocata la risorsa o il pool da cui verrà allocata la risorsa quando si verifica l'allocazione. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

Prenotazione

Tipo di dati: uint64

Tipo di accesso: sola lettura

Quantità di risorsa garantita per questa allocazione. Nei sistemi che supportano l'over-commitment delle risorse, questo valore viene in genere usato per il controllo di ammissione per impedire l'accettazione di un'allocazione. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

ResourceSubType

Tipo di dati: string

Tipo di accesso: sola lettura

Stringa che descrive un sottotipo specifico di implementazione per questa risorsa. Ad esempio, può essere usato per distinguere modelli diversi dello stesso tipo di risorsa. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

ResourceType

Tipo di dati: uint16

Tipo di accesso: sola lettura

Tipo di risorsa a cui si applica questa impostazione. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData e viene sempre impostata su 10 (scheda Ethernet).

StaticMacAddress

Tipo di dati: booleano

Tipo di accesso: sola lettura

Specifica se l'indirizzo MAC è statico.

VirtualQuantity

Tipo di dati: uint64

Tipo di accesso: sola lettura

Quantità di risorse presentate al consumatore. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

VirtualQuantityUnits

Tipo di dati: string

Tipo di accesso: sola lettura

Specifica l'unità di misura per la proprietà VirtualQuantity . Il valore di questa proprietà deve essere un valore legale del qualificatore unità programmatice come definito nell'allegato C.1 di DSP0004 V2.5 o versione successiva. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

VirtualSystemIdentifiers

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Qualificatori: ArrayType ("Indexed")

Matrice di stringhe di identificatori di questa risorsa presentata al sistema operativo della macchina virtuale. Gli indici e i valori per indice vengono definiti per ogni risorsa, ovvero per ogni valore della proprietà ResourceType enumerato.

Weight

Tipo di dati: uint32

Tipo di accesso: sola lettura

Priorità relativa per questa allocazione in relazione ad altre allocazioni dello stesso pool di risorse. Questa proprietà viene ereditata da CIM_ResourceAllocationSettingData.

Commenti

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

CIM_ResourceAllocationSettingData