Clase Msvm_DiskDrive

Representa una unidad de disco duro dentro de una máquina virtual. Esta unidad de disco duro puede ser un dispositivo de paso a través (si se ha conectado un disco duro físico a la máquina virtual) o un dispositivo sintético que se rellena con medios de disco duro virtual. Dado que se pueden agregar y quitar discos duros virtuales y físicos de la máquina virtual, hay dos grupos de recursos asociados a esta clase, uno para discos duros de paso a través y el otro para discos duros virtuales. Los discos duros solo se pueden agregar o quitar del controlador SCSI virtual cuando la máquina virtual está en línea. Los discos solo se pueden agregar o quitar del controlador IDE virtual cuando la máquina virtual está sin conexión.

La sintaxis siguiente es código de Formato de objeto administrado (MOF) simplificado e incluye todas las propiedades heredadas.

Sintaxis

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_DiskDrive : CIM_DiskDrive
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   CreationClassName;
  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[] = { 6 };
  uint64   MaxQuiesceTime;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  string   ErrorMethodology = "None";
  string   CompressionMethod = "Not Compressed";
  uint32   NumberOfMediaSupported = 1;
  uint64   MaxMediaSize = 2000000000;
  uint64   DefaultBlockSize = 512;
  uint64   MaxBlockSize;
  uint64   MinBlockSize = 512;
  boolean  NeedsCleaning = False;
  boolean  MediaIsLocked = True;
  uint16   Security = 3;
  datetime LastCleaned;
  uint64   MaxAccessTime = 0;
  uint32   UncompressedDataRate;
  uint64   LoadTime = 0;
  uint64   UnloadTime = 0;
  uint64   MountCount = 0;
  datetime TimeOfLastMount;
  uint64   TotalMountTime = 0;
  string   UnitsDescription;
  uint64   MaxUnitsBeforeCleaning = 0xffffffffffffffff;
  uint64   UnitsUsed = 0;
  uint32   DriveNumber;
};

Miembros

La clase Msvm_DiskDrive tiene estos tipos de miembros:

• Métodos
• Propiedades

Métodos

La clase Msvm_DiskDrive tiene estos métodos.

Método	Descripción
EnableDevice	No se admite este método.
LockMedia	Bloquea o libera el medio.
OnlineDevice	No se admite este método.
QuiesceDevice	No se admite este método.
RequestStateChange	Solicita un cambio de estado.
Restablecer	Restablece el dispositivo virtual.
RestoreProperties	No se admite este método.
SaveProperties	No se admite este método.
SetPowerState	No se admite este método.

Propiedades

La clase Msvm_DiskDrive tiene estas propiedades.

AdditionalAvailability

Tipo de datos: matriz uint16

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_LogicalDevice y se establece en 6 (no aplicable).

Disponibilidad

Tipo de datos: uint16

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_LogicalDevice.

AvailableRequestedStates

Tipo de datos: matriz uint16

Tipo de acceso: solo lectura

Indica los valores posibles para el parámetro RequestedState del método RequestStateChange . Esta propiedad se hereda de CIM_EnabledLogicalElement.

Capabilities

Tipo de datos: matriz uint16

Tipo de acceso: solo lectura

Funcionalidades del dispositivo de acceso multimedia. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en los valores siguientes.

Valor	Significado
3	La entrada correspondiente en CapabilityDescriptions es "Acceso aleatorio".
4	La entrada correspondiente en CapabilityDescriptions es "Admite escritura".

CapabilityDescriptions

Tipo de datos: matriz de cadenas

Tipo de acceso: solo lectura

Matriz de cadenas de forma libre que proporciona explicaciones detalladas sobre las características del dispositivo de acceso indicadas en la matriz de propiedades Capabilities . Cada entrada de esta matriz está relacionada con la entrada de la matriz de propiedades Capabilities , ubicada en el mismo índice. Esta propiedad se hereda de CIM_MediaAccessDevice.

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

Descripción breve del objeto. Esta propiedad se hereda de CIM_ManagedElement.

CommunicationStatus

Tipo de datos: uint16

Tipo de acceso: solo lectura

Indica la capacidad de la instrumentación para comunicarse con el elemento administrado subyacente. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

Desconocido (0)

No disponible (1)

Comunicación correcta (2)

Comunicación perdida (3)

Sin contacto (4)

DMTF Reserved (..)

Proveedor reservado (0x8000.. )

CompressionMethod

Tipo de datos: cadena

Tipo de acceso: solo lectura

Cadena que indica el algoritmo o herramienta que se usa para comprimir el archivo lógico. Si el esquema de compresión es desconocido o no se describe, use "Unknown". Si el archivo lógico está comprimido, pero el esquema de compresión es desconocido o no se describe, use "Comprimido". Si el archivo lógico no está comprimido, use "Not Compressed". Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en "Not Compressed".

CreationClassName

Tipo de datos: uint16

Tipo de acceso: solo lectura

Nombre de la clase o subclase usada en la creación de una instancia. Esta propiedad se hereda de CIM_LogicalDevice.

DefaultBlockSize

Tipo de datos: uint64

Tipo de acceso: solo lectura

Tamaño de bloque predeterminado, en bytes, para el dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en 512.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Descripción del objeto. Esta propiedad se hereda de CIM_ManagedElement.

DetailedStatus

Tipo de datos: uint16

Tipo de acceso: solo lectura

Complementa la propiedad PrimaryStatus con detalles de estado adicionales. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

No disponible (0)

Sin información adicional (1)

Estresado (2)

Error predictivo (3)

Error no recuperable (4)

Entidad auxiliar en error (5)

DMTF Reserved (..)

Proveedor reservado (0x8000.. )

Deviceid

Tipo de datos: cadena

Tipo de acceso: solo lectura

Una dirección u otra información de identificación para asignar un nombre único al dispositivo lógico. Esta propiedad se hereda de CIM_LogicalDevice.

DriveNumber

Tipo de datos: uint32

Tipo de acceso: solo lectura

Número de unidades físicas en el sistema de equipo host.

ElementName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Nombre para mostrar del objeto. Esta propiedad se hereda de CIM_ManagedElement.

EnabledDefault

Tipo de datos: uint16

Tipo de acceso: solo lectura

Configuración predeterminada o de inicio de un administrador para el estado habilitado de un elemento. Esta propiedad se hereda de CIM_EnabledLogicalElement.

EnabledState

Tipo de datos: uint16

Tipo de acceso: solo lectura

Estados habilitados y deshabilitados de un elemento. También puede indicar las transiciones entre estos estados solicitados. Esta propiedad se hereda de CIM_EnabledLogicalElement.

Valor	Significado
Unknown 0	No se pudo determinar el estado del elemento.
Otros 1
Enabled 2	El elemento se está ejecutando.
Deshabilitada 3	El elemento está desactivado.
Cerrando 4	El elemento está en proceso de ir a un estado Deshabilitado.
No aplicable 5	El elemento no admite la habilitación o deshabilitación.
Habilitado pero sin conexión 6	El elemento puede estar completando comandos y quitará las nuevas solicitudes.
En prueba 7	El elemento está en un estado de prueba.
Diferido 8	El elemento puede estar completando comandos, pero pondrá en cola las nuevas solicitudes.
Modo de inactividad 9	El elemento está habilitado, pero está en modo restringido. El comportamiento del elemento es similar al estado Enabled (2), pero solo procesa un conjunto restringido de comandos. Todas las demás solicitudes se ponen en cola.
Starting (iniciándose) 10	El elemento está en proceso de ir a un estado Enabled (2). Las nuevas solicitudes se ponen en cola.

ErrorCleared

Tipo de datos: booleano

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

ErrorDescription

Tipo de datos: cadena

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

ErrorMethodology

Tipo de datos: cadena

Tipo de acceso: solo lectura

Cadena que describe los tipos de detección y corrección de errores admitidos por este dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en "None".

HealthState

Tipo de datos: uint16

Tipo de acceso: solo lectura

Estado actual del elemento. Este atributo expresa el estado de este elemento, pero no necesariamente el de sus subcomponentes. Los valores posibles son de 0 a 30, donde 5 significa que el elemento es completamente correcto y 30 significa que el elemento no funciona completamente. Esta propiedad se hereda de CIM_ManagedSystemElement y siempre se establece en 5.

IdentifyingDescriptions

Tipo de datos: matriz de cadenas

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_LogicalDevice y se establece en Null.

InstallDate

Tipo de datos: datetime

Tipo de acceso: solo lectura

Fecha y hora en que se creó la configuración de la máquina virtual. Esta propiedad se hereda de CIM_ManagedSystemElement.

InstanceID

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: Clave

Identifica de forma única una instancia de esta clase. Esta propiedad se hereda de CIM_ManagedElement.

LastCleaned

Tipo de datos: datetime

Tipo de acceso: solo lectura

Fecha y hora en que se limpió por última vez el dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en Null.

LastErrorCode

Tipo de datos: uint32

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

LoadTime

Tipo de datos: uint64

Tipo de acceso: solo lectura

Tiempo, en milisegundos, desde la carga hasta poder leer o escribir un medio. Por ejemplo, para las unidades de disco, este es el intervalo entre un disco que no gira en el disco que informa de que está listo para lectura y escritura (es decir, el disco gira a velocidades nominales). En el caso de las unidades de cinta, este es el momento de insertar un medio para informar de que está listo para una aplicación. Esto suele estar en el área BOT de la cinta. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en 0.

MaxAccessTime

Tipo de datos: uint64

Tipo de acceso: solo lectura

La hora, en milisegundos, para pasar de la primera ubicación del medio a la ubicación más lejana con respecto al tiempo. Para una unidad de disco, esto representa la búsqueda completa y el retraso de rotación completa. En el caso de las unidades de cinta, representa una búsqueda desde el principio de la cinta hasta el punto más distante físicamente. (El final de una cinta puede estar en su punto más lejano físicamente, pero esto no es necesariamente cierto). Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en 0.

MaxBlockSize

Tipo de datos: uint64

Tipo de acceso: solo lectura

Tamaño máximo de bloque, en bytes, para los medios a los que accede el dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en 512 para las unidades de disco duro virtual, variable para las unidades de paso a través.

MaxMediaSize

Tipo de datos: uint64

Tipo de acceso: solo lectura

Tamaño máximo, en kilobytes, de medios admitidos por este dispositivo. Los kilobytes se interpretan como el número de bytes multiplicados por 1000 (no el número de bytes multiplicados por 1024). Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en 2000 000 000 para unidades de disco duro virtual, variable para unidades de paso a través.

MaxQuiesceTime

Tipo de datos: uint64

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

MaxUnitsBeforeCleaning

Tipo de datos: uint64

Tipo de acceso: solo lectura

Unidades máximas que se pueden usar antes de limpiar el dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en 0xffffffffffffffff.

MediaIsLocked

Tipo de datos: booleano

Tipo de acceso: solo lectura

True si el medio está bloqueado en el dispositivo y no se puede expulsar; de lo contrario, False. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en True.

MinBlockSize

Tipo de datos: uint64

Tipo de acceso: solo lectura

Tamaño mínimo de bloque, en bytes, para los medios a los que accede el dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en 512.

MountCount

Tipo de datos: uint64

Tipo de acceso: solo lectura

En el caso de un dispositivo que admita medios extraíbles, el número de veces que los medios se han montado para la transferencia de datos o para limpiar el dispositivo. Para los dispositivos que acceden a medios no extraíbles, como los discos duros, esta propiedad no es aplicable y debe establecerse en 0. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en 0.

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

Etiqueta por la que se conoce el objeto. Esta propiedad se hereda de CIM_ManagedSystemElement.

NeedsCleaning

Tipo de datos: booleano

Tipo de acceso: solo lectura

True si el dispositivo de acceso multimedia necesita limpieza; de lo contrario, False. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en False.

NumberOfMediaSupported

Tipo de datos: uint32

Tipo de acceso: solo lectura

Número máximo de varios medios individuales que se pueden admitir o insertar. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en 1.

OperatingStatus

Tipo de datos: uint16

Tipo de acceso: solo lectura

Proporciona información de estado actual para la condición operativa del elemento y se puede usar para proporcionar más detalles con respecto al valor de la propiedad EnabledState . Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

Desconocido (0)

No disponible (1)

Mantenimiento (2)

A partir de (3)

Detención (4)

Detenido (5)

Anulado (6)

Inactivo (7)

Completado (8)

Migración (9)

Migración (10)

Migración (11)

Instantáneas (12)

Apagado (13)

En prueba (14)

Transición (15)

En servicio (16)

DMTF Reserved (..)

Vendor Reserved (0x8000.. )

OperationalStatus

Tipo de datos: matriz uint16

Tipo de acceso: solo lectura

Estados actuales del objeto . Esta propiedad se hereda de CIM_ManagedSystemElement.

OtherEnabledState

Tipo de datos: cadena

Tipo de acceso: solo lectura

Estado habilitado o deshabilitado del elemento cuando la propiedad EnabledState está establecida en 1 (Other). Esta propiedad debe establecerse en Null cuando EnabledState es cualquier valor distinto de 1. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en Null.

OtherIdentifyingInfo

Tipo de datos: matriz de cadenas

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_LogicalDevice y se establece en Null.

PowerManagementCapabilities

Tipo de datos: matriz uint16

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

PowerManagementSupported

Tipo de datos: booleano

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

PowerOnHours

Tipo de datos: uint64

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

PrimaryStatus

Tipo de datos: uint16

Tipo de acceso: solo lectura

Proporciona información de estado de alto nivel. Esta propiedad se debe usar junto con la propiedad DetailedStatus para proporcionar un estado de mantenimiento alto y detallado del elemento y sus subcomponentes. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

Desconocido (0)

Correcto (1)

Degradado (2)

Error (3)

DMTF Reserved (..)

Vendor Reserved (0x8000.. )

RequestedState

Tipo de datos: uint16

Tipo de acceso: solo lectura

El último estado solicitado o deseado para el elemento. El estado real del elemento se representa mediante EnabledState. Esta propiedad se proporciona para comparar los últimos estados solicitados y habilitados o deshabilitados actuales. Es posible que una instancia determinada de CIM_EnabledLogicalElement no admita el método RequestStateChange . Si esto ocurre, se usa el valor 12 (no aplicable). Esta propiedad se hereda de CIM_EnabledLogicalElement.

Seguridad

Tipo de datos: uint16

Tipo de acceso: solo lectura

La seguridad operativa definida para el dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en 3 (None).

Estado

Tipo de datos: cadena

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_ManagedSystemElement, pero no se usa.

StatusDescriptions

Tipo de datos: matriz de cadenas

Tipo de acceso: solo lectura

Cadenas que describen los distintos valores de matriz OperationalStatus . Esta propiedad se hereda de CIM_ManagedSystemElement.

StatusInfo

Tipo de datos: uint16

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

SystemCreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Nombre de clase de creación del sistema de ámbito. Esta propiedad se hereda de CIM_LogicalDevice.

SystemName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Identificador único de la máquina virtual de ámbito. Esta propiedad se hereda de CIM_LogicalDevice.

TimeOfLastMount

Tipo de datos: datetime

Tipo de acceso: solo lectura

En el caso de un dispositivo que admita medios extraíbles, la fecha y hora más recientes en que se montó el medio en el dispositivo. Para los dispositivos que acceden a medios no extraíbles, como los discos duros, esta propiedad no tiene ningún significado y no es aplicable. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en Null.

TimeOfLastStateChange

Tipo de datos: datetime

Tipo de acceso: solo lectura

Fecha u hora en que el estado habilitado del elemento cambió por última vez. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en "NULL".

TotalMountTime

Tipo de datos: uint64

Tipo de acceso: solo lectura

Para un dispositivo que admite medios extraíbles, el tiempo total (en segundos) que los medios se han montado para la transferencia de datos o para limpiar el dispositivo. Para los dispositivos que acceden a medios no extraíbles, como los discos duros, esta propiedad no es aplicable y debe establecerse en 0. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en 0.

TotalPowerOnHours

Tipo de datos: uint64

Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

TransitioningToState

Tipo de datos: uint16

Tipo de acceso: solo lectura

Indica el estado de destino al que se está realizando la transición de la instancia. Esta propiedad se hereda de CIM_EnabledLogicalElement.

UncompressedDataRate

Tipo de datos: uint32

Tipo de acceso: solo lectura

Velocidad de transferencia de datos sostenida en KB/s que el dispositivo puede leer y escribir en un medio. Se trata de una tasa de datos sin procesar sostenida. No se deben notificar las tasas máximas ni las tasas suponiendo que la compresión se notifique en esta propiedad. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en Null.

UnitsDescription

Tipo de datos: cadena

Tipo de acceso: solo lectura

Unidades relativas a su uso en MaxUnitsBeforeCleaning. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en Null.

UnitsUsed

Tipo de datos: uint64

Tipo de acceso: solo lectura

Número actual de unidades usadas. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en 0.

UnloadTime

Tipo de datos: uint64

Tipo de acceso: solo lectura

La hora, en milisegundos, de poder leer o escribir un medio en su descarga. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en 0.

Comentarios

El acceso a la clase Msvm_DiskDrive podría estar restringido por el filtrado de UAC. Para obtener más información, vea Control de cuentas de usuario y WMI.

Requisitos

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

Consulte también

CIM_DiskDrive

CIM_DiskDrive

Clases de almacenamiento