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
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 |
|
| Archivo DLL |
|
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de