Clase Win32_LogicalDisk

La Win32_LogicalDiskclase WMI representa un origen de datos que se resuelve en un dispositivo de almacenamiento local real en un sistema informático que ejecuta Windows.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades se enumeran en orden alfabético, no en orden MOF.

Sintaxis

[Dynamic, Provider("CIMWin32"), SupportsUpdate, UUID("{8502C4B7-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_LogicalDisk : CIM_LogicalDisk
{
  uint16   Access;
  uint16   Availability;
  uint64   BlockSize;
  string   Caption;
  boolean  Compressed;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  uint32   DriveType;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   ErrorMethodology;
  string   FileSystem;
  uint64   FreeSpace;
  datetime InstallDate;
  uint32   LastErrorCode;
  uint32   MaximumComponentLength;
  uint32   MediaType;
  string   Name;
  uint64   NumberOfBlocks;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   ProviderName;
  string   Purpose;
  boolean  QuotasDisabled;
  boolean  QuotasIncomplete;
  boolean  QuotasRebuilding;
  uint64   Size;
  string   Status;
  uint16   StatusInfo;
  boolean  SupportsDiskQuotas;
  boolean  SupportsFileBasedCompression;
  string   SystemCreationClassName;
  string   SystemName;
  boolean  VolumeDirty;
  string   VolumeName;
  string   VolumeSerialNumber;
};

Miembros

La clase Win32_LogicalDisk tiene estos tipos de miembros:

• Métodos
• Propiedades

Métodos

La clase Win32_LogicalDisk tiene estos métodos.

Método	Descripción
Chkdsk	Invoca la operación Chkdsk en el disco.
ExcludeFromAutochk	Excluye los discos de la operación Chkdsk que se ejecutarán en el siguiente reinicio.
Reset	Sin implementar. Para obtener más información sobre cómo implementar este método, consulte el método Reset en CIM_LogicalDisk para obtener documentación.
ScheduleAutoChk	Programa Chkdsk para que se ejecute en el siguiente reinicio si se ha establecido el bit sucio.
SetPowerState	Sin implementar. Para obtener más información sobre cómo implementar este método, vea el método SetPowerState en CIM_LogicalDisk.

Propiedades

La clase Win32_LogicalDisk tiene estas propiedades.

Acceder

Tipo de datos: uint16

Tipo de acceso: solo lectura

Tipo de acceso multimedia disponible.

Esta propiedad se hereda de CIM_StorageExtent.

Desconocido (0)

Legible (1)

Grabable (2)

Editable

Lectura y escritura compatibles (3)

Escribir una vez (4)

Disponibilidad

Tipo de datos: uint16

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| Estado operativo|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Disponibilidad y estado del dispositivo.

Esta propiedad se hereda de CIM_LogicalDevice.

Otros (1)

Desconocido (2)

Corriente/potencia completa (3)

Ejecución o energía completa

Advertencia (4)

En prueba (5)

No aplicable (6)

Apagado (7)

Off Line (8)

Sin conexión

Off Duty (9)

Degradado (10)

No instalado (11)

Error de instalación (12)

Ahorro de energía : desconocido (13)

Se sabe que el dispositivo está en modo de ahorro de energía, pero su estado exacto es desconocido.

Ahorro de energía - Modo de bajo consumo (14)

El dispositivo está en un estado de ahorro de energía, pero sigue funcionando y puede mostrar un rendimiento degradado.

Ahorro de energía : en espera (15)

El dispositivo no funciona, pero se podría traer rápidamente a toda la potencia.

Ciclo de alimentación (16)

Ahorro de energía: advertencia (17)

El dispositivo está en un estado de advertencia, pero también en modo de ahorro de energía.

En pausa (18)

El dispositivo está en pausa.

No listo (19)

El dispositivo no está listo.

No configurado (20)

El dispositivo no está configurado.

En modo en modo incoado (21)

El dispositivo es silencioso.

BlockSize

Tipo de datos: uint64

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIB. IETF| HOST-RESOURCES-MIB.hrStorageAllocationUnits"), Unidades ("bytes")

Tamaño, en bytes, de los bloques que forman esta extensión de almacenamiento. Si se desconoce o si un concepto de bloque no es válido (por ejemplo, para extensiones de agregado, memoria o discos lógicos), escriba 1.

Esta propiedad se hereda de CIM_StorageExtent.

Para más información sobre el uso de valores uint64 en scripts, vea Scripting in WMI.

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (64), DisplayName ("Caption")

Descripción breve del objeto una cadena de una línea.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Compressed

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Funciones del sistema de archivos | GetVolumeInformation| FS_VOL_IS_COMPRESSED")

Si es True, el volumen lógico existe como una sola entidad comprimida, como un volumen DoubleSpace. Si se admite la compresión basada en archivos, como en NTFS, esta propiedad es False.

ConfigManagerErrorCode

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: Esquema ("Win32")

Código de error de Windows Configuration Manager.

Esta propiedad se hereda de CIM_LogicalDevice.

Este dispositivo funciona correctamente. (0)

El dispositivo funciona correctamente.

Este dispositivo no está configurado correctamente. (1)

El dispositivo no está configurado correctamente.

Windows no puede cargar el controlador para este dispositivo. (2)

Es posible que el controlador de este dispositivo esté dañado o que el sistema se esté ejecutando poco en memoria u otros recursos. (3)

Es posible que el controlador de este dispositivo esté dañado o que el sistema tenga poca memoria u otros recursos.

Este dispositivo no funciona correctamente. Uno de sus controladores o el registro podrían estar dañados. (4)

El dispositivo no funciona correctamente. Uno de sus controladores o el registro podrían estar dañados.

El controlador de este dispositivo necesita un recurso que Windows no puede administrar. (5)

El controlador para el dispositivo requiere un recurso que Windows no puede administrar.

La configuración de arranque de este dispositivo entra en conflicto con otros dispositivos. (6)

La configuración de arranque del dispositivo entra en conflicto con otros dispositivos.

No se puede filtrar. (7)

Falta el cargador de controladores para el dispositivo. (8)

Falta el cargador de controladores para el dispositivo.

Este dispositivo no funciona correctamente porque el firmware de control notifica los recursos del dispositivo incorrectamente. (9)

El dispositivo no funciona correctamente. El firmware de control informa incorrectamente de los recursos del dispositivo.

Este dispositivo no se puede iniciar. (10)

El dispositivo no se puede iniciar.

Error en este dispositivo. (11)

Error en el dispositivo.

Este dispositivo no encuentra suficientes recursos gratuitos que puede usar. (12)

El dispositivo no encuentra suficientes recursos gratuitos para usar.

Windows no puede comprobar los recursos de este dispositivo. (13)

Windows no puede comprobar los recursos del dispositivo.

Este dispositivo no puede funcionar correctamente hasta que reinicie el equipo. (14)

El dispositivo no puede funcionar correctamente hasta que se reinicie el equipo.

Este dispositivo no funciona correctamente porque probablemente haya un problema de volver a enumerar. (15)

El dispositivo no funciona correctamente debido a un posible problema de volver a enumerar.

Windows no puede identificar todos los recursos que usa este dispositivo. (16)

Windows no puede identificar todos los recursos que usa el dispositivo.

Este dispositivo solicita un tipo de recurso desconocido. (17)

El dispositivo solicita un tipo de recurso desconocido.

Vuelva a instalar los controladores de este dispositivo. (18)

Los controladores de dispositivo deben reinstalarse.

Error al usar el cargador de VxD. (19)

Es posible que el registro esté dañado. (20)

El registro puede estar dañado.

Error del sistema: intente cambiar el controlador de este dispositivo. Si eso no funciona, consulte la documentación de hardware. Windows está quitando este dispositivo. (21)

Error del sistema. Si cambiar el controlador de dispositivo no es eficaz, consulte la documentación de hardware. Windows está quitando el dispositivo.

Este dispositivo está deshabilitado. (22)

El dispositivo está deshabilitado.

Error del sistema: intente cambiar el controlador de este dispositivo. Si eso no funciona, consulte la documentación de hardware. (23)

Error del sistema. Si cambiar el controlador de dispositivo no es eficaz, consulte la documentación de hardware.

Este dispositivo no está presente, no funciona correctamente o no tiene instalados todos sus controladores. (24)

El dispositivo no está presente, no funciona correctamente o no tiene instalados todos sus controladores.

Windows sigue configurando este dispositivo. (25)

Windows sigue configurando el dispositivo.

Windows sigue configurando este dispositivo. (26)

Windows sigue configurando el dispositivo.

Este dispositivo no tiene una configuración de registro válida. (27)

El dispositivo no tiene una configuración de registro válida.

Los controladores de este dispositivo no están instalados. (28)

Los controladores de dispositivo no están instalados.

Este dispositivo está deshabilitado porque el firmware del dispositivo no le ha dado los recursos necesarios. (29)

El dispositivo está deshabilitado. El firmware del dispositivo no proporcionó los recursos necesarios.

Este dispositivo usa un recurso de solicitud de interrupción (IRQ) que usa otro dispositivo. (30)

El dispositivo usa un recurso IRQ que otro dispositivo está usando.

Este dispositivo no funciona correctamente porque Windows no puede cargar los controladores necesarios para este dispositivo. (31)

El dispositivo no funciona correctamente. Windows no puede cargar los controladores de dispositivo necesarios.

ConfigManagerUserConfig

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: Esquema ("Win32")

Si es True, el dispositivo usa una configuración definida por el usuario.

Esta propiedad se hereda de CIM_LogicalDevice.

CreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: CIM_Key

Nombre de la primera clase concreta que aparece en la cadena de herencia utilizada en la creación de una instancia. Cuando se usa con las demás propiedades clave de la clase , la propiedad permite identificar todas las instancias de esta clase y sus subclases.

Esta propiedad se hereda de CIM_LogicalDevice.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Descripción")

Descripción del objeto .

Esta propiedad se hereda de CIM_ManagedSystemElement.

Deviceid

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: Clave, Invalidación ("DeviceId"), MappingStrings ("WMI")

Identificador único del disco lógico de otros dispositivos del sistema.

Esta propiedad se hereda de CIM_LogicalDevice.

Para obtener un ejemplo de código que recupere esta propiedad, vea la sección Comentarios, a continuación.

DriveType

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| FileFunctions| GetDriveType")

Valor numérico que corresponde al tipo de unidad de disco que representa este disco lógico.

Desconocido (0)

Sin directorio raíz (1)

Disco extraíble (2)

Disco local (3)

Unidad de red (4)

Disco compacto (5)

Disco RAM (6)

ErrorCleared

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si es True, ahora se borra el error notificado en LastErrorCode .

Esta propiedad se hereda de CIM_LogicalDevice.

ErrorDescription

Tipo de datos: cadena

Tipo de acceso: solo lectura

Más información sobre el error registrado en LastErrorCode e información sobre las acciones correctivas que se pueden realizar.

Esta propiedad se hereda de CIM_LogicalDevice.

ErrorMethodology

Tipo de datos: cadena

Tipo de acceso: solo lectura

Tipo de detección y corrección de errores admitidos por esta extensión de almacenamiento.

Esta propiedad se hereda de CIM_StorageExtent.

Filesystem

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Funciones del sistema de archivosGetVolumeInformation)

Sistema de archivos en el disco lógico.

Ejemplo: "NTFS"

FreeSpace

Tipo de datos: uint64

Tipo de acceso: solo lectura

Calificadores: unidades ("bytes")

Espacio, en bytes, disponible en el disco lógico.

Esta propiedad se hereda de CIM_LogicalDisk.

Para más información sobre el uso de valores uint64 en scripts, vea Scripting in WMI.

InstallDate

Tipo de datos: datetime

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")

Fecha y hora en que se instaló el objeto. Esta propiedad no requiere un valor para indicar que el objeto está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

LastErrorCode

Tipo de datos: uint32

Tipo de acceso: solo lectura

Último código de error notificado por el dispositivo lógico.

Esta propiedad se hereda de CIM_LogicalDevice.

MaximumComponentLength

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Funciones del sistema de archivosGetVolumeInformation)

Longitud máxima de un componente de nombre de archivo admitido por la unidad de Windows. Un componente de nombre de archivo es esa parte de un nombre de archivo entre barras diagonales inversas. El valor se puede usar para indicar que el sistema de archivos especificado admite nombres largos. Por ejemplo, para un sistema de archivos FAT que admita nombres largos, la función almacena el valor 255, en lugar del indicador 8.3 anterior. Los nombres largos también se pueden admitir en sistemas que usan el sistema de archivos NTFS.

Ejemplo: 255

MediaType

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Funciones de entrada y salida de dispositivo | DeviceIoControl")

Tipo de medio presente actualmente en la unidad lógica. Este valor será uno de los valores de la enumeración MEDIA_TYPE definida en Winioctl.h. Es posible que el valor no sea exacto para las unidades extraíbles si actualmente no hay ningún medio en la unidad.

El formato es desconocido (0)

Disco de disquete de 5 pulgadas (1)

Disco de disquete de 5 1/4 pulgadas - 1,2 MB - 512 bytes/sector

Disco de disquete de 3 pulgadas (2)

Disco de disquete de 3 1/2 pulgadas: 1,44 MB -512 bytes/sector

Disco de disquete de 3 pulgadas (3)

Disco de disquete de 3 1/2 pulgadas - 2,88 MB - 512 bytes/sector

Disco de disquete de 3 pulgadas (4)

Disco de disquete de 3 1/2 pulgadas - 20,8 MB - 512 bytes/sector

Disco de disquete de 3 pulgadas (5)

Disco de disquete de 3 1/2 pulgadas - 720 KB - 512 bytes/sector

Disco de disquete de 5 pulgadas (6)

Disco de disquete de 5 1/4 pulgadas - 360 KB - 512 bytes/sector

Disco de disquete de 5 pulgadas (7)

Disco de disquete de 5 1/4 pulgadas - 320 KB - 512 bytes/sector

Disco disquete de 5 pulgadas (8)

Disco de disquete de 5 1/4 pulgadas - 320 KB - 1024 bytes/sector

Disco de disquete de 5 pulgadas (9)

Disco de disquete de 5 1/4 pulgadas - 180 KB - 512 bytes/sector

Disco disquete de 5 pulgadas (10)

Disco de disquete de 5 1/4 pulgadas - 160 KB - 512 bytes/sector

Medios extraíbles distintos de disquete (11)

Medios de disco duro fijos (12)

Disco de disquete de 3 pulgadas (13)

Disco de disquete de 3 1/2 pulgadas - 120 MB - 512 bytes/sector

Disco de disquete de 3 pulgadas (14)

Disco de disquete de 3 1/2 pulgadas - 640 KB - 512 bytes/sector

Disco disquete de 5 pulgadas (15)

Disco de disquete de 5 1/4 pulgadas - 640 KB - 512 bytes/sector

Disco de disquete de 5 pulgadas (16)

Disco de disquete de 5 1/4 pulgadas - 720 KB - 512 bytes/sector

Disco de disquete de 3 pulgadas (17)

Disco de disquete de 3 1/2 pulgadas - 1,2 MB - 512 bytes/sector

Disco de disquete de 3 pulgadas (18)

Disco de disquete de 3 1/2 pulgadas - 1,23 MB - 1024 bytes/sector

Disco de 5 pulgadas (19)

Disco de disquete de 5 1/4 pulgadas - 1,23 MB - 1024 bytes/sector

Disco de 3 pulgadas (20)

Disco de disquete de 3 1/2 pulgadas - 128 MB - 512 bytes/sector

Disco de 3 pulgadas (21)

Disco de disquete de 3 1/2 pulgadas - 230 MB - 512 bytes/sector

Disco de disquete de 8 pulgadas (22)

Disco de disquete de 8 pulgadas - 256 KB - 128 bytes/sector

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Name")

Etiqueta por la que se conoce el objeto. Cuando se subclase, esta propiedad se puede invalidar para que sea una propiedad de clave.

Esta propiedad se hereda de CIM_ManagedSystemElement.

NumberOfBlocks

Tipo de datos: uint64

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIB. IETF| HOST-RESOURCES-MIB.hrStorageSize")

Número total de bloques consecutivos, cada bloque el tamaño del valor contenido en la propiedad BlockSize , que forma esta extensión de almacenamiento. El tamaño total de la extensión de almacenamiento se puede calcular multiplicando el valor de la propiedad BlockSize por el valor de esta propiedad. Si el valor de BlockSize es 1, esta propiedad es el tamaño total de la extensión de almacenamiento.

Esta propiedad se hereda de CIM_StorageExtent.

Para más información sobre el uso de valores uint64 en scripts, vea Scripting in WMI.

PNPDeviceID

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: Esquema ("Win32")

Windows Plug and Play identificador de dispositivo del dispositivo lógico.

Esta propiedad se hereda de CIM_LogicalDevice.

Ejemplo: "*PNP030b"

PowerManagementCapabilities

Tipo de datos: matriz uint16

Tipo de acceso: solo lectura

Matriz de las funcionalidades específicas relacionadas con la energía de un dispositivo lógico.

Esta propiedad se hereda de CIM_LogicalDevice.

Desconocido (0)

No compatible (1)

Deshabilitado (2)

Habilitado (3)

Las características de administración de energía están habilitadas actualmente, pero el conjunto de características exacto es desconocido o la información no está disponible.

Modos de ahorro de energía introducidos automáticamente (4)

El dispositivo puede cambiar su estado de energía en función del uso u otros criterios.

Power State Settable (5)

Se admite el método SetPowerState . Este método se encuentra en la clase CIM_LogicalDevice primaria y se puede implementar. Para más información, vea Diseño de clases de formato de Managed Object Format (MOF).

Power Cycling Supported (6)

El método SetPowerState se puede invocar con el parámetro PowerState establecido en 5 (Ciclo de energía).

Encendido con tiempo admitido (7)

Se admiten Power-On con tiempo

El método SetPowerState se puede invocar con el parámetro PowerState establecido en 5 (Ciclo de energía) y Tiempo establecido en una fecha y hora específicas, o intervalo, para el encendido.

PowerManagementSupported

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si es True, el dispositivo se puede administrar con energía (se puede poner en modo de suspensión, etc.). Esta propiedad no indica que las características de administración de energía están habilitadas actualmente, solo que el dispositivo lógico es capaz de administrar energía.

Esta propiedad se hereda de CIM_LogicalDevice.

ProviderName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Funciones de red de Windows | WNetGetConnection")

Ruta de acceso de red al dispositivo lógico.

Propósito

Tipo de datos: cadena

Tipo de acceso: solo lectura

Cadena de forma libre que describe el medio y su uso.

Esta propiedad se hereda de CIM_StorageExtent.

QuotasDisabled

Tipo de datos: booleano

Tipo de acceso: solo lectura

Indica que la administración de cuotas no está habilitada (TRUE) en este sistema.

QuotasIncomplete

Tipo de datos: booleano

Tipo de acceso: solo lectura

Indica que se usó la administración de cuotas pero se ha deshabilitado (True). Incompleto hace referencia a la información que queda en el sistema de archivos después de deshabilitar la administración de cuotas.

QuotasRebuilding

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si es True, indica que el sistema de archivos está en el proceso activo de compilación de información y configura el disco para la administración de cuotas.

Tamaño

Tipo de datos: uint64

Tipo de acceso: solo lectura

Calificadores: unidades ("bytes")

Tamaño de la unidad de disco.

Esta propiedad se hereda de CIM_LogicalDisk.

Para obtener un ejemplo de código que recupera esta propiedad, vea la sección Comentarios, a continuación.

Estado

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (10), DisplayName ("Status")

Estado actual del objeto. Se pueden definir varios estados operativos y no operativos. Los estados operativos incluyen: "Ok", "Degradado" y "Pred Fail" (un elemento, como una unidad de disco duro habilitada para SMART, puede funcionar correctamente, pero predecir un error en un futuro próximo). Los estados no operativos incluyen: "Error", "Starting", "Stopping" y "Service". Este último, "Servicio", podría aplicarse durante la reestablecimiento de reflejo de un disco, la recarga de una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "CORRECTO" ni en uno de los otros estados.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son los siguientes:

Ok ("OK")

Error ("Error")

Degradado ("Degradado")

Desconocido ("Desconocido")

Pred Fail ("Pred Fail ")

Inicio ("Inicio")

Detención ("Detención ")

Servicio ("Servicio")

Estresado ("Estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Lost Comm ("Lost Comm")

StatusInfo

Tipo de datos: uint16

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| Estado operativo|003.3")

Estado del dispositivo lógico. Si esta propiedad no se aplica al dispositivo lógico, se debe usar el valor 5 (no aplicable).

Esta propiedad se hereda de CIM_LogicalDevice.

Otros (1)

Desconocido (2)

Habilitado (3)

Deshabilitado (4)

No aplicable (5)

SupportsDiskQuotas

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si es True, este volumen admite cuotas de disco.

SupportsFileBasedCompression

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Funciones del sistema de archivos | GetVolumeInformation| FS_FILE_COMPRESSION")

Si es True, la partición de disco lógico admite la compresión basada en archivos, como es el caso del sistema de archivos NTFS. Esta propiedad es False cuando la propiedad Compressed es True.

SystemCreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: propagados ("CIM_System. CreationClassName"), CIM_Key

Valor de la propiedad CreationClassName del equipo de ámbito.

Esta propiedad se hereda de CIM_LogicalDevice.

SystemName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: propagados ("CIM_System. Nombre"), CIM_Key

Nombre del sistema de ámbito.

Esta propiedad se hereda de CIM_LogicalDevice.

VolumeDirty

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("FSCTL_IS_VOLUME_DIRTY")

Si es True, el disco requiere que ChkDsk se ejecute en el siguiente reinicio. Esta propiedad solo es aplicable a esas instancias de disco lógico que representan un disco físico en la máquina. No es aplicable a las unidades lógicas asignadas.

VolumeName

Tipo de datos: cadena

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32API| Funciones del sistema de archivosGetVolumeInformation)

Nombre del volumen del disco lógico.

Restricciones: máximo de 32 caracteres.

Para obtener un ejemplo de código que recupera esta propiedad, vea la sección Comentarios, a continuación.

VolumeSerialNumber

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Funciones del sistema de archivosGetVolumeInformation)

Número de serie del volumen del disco lógico.

Restricciones: máximo de 11 caracteres.

Ejemplo: "A8C3-D032"

Comentarios

La clase Win32_LogicalDisk se deriva de CIM_LogicalDisk que se deriva de CIM_StorageExtent. La clase CIM_StorageExtent se deriva de CIM_LogicalDevice.

Una unidad de disco físico es la piedra angular de cualquier sistema de administración de almacenamiento. Sin embargo, después de instalar una unidad de disco físico, ni los usuarios ni los administradores del sistema suelen tratar directamente con el hardware. En su lugar, los usuarios y los administradores del sistema interactúan con las unidades lógicas que se han creado en el disco.

Una unidad lógica es una subdivisión de una partición a la que se le ha asignado su propia letra de unidad. (Es posible tener una partición a la que no se le haya asignado una letra de unidad). Cuando se habla de la unidad C o la unidad D, se hace referencia a una unidad lógica en lugar de a una unidad de disco física. Del mismo modo, al guardar un documento en la unidad E, se guarda en la unidad lógica. Los discos físicos componen el hardware que constituye una unidad, incluidos componentes como cabezales, sectores y cilindros. Las unidades lógicas, por el contrario, tienen propiedades como espacio en disco, espacio en disco disponible y letras de unidad.

Nota

La clase Win32_LogicalDisk solo se puede usar para enumerar las propiedades de las unidades de disco locales. Sin embargo, puede usar la clase Win32_MappedLogicalDisk para enumerar las propiedades de las unidades de red asignadas.

Ejemplos

Puede encontrar otros ejemplos mediante Win32_LogicalDisk para obtener datos de disco o volumen en el tema Tareas de WMI: Discos y sistemas de archivos .

El ejemplo de código vbScript del recuperador de información de WMI en la Galería de TechNet usa la clase Win32_LogicalDisk para recuperar información de hardware de varios equipos remotos.

La información obtener disco con wmi/cim... El ejemplo de código de PowerShell en la Galería de TechNet usa Win32_LogicalDisk para recuperar DeviceID, VolumeName y Size de un dispositivo de destino. En concreto, este ejemplo incluye un control riguroso de excepciones y devuelve un único objeto por equipo, en lugar de por disco.

El scripting empresarial suele implicar la configuración de hardware y software en equipos remotos; a su vez, esto requiere que sepa, de antemano, el tipo de unidades de disco instaladas en un equipo. Por ejemplo, un script que instala una aplicación en la unidad E solo funciona si la unidad E es un disco duro. Si la unidad E representa un disquete o una unidad de CD-ROM, se produce un error en el script. El código siguiente identifica las unidades y los tipos de unidad instalados en un equipo.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colDisks = objWMIService.ExecQuery ("SELECT * FROM Win32_LogicalDisk")
For Each objDisk in colDisks
 Wscript.Echo "DeviceID: "& objDisk.DeviceID 
 Select Case objDisk.DriveType
 Case 1
 Wscript.Echo "No root directory."
 Case 2
 Wscript.Echo "DriveType: Removable drive."
 Case 3
 Wscript.Echo "DriveType: Local hard disk."
 Case 4
 Wscript.Echo "DriveType: Network disk." 
 Case 5
 Wscript.Echo "DriveType: Compact disk." 
 Case 6
 Wscript.Echo "DriveType: RAM disk." 
 Case Else
 Wscript.Echo "Drive type could not be determined."
 End Select
Next

//be sure to References->Add->System.Management to your project
using System.Management;
...
{
   string strComputer = ".";
            
   ManagementScope namespaceScope = new ManagementScope("\\\\" + strComputer + "\\ROOT\\CIMV2");
   ObjectQuery diskQuery = new ObjectQuery("SELECT * FROM Win32_LogicalDisk");
   ManagementObjectSearcher mgmtObjSearcher = new ManagementObjectSearcher(namespaceScope, diskQuery);
   ManagementObjectCollection colDisks = mgmtObjSearcher.Get();

   foreach (ManagementObject objDisk in colDisks)
   {
      Console.WriteLine("Device ID : {0}", objDisk["DeviceID"]);
                
      switch ((uint)(objDisk["DriveType"]))
      {
         case 1: {   Console.WriteLine("No root directory.");
                     break;}
         case 2: {   Console.WriteLine("DriveType: Removable drive."); 
                     break;}
         case 3: {   Console.WriteLine("DriveType: Local hard disk.");
                     break;}
         case 4: {   Console.WriteLine("DriveType: Network disk.");
                     break;}
         case 5: {   Console.WriteLine("DriveType: Compact disk.");
                     break;}
         case 6: {   Console.WriteLine("DriveType: RAM disk.");
                     break;}
         default: {  Console.WriteLine("Drive type could not be determined.");
                     break;}
      }
      //Readline is in here so the user can see the result before the code exists
      Console.ReadLine();
   }
}

En los ejemplos siguientes se enumera el espacio libre en todas las unidades de disco duro de un equipo.

Const HARD_DISK = 3
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colDisks = objWMIService.ExecQuery ("SELECT * FROM Win32_LogicalDisk WHERE DriveType = " & HARD_DISK & "")
For Each objDisk in colDisks
 Wscript.Echo "Device ID: " & objDisk.DeviceID 
 Wscript.Echo "Free Disk Space: " & objDisk.FreeSpace
Next

//be sure to References->Add->System.Management to your project
using System.Management;
...

const int HARD_DISK = 3;
string strComputer = ".";

ManagementScope namespaceScope = new ManagementScope("\\\\" + strComputer + "\\ROOT\\CIMV2");
ObjectQuery diskQuery = new ObjectQuery("SELECT * FROM Win32_LogicalDisk WHERE DriveType = " + HARD_DISK + "");
ManagementObjectSearcher mgmtObjSearcher = new ManagementObjectSearcher(namespaceScope, diskQuery);
ManagementObjectCollection colDisks = mgmtObjSearcher.Get();

foreach (ManagementObject objDisk in colDisks)
{
    Console.WriteLine("Device ID : {0}", objDisk["DeviceID"]);
    Console.WriteLine("Free Disk Space : {0}", objDisk["FreeSpace"]);
    Console.ReadLine();
}

En el ejemplo de código siguiente se devuelve el tipo de sistema de archivos (FAT, NTFS, FAT32, etc.) que se usa en cada unidad de un equipo.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\Root\CIMv2")
Set colDisks = objWMIService.ExecQuery ("Select * from Win32_LogicalDisk")
For Each objDisk in colDisks
    Wscript.Echo "DeviceID: "& vbTab &  objDisk.DeviceID  
    Wscript.Echo "File System: "& vbTab & objDisk.FileSystem
Next

Get-WMIObject Win32_LogicalDisk | Select DeviceID, FileSystem | Format=Table -AutoSize

El siguiente ejemplo de código de PowerShell recupera información adicional sobre los discos locales lógicos.

Write-Host "Drive information for $env:ComputerName"

Get-WmiObject -Class Win32_LogicalDisk |
    Where-Object {$_.DriveType -ne 5} |
    Sort-Object -Property Name | 
    Select-Object Name, VolumeName, FileSystem, Description, VolumeDirty, `
        @{"Label"="DiskSize(GB)";"Expression"={"{0:N}" -f ($_.Size/1GB) -as [float]}}, `
        @{"Label"="FreeSpace(GB)";"Expression"={"{0:N}" -f ($_.FreeSpace/1GB) -as [float]}}, `
        @{"Label"="%Free";"Expression"={"{0:N}" -f ($_.FreeSpace/$_.Size*100) -as [float]}} |
    Format-Table -AutoSize

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMV2
MOF	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

CIM_LogicalDisk

Clases de hardware del sistema de equipos

Tareas de WMI: discos y sistemas de archivos