CIM_DataFile clase

Artículo
06/13/2023

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
Propiedades

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	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Vea también

CIM_LogicalFile
Tareas de WMI: archivos y carpetas
Constantes de derechos de acceso a archivos y directorios

Compartir a través de

CIM_DataFile clase

Sintaxis

Miembros

Métodos

Propiedades

Observaciones

Ejemplos

Requisitos

Vea también

Comentarios

Recursos adicionales