Msvm_GuestServiceInterfaceComponentSettingData class

Artículo
10/16/2023

Representa el estado configurado del componente de interfaz de servicio invitado. Esta clase se deriva de la clase CIM_ResourceAllocationSettingData.

La siguiente sintaxis se simplifica a partir del código MOF e incluye todas las propiedades heredadas.

Sintaxis

[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;
};

Miembros

La clase Msvm_GuestServiceInterfaceComponentSettingData tiene estos tipos de miembros:

Propiedades

Propiedades

La clase Msvm_GuestServiceInterfaceComponentSettingData tiene estas propiedades.

Dirección

Tipo de datos: cadena
Tipo de acceso: solo lectura

La dirección del recurso. Por ejemplo, la dirección MAC de un puerto Ethernet.

AllocationUnits

Tipo de datos: cadena
Tipo de acceso: solo lectura

Esta propiedad especifica las unidades de asignación usadas por las propiedades Reservation y Limit. Por ejemplo, cuando ResourceType=Processor, AllocationUnits puede establecerse en MHz. Cuando ResourceType=Memory, AllocationUnits se puede establecer en MB.

AutomaticAllocation

Tipo de datos: booleano
Tipo de acceso: solo lectura

Esta propiedad especifica si el recurso se asignará automáticamente. Por ejemplo, si se establece en true, se asignaría este recurso cuando el sistema de equipo virtual que consume esté encendido. Un valor false indica que el recurso debe asignarse explícitamente. Por ejemplo, la configuración puede representar medios extraíbles (es decir, CD-ROM o disquete) donde en el tiempo de encendido, el medio no está presente. Se requiere una operación explícita para asignar el recurso.

AutomaticDeallocation

Tipo de datos: booleano
Tipo de acceso: solo lectura

Esta propiedad especifica si el recurso se desasignará automáticamente. Por ejemplo, si se establece en true, se desasignaría este recurso cuando el sistema de equipo virtual que consume esté apagado. Cuando se establece en false, el recurso permanecerá asignado y se debe desasignar explícitamente.

Connection

Tipo de datos: matriz de cadena
Tipo de acceso: solo lectura

El elemento al que está conectado este recurso. Por ejemplo, un puerto de conmutador o una red con nombre.

ConsumerVisibility

Tipo de datos: uint16
Tipo de acceso: solo lectura

Describe la visibilidad de los consumidores al recurso asignado.

Valor	Significado
Unknown 0	desconocida.
Passed-Through 2	El recurso subyacente o host se utiliza y se pasa al consumidor, posiblemente mediante la creación de particiones. Al menos un elemento estará presente en la propiedad DeviceID.
Virtualized 3	El recurso está virtualizado y es posible que no se asigne directamente a un recurso subyacente o host. Algunas implementaciones pueden admitir una asignación específica para los recursos virtualizados, en cuyo caso los recursos de host se exponen mediante la propiedad DeviceID.
Not represented 4	No existe una representación del recurso en el contexto del consumidor de recursos.
DMTF reserved ..
Vendor Reserved 32767..65535

DefaultEnabledStatePolicy

Tipo de datos: uint16
Tipo de acceso: solo lectura

Los estados habilitados y deshabilitados de los servicios de comunicación de invitado predeterminados.

Se trata de una propiedad de solo lectura, pero se puede cambiar mediante el método ModifyResourceSettings de la clase Msvm_VirtualSystemManagementService.

Nota:

Se ha agregado en Windows 10.

Enabled (2)

Disabled (3)

ElementName

Tipo de datos: cadena
Tipo de acceso: solo lectura

Nombre para mostrar de esta instancia de SettingData. Además, el nombre para mostrar se puede usar como una propiedad de índice para una búsqueda o consulta. (Nota: El nombre no tiene que ser único en un espacio de nombres).

EnabledState

Tipo de datos: uint16
Tipo de acceso: solo lectura

Los estados habilitados y deshabilitados de un elemento.

Se trata de una propiedad de solo lectura, pero se puede cambiar mediante el método ModifyVirtualSystemResources (o ModifyResourceSettings en Windows 10 o posterior) de la clase Msvm_VirtualSystemManagementService.

Los valores válidos son:

Enabled (2)

Disabled (3)

HostResource

Tipo de datos: matriz de cadena
Tipo de acceso: solo lectura

Esta propiedad expone una asignación específica al host o a los recursos subyacentes. Las instancias incrustadas solo incluirán propiedades clave y se tratarán como rutas de acceso de objeto. Si el recurso virtual se puede programar en una serie de recursos subyacentes, esta propiedad debe permanecer NULL. En ese caso, las asociaciones DeviceAllocatedFromPool o ResourceAllocationFromPool se pueden usar para determinar el grupo de recursos de host en los que se puede programar este recurso virtual. Si se utiliza una asignación específica, todos los recursos subyacentes utilizados por este recurso virtual se mostrarán en esta matriz. Normalmente, la matriz incluirá un elemento, pero para las asignaciones agregadas, como varios procesadores, se pueden especificar varios recursos de host.

InstanceID

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: Key

Dentro del ámbito del espacio de nombres de creación de instancias, InstanceID identifica de forma opaca y única una instancia de esta clase. Para garantizar que sea único en el espacio de nombres, el valor de InstanceID debe crearse con el siguiente algoritmo "preferido": OrgID:LocalID, donde OrgID y LocalID se separan con dos puntos (:) y donde OrgID debe incluir un nombre de propiedad intelectual, una marca registrada o un nombre único que sea de propiedad de la entidad empresarial que está creando o definiendo InstanceID, o un identificador registrado asignado a la entidad empresarial por una autoridad global reconocida. (Este requisito es similar a la estructura SchemaName_ClassName de los nombres de clase de Schema). Además, para garantizar que sea único, OrgID no debe contener dos puntos (:). Al usar este algoritmo, los primeros dos puntos que aparecen en InstanceID deben aparecer entre OrgID y LocalID. La entidad empresarial elige LocalID y no se debe reutilizar para identificar diferentes elementos subyacentes (reales). Si no se usa el algoritmo "preferido" anterior, la entidad de definición debe asegurarse de que el InstanceID resultante no se reutilice en ningún InstanceID generado por este u otros proveedores para el espacio de nombres de esta instancia. En el caso de las instancias definidas por DMTF, el algoritmo "preferido" debe usarse con OrgID establecido en CIM.

Límite

Tipo de datos: uint64
Tipo de acceso: solo lectura

Esta propiedad especifica el límite superior o la cantidad máxima de recursos que se concederán para esta asignación. Por ejemplo, un sistema que admita la paginación de memoria puede admitir la configuración del límite de una asignación de memoria por debajo de VirtualQuantity, lo que obliga a que se produzca la paginación para esta asignación.

MappingBehavior

Tipo de datos: uint16
Tipo de acceso: solo lectura

Especifica cómo se asigna este recurso a los recursos subyacentes. Si la matriz HostResource contiene entradas, esta propiedad refleja cómo el recurso se asigna a esos recursos específicos.

Unknown (0)
Not Supported (1)
Dedicated (2)
Soft Affinity (3)
Hard Affinity (4)
DMTF Reserved (..)
Vendor Reserved (32767..65535)

OtherResourceType

Tipo de datos: cadena
Tipo de acceso: solo lectura

Cadena que describe el tipo de recurso cuando un valor bien definido no está disponible y ResourceType tiene el valor "Other".

Parent

Tipo de datos: cadena
Tipo de acceso: solo lectura

Elemento primario del recurso. Por ejemplo, un controlador para la asignación actual.

PoolID

Tipo de datos: cadena
Tipo de acceso: solo lectura

Esta propiedad especifica a qué ResourcePool se asigna actualmente el recurso, o a qué ResourcePool se asignará el recurso cuando se produzca la asignación.

Reserva

Tipo de datos: uint64
Tipo de acceso: solo lectura

Esta propiedad especifica la cantidad de recursos con disponibilidad garantizada para esta asignación. En el sistema que admite el exceso de compromiso de los recursos, este valor se usa normalmente para el control de admisión a fin de evitar que se acepte una asignación, lo que impide el agotamiento de los recursos.

ResourceSubType

Tipo de datos: cadena
Tipo de acceso: solo lectura

Cadena que describe un subtipo específico de implementación para este recurso. Por ejemplo, esto puede usarse para distinguir diferentes modelos del mismo tipo de recurso.

ResourceType

Tipo de datos: uint16
Tipo de acceso: solo lectura

El tipo de recurso que representa esta configuración de asignación.

Other (1)
Computer System (2)
Processor (3)
Memory (4)
IDE Controller (5)
Parallel SCSI HBAParallel SCSI HBA (6)
FC HBA (7)
iSCSI HBA (8)
IB HCA (9)
Ethernet Adapter (10)
Other Network Adapter (11)
I/O Slot (12)
I/O Device (13)
Floppy Drive (14)
CD Drive (15)
DVD drive (16)
Serial port (17)
Parallel port (18)
USB Controller (19)
Graphics controller (20)
Storage Extent (21)
Disk (22)
Tape (23)
Other storage device (24)
Firewire Controller (25)
Partitionable Unit (26)
Base Partitionable Unit (27)
Power Supply (28)
Cooling Device (29)
DMTF reserved (..)
Vendor Reserved (32767..65535)

VirtualQuantity

Tipo de datos: uint64
Tipo de acceso: solo lectura

Esta propiedad especifica la cantidad de recursos presentados al consumidor. Por ejemplo, cuando ResourceType=Processor, esta propiedad reflejaría el número de procesadores discretos presentados al sistema de equipos virtuales. Cuando ResourceType=Memory, esta propiedad podría reflejar el número de MB notificados al sistema de equipo virtual.

Peso

Tipo de datos: uint32
Tipo de acceso: solo lectura

Esta propiedad especifica una prioridad relativa para esta asignación en relación con otras asignaciones del mismo ResourcePool. Esta propiedad no tiene ninguna unidad de medida y solo es relevante en comparación con otras asignaciones que compiten por los mismos recursos de host.

Requisitos

Requisito	Valor
Cliente mínimo compatible	Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 R2 [solo aplicaciones de escritorio]
Espacio de nombres	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
Archivo DLL	Vmms.exe

Consulte también

CIM_ResourceAllocationSettingData
CIM_ResourceAllocationSettingData

Compartir a través de