CIM_DataFile clase
La clase CIM_DataFile representa una colección con nombre de datos o código ejecutable. Solo se devolverán instancias de archivos en discos fijos locales.
Importante
Las clases CIM (Grupo de tareas de administración distribuida) DMTF (Common Information Model) son las clases primarias en las que se compilan las clases WMI. WMI actualmente solo admite los esquemas de versión cim 2.x.
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"), UUID("{8502C55A-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("All Files (CIM)"), AMENDMENT]
class CIM_DataFile : CIM_LogicalFile
{
string Caption;
string Description;
datetime InstallDate;
string Status;
uint32 AccessMask;
boolean Archive;
boolean Compressed;
string CompressionMethod;
string CreationClassName;
datetime CreationDate;
string CSCreationClassName;
string CSName;
string Drive;
string EightDotThreeFileName;
boolean Encrypted;
string EncryptionMethod;
string Name;
string Extension;
string FileName;
uint64 FileSize;
string FileType;
string FSCreationClassName;
string FSName;
boolean Hidden;
uint64 InUseCount;
datetime LastAccessed;
datetime LastModified;
string Path;
boolean Readable;
boolean System;
boolean Writeable;
string Manufacturer;
string Version;
};
Miembros
La clase CIM_DataFile tiene estos tipos de miembros:
Métodos
La clase CIM_DataFile tiene estos métodos.
| Método | Descripción |
|---|---|
| ChangeSecurityPermissions | Cambia los permisos de seguridad para el archivo lógico especificado en la ruta de acceso del objeto. Implementado por WMI. |
| ChangeSecurityPermissionsEx | Cambia los permisos de seguridad para el archivo lógico especificado en la ruta de acceso del objeto. Implementado por WMI. |
| Comprimir | Usa la compresión NTFS para comprimir el archivo lógico (o directorio) especificado en la ruta de acceso del objeto. Implementado por WMI. |
| CompressEx | Comprime el archivo lógico (o directorio) especificado en la ruta de acceso del objeto. Implementado por WMI. |
| Copiar | Copia el archivo lógico (o directorio) especificado en la ruta de acceso del objeto a la ubicación especificada por el parámetro de entrada. Implementado por WMI. |
| CopyEx | Copia el archivo lógico (o directorio) especificado en la ruta de acceso del objeto a la ubicación especificada por el parámetro de entrada. Implementado por WMI. |
| Eliminar | Elimina el archivo lógico (o directorio) especificado en la ruta de acceso del objeto. Implementado por WMI. |
| DeleteEx | Elimina el archivo lógico (o directorio) especificado en la ruta de acceso del objeto. Implementado por WMI. |
| GetEffectivePermission | Determina si el autor de la llamada tiene los permisos agregados especificados por el argumento Permission . Implementado por WMI. |
| Cambiar nombre | Cambia el nombre del archivo lógico (o directorio) especificado en la ruta de acceso del objeto. Implementado por WMI. |
| TakeOwnerShip | Obtiene la propiedad del archivo lógico especificado en la ruta de acceso del objeto. Implementado por WMI. |
| TakeOwnerShipEx | Obtiene la propiedad del archivo lógico especificado en la ruta de acceso del objeto. Implementado por WMI. |
| Descomprimir | Descomprime el archivo lógico (o directorio) especificado en la ruta de acceso del objeto. Implementado por WMI. |
| UncompressEx | Descomprime el archivo lógico (o directorio) especificado en la ruta de acceso del objeto. Implementado por WMI. |
Propiedades
La clase CIM_DataFile tiene estas propiedades.
-
AccessMask
-
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Derechos de acceso")
Máscara de bits que representa los derechos de acceso necesarios para acceder o realizar operaciones específicas en el archivo. Para obtener valores de bits, consulte Constantes de derechos de acceso a archivos y directorios.
Nota
En los volúmenes FAT, se devuelve el valor FULL_ACCESS en su lugar, lo que indica que no se ha establecido ninguna seguridad en el objeto .
Esta propiedad se hereda de CIM_LogicalFile.
-
-
FILE_READ_DATA (archivo) o FILE_LIST_DIRECTORY (directorio) ( 1)
-
FILE_WRITE_DATA (archivo) o FILE_ADD_FILE (directorio) ( 2)
-
FILE_APPEND_DATA (archivo) o FILE_ADD_SUBDIRECTORY (directorio) (4)
-
FILE_READ_EA (8)
-
FILE_WRITE_EA (16)
-
FILE_EXECUTE (archivo) o FILE_TRAVERSE (directorio) ( 32)
-
FILE_DELETE_CHILD (directorio) (64)
-
FILE_READ_ATTRIBUTES (128)
-
FILE_WRITE_ATTRIBUTES (256)
-
DELETE (65536)
-
READ_CONTROL (131072)
-
WRITE_DAC (262144)
-
WRITE_OWNER (524288)
-
SYNCHRONIZE (1048576)
Archivar
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: Schema ("Win32"), DisplayName ("Should Be Archived")
Si es True, se debe archivar el archivo.
Esta propiedad se hereda de CIM_LogicalFile.
Caption
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen (64), DisplayName ("Caption")
Descripción textual breve del objeto.
Esta propiedad se hereda de CIM_ManagedSystemElement.
Compressed
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Comprimido")
Si es True, el archivo se comprime.
Esta propiedad se hereda de CIM_LogicalFile.
CompressionMethod
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Método de compresión")
Cadena de forma libre que indica el algoritmo o la 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_LogicalFile.
CreationClassName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: CIM_Key, DisplayName ("Nombre de clase")
Nombre de la clase.
Esta propiedad se hereda de CIM_LogicalFile.
CreationDate
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Fecha de creación")
Fecha y hora de creación del archivo.
Esta propiedad se hereda de CIM_LogicalFile.
CSCreationClassName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: propagados ("CIM_FileSystem. CSCreationClassName"), CIM_Key, DisplayName ("Nombre de clase de sistema de equipo")
Clase del sistema informático.
Esta propiedad se hereda de CIM_LogicalFile.
CSName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: propagados ("CIM_FileSystem. CSName"), CIM_Key, DisplayName ("Nombre del sistema de equipo")
Nombre del sistema de equipo.
Esta propiedad se hereda de CIM_LogicalFile.
Descripción
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Descripción")
Descripción textual del objeto.
Esta propiedad se hereda de CIM_ManagedSystemElement.
Conducir
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Fijo, Esquema ("Win32"), DisplayName ("Unidad")
Letra de unidad (incluidos los dos puntos que siguen a la letra de unidad) del archivo.
Ejemplo: "c:"
Esta propiedad se hereda de CIM_LogicalFile.
EightDotThreeFileName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Ocho puntos tres nombre de archivo")
Nombre de archivo compatible con DOS.
Ejemplo: "c:\progra~1"
Esta propiedad se hereda de CIM_LogicalFile.
Cifrado
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Cifrado")
Si es True, el archivo se cifra.
Esta propiedad se hereda de CIM_LogicalFile.
EncryptionMethod
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Método de cifrado")
Cadena de forma libre que identifica el algoritmo o la herramienta que se usa para cifrar un archivo lógico. Si el esquema de cifrado no se admite (por motivos de seguridad, por ejemplo), use "Unknown". Si el archivo está cifrado, pero su esquema de cifrado es desconocido o no divulgado, use "Encrypted". Si el archivo lógico no está cifrado, use "Not Encrypted".
Esta propiedad se hereda de CIM_LogicalFile.
Extensión
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Fijo, Esquema ("Win32"), DisplayName ("Extensión de archivo")
Extensión de nombre de archivo sin el punto anterior (punto).
Ejemplo: "txt", "mof", "mdb"
Esta propiedad se hereda de CIM_LogicalFile.
FileName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Fijo, Esquema ("Win32"), DisplayName ("Nombre de archivo")
Nombre de archivo sin la extensión de nombre de archivo. Ejemplo: "MyDataFile"
Esta propiedad se hereda de CIM_LogicalFile.
FileSize
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Size"), Units ("bytes")
Tamaño del archivo, en bytes.
Para más información sobre el uso de valores uint64 en scripts, vea Scripting in WMI.
Esta propiedad se hereda de CIM_LogicalFile.
FileType
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Tipo de archivo")
Descriptor que representa el tipo de archivo indicado por la propiedad Extension .
Esta propiedad se hereda de CIM_LogicalFile.
FSCreationClassName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: propagados ("CIM_FileSystem. CreationClassName"), CIM_Key, DisplayName ("Nombre de clase del sistema de archivos")
Clase del sistema de archivos.
Esta propiedad se hereda de CIM_LogicalFile.
FSName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: propagados ("CIM_FileSystem. Name"), CIM_Key, DisplayName ("Nombre del sistema de archivos")
Nombre del sistema de archivos.
Esta propiedad se hereda de CIM_LogicalFile.
Oculto
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Oculto")
Si es True, el archivo está oculto.
Esta propiedad se hereda de CIM_LogicalFile.
InstallDate
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")
Indica cuándo se instaló el objeto. La falta de un valor no indica que el objeto no está instalado.
Esta propiedad se hereda de CIM_ManagedSystemElement.
InUseCount
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Recuento actual de apertura de archivos")
Número de "archivos abiertos" que están activos actualmente en el archivo.
Para más información sobre el uso de valores uint64 en scripts, vea Scripting in WMI.
Esta propiedad se hereda de CIM_LogicalFile.
LastAccessed
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Último acceso")
Fecha y hora en que se accedió por última vez al archivo.
Esta propiedad se hereda de CIM_LogicalFile.
LastModified
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Última modificación")
Fecha y hora en que se modificó por última vez el archivo.
Esta propiedad se hereda de CIM_LogicalFile.
Fabricante
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Fabricante")
Cadena de fabricante del recurso de versión (si hay una presente).
Nombre
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Clave
La propiedad Name es una cadena que representa el nombre heredado que actúa como clave de una instancia de archivo lógico dentro de un sistema de archivos. Se deben proporcionar nombres de ruta de acceso completos.
Ejemplo: C:\Windows\system\win.ini
Esta propiedad se hereda de CIM_LogicalFile.
Ruta de acceso
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Fijo, Esquema ("Win32"), DisplayName ("Path")
Ruta de acceso del archivo, incluidas las barras diagonales inversas iniciales y finales. Ejemplo: "\windows\system\"
Esta propiedad se hereda de CIM_LogicalFile.
Legible
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Legible")
Si es True, se puede leer el archivo.
Esta propiedad se hereda de CIM_LogicalFile.
Estado
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen (10), DisplayName ("Status")
Cadena que indica el estado actual del objeto. Se puede definir el estado operativo y no operativo. El estado operativo puede incluir "Ok", "Degradado" y "Error previo". "Error previo" indica que un elemento funciona correctamente, pero predice un error (por ejemplo, una unidad de disco duro habilitada para SMART).
El estado no operativo puede incluir "Error", "Inicio", "Detención" y "Servicio". "Servicio" se puede aplicar durante la resilveración de reflejo del 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")
Error previo ("Error previo")
Inicio ("Inicio")
Detener ("Detener")
Servicio ("Servicio")
Estresado ("Estresado")
NonRecover ("NonRecover")
Sin contacto ("Sin contacto")
Lost Comm ("Lost Comm")
Sistema
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Archivo del sistema")
Si es True, el archivo es un archivo del sistema.
Esta propiedad se hereda de CIM_LogicalFile.
Versión
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Versión")
Cadena de versión del recurso de versión (si hay alguna).
Writeable (Grabable)
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Writeable")
Si es True, se puede escribir el archivo.
Esta propiedad se hereda de CIM_LogicalFile.
Observaciones
La clase CIM_DataFile se deriva de CIM_LogicalFile.
WMI implementa la clase CIM_DataFile y todos sus métodos. La clase CIM_DataFile es una clase dinámica.
Esta documentación se deriva de las descripciones de clase CIM publicadas por DMTF. Microsoft puede haber realizado cambios para corregir errores menores, cumplir los estándares de documentación de Microsoft SDK o proporcionar más información.
Debido a fines de seguridad, WMI no admite directamente llamar a un equipo remoto e indicarle que copie archivos a sí mismo. Sin embargo, puede usar el lenguaje de programación pertinente para llamar a FTP o RoboCopy, por ejemplo.
Ejemplos
En el siguiente ejemplo de código del Centro de scripting se usa una clase CIM_DataFile como parte de una aplicación más grande para generar informes de entorno de intercambio mediante PowerShell.
El ejemplo de código Find files with WMI PowerShell (Buscar archivos con WMI PowerShell ) en la Galería de TechNet usa un CIM_DataFile para buscar uno o varios archivos en varios equipos.
En el ejemplo de código VBS siguiente se describe cómo realizar una búsqueda de caracteres comodín estándar en un archivo de datos. Tenga en cuenta que los delimitadores de barra diagonal inversa deben escaparse con otra barra diagonal inversa (\\). Además, al usar "CIM_DataFile. FileName" en la cláusula WHERE, el proceso WMIPRVSE examinará todos los directorios en cualquier dispositivo de almacenamiento disponible. Esto puede tardar algún tiempo, especialmente si ha asignado recursos compartidos remotos y puede desencadenar advertencias antivirus.
strComputer = "."
Set objWMIService = GetObject("winmgmts:" & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFiles = objWMIService.ExecQuery("Select * from CIM_DataFile where FileName Like '%~%'")
For Each objFile in colFiles
Wscript.Echo objFile.Name
Next
El fragmento de código siguiente limita el intervalo de búsqueda a una unidad, ruta de acceso y extensión de archivo específica.
Set colFiles = objWMIService.ExecQuery("Select * from CIM_DataFile where Drive='"C:"' And Path='"\\"' and Name Like '%~%' and Extension='doc' ")
El siguiente ejemplo de código de PowerShell recupera un único valor de atributo.
$computer = "."
$path = "C:\\Program Files\\Microsoft SQL Server\\MSSQL.1\\MSSQL\\LOG\\"
$filename = "ERRORLOG"
$fullname = $path + $filename
$wql = 'SELECT Archive FROM CIM_DataFile WHERE Name = "' + $fullname + '"'
Get-WmiObject -ComputerName $computer -Query $wql | foreach { $_.Archive }
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|
Vea 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