classe Msvm_GuestServiceInterfaceComponentSettingData

Articolo
10/11/2023

Rappresenta lo stato configurato del componente dell'interfaccia del servizio guest. Questa classe deriva dalla classe CIM_ResourceAllocationSettingData.

La sintassi seguente è semplificata dal codice MOF e include tutte le proprietà ereditate.

Sintassi

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_GuestServiceInterfaceComponentSettingData : CIM_ResourceAllocationSettingData
{
  string  ElementName;
  string  InstanceID;
  uint16  ResourceType;
  string  OtherResourceType;
  string  ResourceSubType;
  string  PoolID;
  uint16  ConsumerVisibility;
  string  HostResource[];
  string  AllocationUnits;
  uint64  VirtualQuantity;
  uint64  Reservation;
  uint64  Limit;
  uint32  Weight;
  boolean AutomaticAllocation;
  boolean AutomaticDeallocation;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  uint16  EnabledState = 3;
  uint16  DefaultEnabledStatePolicy = 2;
};

Membri

La classe Msvm_GuestServiceInterfaceComponentSettingData ha questi tipi di membri:

Proprietà

Proprietà

La classe Msvm_GuestServiceInterfaceComponentSettingData 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.

AllocationUnits

Tipo di dati: string
Tipo di accesso: sola lettura

Questa proprietà specifica le unità di allocazione utilizzate dalle proprietà Reservation e Limit. Ad esempio, quando ResourceType=Processor, AllocationUnits può essere impostato su MHz. Quando ResourceType=Memory, AllocationUnits può essere impostato su MB

AutomaticAllocation

Tipo di dati: booleano
Tipo di accesso: sola lettura

Questa proprietà specifica se la risorsa verrà allocata automaticamente. Ad esempio, se impostato su true, quando il sistema di computer virtuale utilizzato è acceso, questa risorsa verrà allocata. Un valore false indica che la risorsa deve essere allocata in modo esplicito. Ad esempio, l'impostazione può rappresentare supporti rimovibili (ovvero cdrom o floppy) in cui in fase di accensione, il supporto non è presente. Per allocare la risorsa è necessaria un'operazione esplicita.

AutomaticDeallocation

Tipo di dati: booleano
Tipo di accesso: sola lettura

Questa proprietà specifica se la risorsa verrà deallocata automaticamente. Ad esempio, se impostato su true, quando il sistema di computer virtuale di utilizzo è spento, questa risorsa verrà deallocata. Se impostato su false, la risorsa rimarrà allocata e deve essere deallocata in modo esplicito.

Connessione

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.

ConsumerVisibility

Tipo di dati: uint16
Tipo di accesso: sola lettura

Descrive la visibilità dei consumer sulla risorsa allocata.

Valore	Significato
Unknown 0	Sconosciuto.
Pass-through 2	La risorsa sottostante o host viene usata e passata al consumer, possibilmente usando il partizionamento. Almeno un elemento deve essere presente nella proprietà DeviceID.
Virtualizzato 3	La risorsa viene virtualizzata e potrebbe non essere mappata direttamente a una risorsa sottostante/host. Alcune implementazioni possono supportare un'assegnazione specifica per le risorse virtualizzate, nel qual caso le risorse host vengono esposte usando la proprietà DeviceID.
Non rappresentato 4	Una rappresentazione della risorsa non esiste nel contesto del consumer di risorse.
DMTF riservato ..
Fornitore riservato 32767..65535

DefaultEnabledStatePolicy

Tipo di dati: uint16
Tipo di accesso: sola lettura

Stati abilitati e disabilitati dei servizi di comunicazione guest per impostazione predefinita.

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

Nota

Aggiunta in Windows 10.

Abilitato (2)

Disabilitato (3)

ElementName

Tipo di dati: string
Tipo di accesso: sola lettura

Nome visualizzato per questa istanza di SettingData. Inoltre, il nome visualizzato può essere usato come proprietà di indice per una ricerca o una query. Nota: il nome non deve essere univoco all'interno di uno spazio dei nomi.

EnabledState

Tipo di dati: uint16
Tipo di accesso: sola lettura

Stati abilitati e disabilitati di un elemento.

Si tratta di una proprietà di sola lettura, ma può essere modificata usando il metodo ModifyVirtualSystemResources (o ModifyResource Impostazioni in Windows 10 o versione successiva) della classe Msvm_VirtualSystemManagementService.

Valori validi:

Abilitato (2)

Disabilitato (3)

HostResource

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

Questa proprietà espone un'assegnazione specifica all'host o alle risorse sottostanti. Le istanze incorporate contengono solo le proprietà chiave e devono essere considerate come percorsi oggetto. Se la risorsa virtuale può essere pianificata in una serie di risorse sottostanti, questa proprietà deve rimanere NULL. In tal caso, è possibile usare le associazioni DeviceAllocatedFromPool o ResourceAllocationFromPool per determinare il pool di risorse host in cui è possibile pianificare questa risorsa virtuale. Se viene utilizzata un'assegnazione specifica, tutte le risorse sottostanti usate da questa risorsa virtuale devono essere elencate in questa matrice. In genere, la matrice conterrà un elemento, tuttavia per le allocazioni aggregate, ad esempio più processori, è possibile specificare più risorse host.

InstanceID

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Chiave

Nell'ambito dell'istanza dello spazio dei nomi, InstanceID identifica in modo opaco e univoco un'istanza di questa classe. Per garantire l'univocità all'interno di NameSpace, il valore di InstanceID deve essere costruito usando l'algoritmo "preferito" seguente: OrgID:LocalID Where OrgID e LocalID sono separati da due punti (:) e dove OrgID deve includere un copyright, un marchio registrato o un nome univoco di proprietà dell'entità aziendale che sta creando o definendo l'ID istanza o che è un ID registrato assegnato all'entità aziendale da un riconosciuto nome globale Autorità. Questo requisito è simile a Struttura SchemaName_ClassName dei nomi delle classi dello schema. Inoltre, per garantire l'univocità, OrgID non deve contenere due punti (:). Quando si usa questo algoritmo, i primi due punti da visualizzare in InstanceID devono essere visualizzati tra OrgID e LocalID. LocalID viene scelto dall'entità business e non deve essere riutilizzato per identificare diversi elementi sottostanti (reali). Se l'algoritmo "preferito" precedente non viene usato, l'entità di definizione deve garantire che l'ID istanza risultante non venga riutilizzato in tutti gli ID istanza prodotti da questo o da altri provider per NameSpace di questa istanza. Per le istanze definite da DMTF, l'algoritmo "preferito" deve essere usato con OrgID impostato su CIM.

Limite

Tipo di dati: uint64
Tipo di accesso: sola lettura

Questa proprietà specifica il limite superiore o la quantità massima di risorsa che verrà concessa per questa allocazione. Ad esempio, un sistema che supporta il paging della memoria può supportare l'impostazione del limite di un'allocazione di memoria inferiore a quella di VirtualQuantity, forzando così il paging per questa allocazione.

MappingBehavior

Tipo di dati: uint16
Tipo di accesso: sola lettura

Specifica il mapping di questa risorsa alle risorse sottostanti. Se la matrice HostResource contiene voci, questa proprietà riflette il mapping della risorsa a tali risorse specifiche.

Sconosciuto (0)
Non supportato (1)
Dedicato (2)
Affinità soft (3)
Affinità rigida (4)
DMTF riservato (..)
Fornitore riservato (32767...65535)

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 ha il valore "Other".

Parent

Tipo di dati: string
Tipo di accesso: sola lettura

Elemento padre della risorsa. Ad esempio, un controller per l'allocazione corrente.

PoolID

Tipo di dati: string
Tipo di accesso: sola lettura

Questa proprietà specifica da quale ResourcePool la risorsa è attualmente allocata o da quale ResourcePool la risorsa verrà allocata quando si verifica l'allocazione.

Prenotazione

Tipo di dati: uint64
Tipo di accesso: sola lettura

Questa proprietà specifica la quantità di risorsa garantita per questa allocazione. Nel sistema che supporta l'over-impegno delle risorse, questo valore viene in genere usato per il controllo di ammissione per impedire che un'allocazione venga accettata impedendo così l'esaurimento delle risorse.

ResourceSubType

Tipo di dati: string
Tipo di accesso: sola lettura

Stringa che descrive un sottotipo specifico di implementazione per questa risorsa. Ad esempio, questo può essere usato per distinguere modelli diversi dello stesso tipo di risorsa.

ResourceType

Tipo di dati: uint16
Tipo di accesso: sola lettura

Tipo di risorsa rappresentata da questa impostazione di allocazione.

Altro (1)
Computer System (2)
Processore (3)
Memoria (4)
Controller IDE (5)
HBA SCSI parallela (6)
FC HBA (7)
HBA iSCSI (8)
HCA IB (9)
Scheda Ethernet (10)
Altra scheda di rete (11)
Slot di I/O (12)
Dispositivo di I/O (13)
Unità floppy (14)
Unità CD (15)
Unità DVD (16)
Porta seriale (17)
Porta parallela (18)
Controller USB (19)
Controller grafico (20)
Archiviazione extent (21)
Disco (22)
Nastro (23)
Altro dispositivo di archiviazione (24)
Firewire Controller (25)
Unità partizionabile (26)
Unità partizionabile di base (27)
Alimentatore (28)
Dispositivo di raffreddamento (29)
DMTF riservato (..)
Fornitore riservato (32767...65535)

VirtualQuantity

Tipo di dati: uint64
Tipo di accesso: sola lettura

Questa proprietà specifica la quantità di risorse presentate al consumer. Ad esempio, quando ResourceType=Processor, questa proprietà riflette il numero di processori discreti presentati al sistema di computer virtuale. Quando ResourceType=Memory, questa proprietà potrebbe riflettere il numero di MB segnalati al sistema del computer virtuale.

Weight

Tipo di dati: uint32
Tipo di accesso: sola lettura

Questa proprietà specifica una priorità relativa per questa allocazione in relazione ad altre allocazioni dello stesso ResourcePool. Questa proprietà non ha unità di misura ed è rilevante solo se confrontata con altre allocazioni concorrenti per le stesse risorse host.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1 [solo app desktop]
Server minimo supportato	Windows Server 2012 R2 [solo app desktop]
Spazio dei nomi	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Vedi anche

CIM_ResourceAllocationSettingData
CIM_ResourceAllocationSettingData

Condividi tramite