Clase Msvm_MemorySettingData
Representa el estado configurado de la memoria de una máquina virtual.
La siguiente sintaxis es código de Managed Object Format (MOF) simplificado e incluye todas las propiedades heredadas.
Sintaxis
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_MemorySettingData : CIM_ResourceAllocationSettingData
{
string InstanceID;
string Caption = "Memory Default Settings";
string Description = "Describes the default settings for the memory resources.";
string ElementName;
uint16 ResourceType = 4;
string OtherResourceType;
string ResourceSubType = "Microsoft:Hyper-V:Memory";
string PoolID;
uint16 ConsumerVisibility;
string HostResource[];
boolean HugePagesEnabled;
string AllocationUnits = "byte * 2^20";
uint64 VirtualQuantity;
uint64 Reservation;
uint64 Limit;
uint32 Weight;
boolean AutomaticAllocation = True;
boolean AutomaticDeallocation = True;
string Parent;
string Connection[];
string Address;
uint16 MappingBehavior;
string AddressOnParent;
string VirtualQuantityUnits = "byte * 2^20";
boolean DynamicMemoryEnabled;
uint32 TargetMemoryBuffer;
boolean IsVirtualized = True;
boolean SwapFilesInUse;
uint64 MaxMemoryBlocksPerNumaNode;
uint64 SgxSize;
boolean SgxEnabled;
};
Miembros
La clase Msvm_MemorySettingData tiene estos tipos de miembros:
Propiedades
La clase Msvm_MemorySettingData 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. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
AddressOnParent
Tipo de datos: cadena
Tipo de acceso: solo lectura
Describe la dirección de este recurso en el contexto del elemento primario. Las propiedades Parent y AddressOnParent se usan para describir la relación del controlador, así como el orden de los dispositivos de un controlador. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
AllocationUnits
Tipo de datos: cadena
Tipo de acceso: solo lectura
Unidades de asignación usadas por las propiedades Reservation y Limit. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
AutomaticAllocation
Tipo de datos: booleano
Tipo de acceso: solo lectura
Indica si el recurso se asignará automáticamente. Por ejemplo, cuando esta propiedad se establece en True y la máquina virtual que consume está activada, se asignaría este recurso. Un valor False indica que el recurso debe asignarse explícitamente. Por ejemplo, la configuración puede representar medios extraíbles (como un CD-ROM o un disco de disquete) donde en el inicio el medio no está presente. Se requiere una operación explícita para asignar el recurso. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
AutomaticDeallocation
Tipo de datos: booleano
Tipo de acceso: solo lectura
Indica si el recurso se asignará automáticamente. Por ejemplo, cuando esta propiedad se establece en True y la máquina virtual que consume está activada, se asignaría este recurso. Cuando esta propiedad es False, el recurso debe asignarse explícitamente. Por ejemplo, la configuración puede representar medios extraíbles (como un CD-ROM o un disco de disquete) donde en el inicio el medio no está presente. Se requiere una operación explícita para asignar el recurso. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
Caption
Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (64)
Breve descripción del objeto. Esta propiedad se hereda de CIM_ManagedElement.
Conexión
Tipo de datos: matriz de cadena
Tipo de acceso: solo lectura
Dispositivo al que está conectado este recurso. Por ejemplo, un puerto de conmutador o una red con nombre. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
ConsumerVisibility
Tipo de datos: uint16
Tipo de acceso: solo lectura
Describe la visibilidad de los consumidores al recurso asignado. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
Descripción
Tipo de datos: cadena
Tipo de acceso: solo lectura
Descripción del objeto . Esta propiedad se hereda de CIM_ManagedElement.
DynamicMemoryEnabled
Tipo de datos: booleano
Tipo de acceso: solo lectura
Indica si la memoria dinámica está habilitada para la máquina virtual.
ElementName
Tipo de datos: cadena
Tipo de acceso: solo lectura
Nombre para mostrar del objeto. Esta propiedad se hereda de CIM_SettingData.
HostResource
Tipo de datos: matriz de cadena
Tipo de acceso: solo lectura
El primer elemento de esta matriz contiene una referencia al recurso host subyacente que se va a asignar. Esta propiedad se hereda de CIM_ResourceAllocationSettingData, pero no se usa.
HugePagesEnabled
Tipo de datos: booleano
Tipo de acceso: solo lectura
Indica si la memoria está respaldada o no por páginas de 1 GB.
InstanceID
Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: Key
Identifica de forma única una instancia de esta clase. Esta propiedad se hereda de CIM_ManagedElement.
IsVirtualized
Tipo de datos: booleano
Tipo de acceso: solo lectura
Indica si este dispositivo se virtualiza o es de paso a través. Cuando se establece en False, se usa el recurso subyacente o host. Al menos un elemento debe estar presente en la propiedad deviceID. Cuando se establece en True, el recurso se virtualiza y puede 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 host se exponen mediante la propiedad DeviceID. Esta propiedad siempre se establece en True.
Límite
Tipo de datos: uint64
Tipo de acceso: solo lectura
Cantidad máxima de memoria que puede consumir la máquina virtual. Para una máquina virtual con la memoria dinámica habilitada, representa la configuración de memoria máxima. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
MappingBehavior
Tipo de datos: uint16
Tipo de acceso: solo lectura
Especifica cómo se asigna este recurso a los recursos subyacentes. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
MaxMemoryBlocksPerNumaNode
Tipo de datos: uint64
Tipo de acceso: solo lectura
Cantidad máxima de memoria que se puede observar dentro de la máquina virtual como perteneciente a un único nodo NUMA.
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". Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
Parent
Tipo de datos: cadena
Tipo de acceso: solo lectura
Elemento primario del recurso. Por ejemplo, un controlador para la asignación actual. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
PoolID
Tipo de datos: cadena
Tipo de acceso: solo lectura
Identificador del grupo de recursos desde el que se asignó este recurso. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
Reserva
Tipo de datos: uint64
Tipo de acceso: solo lectura
Especifica la cantidad de memoria garantizada que está disponible para esta máquina virtual. Para una máquina virtual con la memoria dinámica habilitada, representa la configuración de memoria mínima. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
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. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
ResourceType
Tipo de datos: uint16
Tipo de acceso: solo lectura
Tipo de recurso que representa esta configuración de asignación. Esta propiedad se hereda de CIM_ResourceAllocationSettingData y siempre se establece en 4 (Memoria).
SgxEnabled
Tipo de datos: booleano
Tipo de acceso: solo lectura
Indica si SGX está habilitado.
Nota:
Esta propiedad se agregó en Windows 10, versión 1703.
SgxSize
Tipo de datos: uint64
Tipo de acceso: solo lectura
Cantidad de memoria SGX que se va a asignar para la máquina virtual, en MB.
Nota:
Esta propiedad se agregó en Windows 10, versión 1703.
SwapFilesInUse
Tipo de datos: booleano
Tipo de acceso: solo lectura
true si la paginación de segundo nivel está activa; de lo contrario, false.
TargetMemoryBuffer
Tipo de datos: uint32
Tipo de acceso: solo lectura
Define la cantidad de memoria adicional que se debe reservar para una máquina virtual en tiempo de ejecución, como porcentaje de la memoria total que se cree que necesita la máquina virtual. Esto solo se aplica a las máquinas virtuales con la memoria dinámica habilitada.
Esta propiedad puede estar en el intervalo comprendido entre 5 y 2000.
VirtualQuantity
Tipo de datos: uint64
Tipo de acceso: solo lectura
Cantidad total de RAM en la máquina virtual, tal como lo ve el sistema operativo invitado. Para una máquina virtual con memoria dinámica habilitada, representa la memoria inicial disponible en el inicio. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
VirtualQuantityUnits
Tipo de datos: cadena
Tipo de acceso: solo lectura
Especifica la unidad de medida para esta asignación de recursos. El valor de esta propiedad debe ser un valor legal del calificador Unidades de programación, tal como se define en el anexo C.1 de DSP0004 V2.5 o posterior. Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
Peso
Tipo de datos: uint32
Tipo de acceso: solo lectura
Define el valor de ponderación de asignación de memoria para cada máquina virtual. Una vez que se hayan cumplido todas las reservas, la memoria restante de la plataforma de hospedaje se asignará a las máquinas virtuales en función de sus ponderaciones relativas (no superar el valor especificado por la propiedad Limit). Esta propiedad se hereda de CIM_ResourceAllocationSettingData.
Comentarios
El filtrado de UAC puede restringir el acceso a la clase Msvm_MemorySettingData. Para obtener más información, vea Control de cuentas de usuario y WMI.
Ejemplos
function WaitForResult
{
param($result)
if ($result.ReturnValue -eq 4096)
{
while($true)
{
$result.Job
if ($result.Job -ne $null)
{
if ($result.Job.JobState -gt 4)
{
return $result.Job.ErrorCode
}
}
start-sleep 1
}
}
else
{
return $result.ReturnValue
}
}
if ($($args.count) -ne 2)
{
Write-Host "EnableHugePages.ps1 VMName SizeInMB"
return
}
$vmName = $args[0]
$sizeInMB = $args[1]
$namespace = "root\virtualization\v2"
$vm = Get-WmiObject -class MSVM_ComputerSystem -filter "ElementName='$vmName'" -namespace $namespace
$settings = Get-WmiObject -query "Associators of {$vm} where ResultClass = Msvm_VirtualSystemSettingData" -namespace $namespace
$vmSettings = $settings | ? VirtualSystemType -eq "Microsoft:Hyper-V:System:Realized"
$memorySettings = Get-WmiObject -query "Associators of {$vmSettings} where ResultClass = Msvm_MemorySettingData" -namespace $namespace
$memorySettings.MaxMemoryBlocksPerNumaNode = $sizeInMB
$memorySettings.Reservation = $sizeInMB
$memorySettings.Limit = $sizeInMB
$memorySettings.VirtualQuantity = $sizeInMB
$memorySettings.HugePagesEnabled = $True
$vmSvc = Get-WmiObject -class Msvm_VirtualSystemManagementService -namespace $namespace
$res = $vmSvc.ModifyResourceSettings($memorySettings.GetText(2))
if (WaitForResult($res) -ne 0)
{
Write-Host "Failed."
}
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo compatible |
Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2012 [solo aplicaciones de escritorio] |
| Espacio de nombres |
Root\Virtualization\V2 |
| MOF |
WindowsVirtualization.V2.mof |
| Archivo DLL |
Vmms.exe |