classe CIM_DataFile

Artigo
06/13/2023

A classe CIM_DataFile representa uma coleção nomeada de dados ou código executável. Somente instâncias de arquivos em discos fixos locais serão retornadas.

Importante

As classes CIM do DMTF (Distributed Management Task Force) (Common Information Model) são as classes pai nas quais as classes WMI são criadas. Atualmente, o WMI dá suporte apenas aos esquemas de versão cim 2.x.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética, não em ordem MOF.

Sintaxe

[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;
};

Membros

A classe CIM_DataFile tem estes tipos de membros:

Métodos
Propriedades

Métodos

A classe CIM_DataFile tem esses métodos.

Método	Descrição
ChangeSecurityPermissions	Altera as permissões de segurança para o arquivo lógico especificado no caminho do objeto. Implementado pelo WMI.
ChangeSecurityPermissionsEx	Altera as permissões de segurança para o arquivo lógico especificado no caminho do objeto. Implementado pelo WMI.
Comprimir	Usa a compactação NTFS para compactar o arquivo lógico (ou diretório) especificado no caminho do objeto. Implementado pelo WMI.
CompressEx	Compacta o arquivo lógico (ou diretório) especificado no caminho do objeto. Implementado pelo WMI.
Copiar	Copia o arquivo lógico (ou diretório) especificado no caminho do objeto para o local especificado pelo parâmetro de entrada. Implementado pelo WMI.
CopyEx	Copia o arquivo lógico (ou diretório) especificado no caminho do objeto para o local especificado pelo parâmetro de entrada. Implementado pelo WMI.
Excluir	Exclui o arquivo lógico (ou diretório) especificado no caminho do objeto. Implementado pelo WMI.
DeleteEx	Exclui o arquivo lógico (ou diretório) especificado no caminho do objeto. Implementado pelo WMI.
GetEffectivePermission	Determina se o chamador tem as permissões agregadas especificadas pelo argumento Permission . Implementado pelo WMI.
Renomear	Renomeia o arquivo lógico (ou diretório) especificado no caminho do objeto. Implementado pelo WMI.
Takeownership	Obtém a propriedade do arquivo lógico especificado no caminho do objeto. Implementado pelo WMI.
TakeOwnerShipEx	Obtém a propriedade do arquivo lógico especificado no caminho do objeto. Implementado pelo WMI.
Descompactar	Descompacta o arquivo lógico (ou diretório) especificado no caminho do objeto. Implementado pelo WMI.
UncompressEx	Descompacta o arquivo lógico (ou diretório) especificado no caminho do objeto. Implementado pelo WMI.

Propriedades

A classe CIM_DataFile tem essas propriedades.

AccessMask

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Direitos de Acesso")

Bitmask que representa os direitos de acesso necessários para acessar ou executar operações específicas no arquivo. Para obter valores de bits, consulte Constantes de direitos de acesso de arquivo e diretório.

Observação

Em volumes FAT, o valor FULL_ACCESS é retornado, o que indica que nenhuma segurança foi definida no objeto .

Essa propriedade é herdada de CIM_LogicalFile.

FILE_READ_DATA (arquivo) ou FILE_LIST_DIRECTORY (diretório) (1)

FILE_WRITE_DATA (arquivo) ou FILE_ADD_FILE (diretório) (2)

FILE_APPEND_DATA (arquivo) ou FILE_ADD_SUBDIRECTORY (diretório) (4)

FILE_READ_EA (8)

FILE_WRITE_EA (16)

FILE_EXECUTE (arquivo) ou FILE_TRAVERSE (diretório) (32)

FILE_DELETE_CHILD (diretório) (64)

FILE_READ_ATTRIBUTES (128)

FILE_WRITE_ATTRIBUTES (256)

DELETE (65536)

READ_CONTROL (131072)

WRITE_DAC (262144)

WRITE_OWNER (524288)

SYNCHRONIZE (1048576)

Arquivar

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Deve ser arquivado")

Se True, o arquivo deverá ser arquivado.

Essa propriedade é herdada de CIM_LogicalFile.

Legenda

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (64), DisplayName ("Caption")

Uma breve descrição textual do objeto .

Essa propriedade é herdada de CIM_ManagedSystemElement.

Compactado

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Compactado")

Se True, o arquivo será compactado.

Essa propriedade é herdada de CIM_LogicalFile.

CompressionMethod

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Método de Compactação")

Cadeia de caracteres de forma livre que indica o algoritmo ou a ferramenta usada para compactar o arquivo lógico. Se o esquema de compactação for desconhecido ou não for descrito, use "Desconhecido". Se o arquivo lógico for compactado, mas o esquema de compactação for desconhecido ou não descrito, use "Compactado". Se o arquivo lógico não estiver compactado, use "Não Compactado".

Essa propriedade é herdada de CIM_LogicalFile.

CreationClassName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: CIM_Key, DisplayName ("Nome da Classe")

Nome da classe.

Essa propriedade é herdada de CIM_LogicalFile.

CreationDate

Tipo de dados: datetime
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Data de Criação")

Data e hora da criação do arquivo.

Essa propriedade é herdada de CIM_LogicalFile.

CSCreationClassName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: propagados ("CIM_FileSystem. CSCreationClassName"), CIM_Key, DisplayName ("Nome da classe do sistema do computador")

Classe do sistema de computador.

Essa propriedade é herdada de CIM_LogicalFile.

CSName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: propagados ("CIM_FileSystem. CSName"), CIM_Key, DisplayName ("Nome do Sistema do Computador")

Nome do sistema do computador.

Essa propriedade é herdada de CIM_LogicalFile.

Descrição

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Description")

Uma descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Dirigir

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Fixo, Esquema ("Win32"), DisplayName ("Unidade")

Letra da unidade (incluindo os dois-pontos que seguem a letra da unidade) do arquivo.

Exemplo: "c:"

Essa propriedade é herdada de CIM_LogicalFile.

EightDotThreeFileName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Oito Pontos Três Nome de Arquivo")

Nome do arquivo compatível com DOS.

Exemplo: "c:\progra~1"

Essa propriedade é herdada de CIM_LogicalFile.

Criptografado

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Criptografado")

Se True, o arquivo será criptografado.

Essa propriedade é herdada de CIM_LogicalFile.

Encryptionmethod

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Método de Criptografia")

Cadeia de caracteres de forma livre que identifica o algoritmo ou a ferramenta usada para criptografar um arquivo lógico. Se o esquema de criptografia não for entregue (por motivos de segurança, por exemplo), use "Desconhecido". Se o arquivo for criptografado, mas seu esquema de criptografia for desconhecido ou não for divulgado, use "Criptografado". Se o arquivo lógico não estiver criptografado, use "Não Criptografado".

Essa propriedade é herdada de CIM_LogicalFile.

Extensão

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Fixo, Esquema ("Win32"), DisplayName ("Extensão de Arquivo")

Extensão de nome de arquivo sem o período anterior (ponto).

Exemplo: "txt", "mof", "mdb"

Essa propriedade é herdada de CIM_LogicalFile.

FileName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Fixo, Esquema ("Win32"), DisplayName ("Nome do Arquivo")

Nome do arquivo sem a extensão de nome de arquivo. Exemplo: "MyDataFile"

Essa propriedade é herdada de CIM_LogicalFile.

FileSize

Tipo de dados: uint64
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Size"), Units ("bytes")

Tamanho do arquivo, em bytes.

Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.

Essa propriedade é herdada de CIM_LogicalFile.

FileType

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Tipo de Arquivo")

Descritor que representa o tipo de arquivo indicado pela propriedade Extension .

Essa propriedade é herdada de CIM_LogicalFile.

FSCreationClassName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Propagados ("CIM_FileSystem. CreationClassName"), CIM_Key, DisplayName ("Nome da Classe do Sistema de Arquivos")

Classe do sistema de arquivos.

Essa propriedade é herdada de CIM_LogicalFile.

FSName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Propagados ("CIM_FileSystem. Name"), CIM_Key, DisplayName ("Nome do Sistema de Arquivos")

Nome do sistema de arquivos.

Essa propriedade é herdada de CIM_LogicalFile.

Oculto

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Oculto")

Se True, o arquivo ficará oculto.

Essa propriedade é herdada de CIM_LogicalFile.

InstallDate

Tipo de dados: datetime
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

InUseCount

Tipo de dados: uint64
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Contagem aberta de arquivo atual")

Número de "arquivo aberto" que estão ativos no momento no arquivo.

Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.

Essa propriedade é herdada de CIM_LogicalFile.

LastAccessed

Tipo de dados: datetime
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Último Acessado")

Data e hora em que o arquivo foi acessado pela última vez.

Essa propriedade é herdada de CIM_LogicalFile.

Lastmodified

Tipo de dados: datetime
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Última modificação")

Data e hora em que o arquivo foi modificado pela última vez.

Essa propriedade é herdada de CIM_LogicalFile.

Fabricante

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Fabricante")

Cadeia de caracteres do fabricante do recurso de versão (se houver um).

Nome

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Chave

A propriedade Name é uma cadeia de caracteres que representa o nome herdado que serve como uma chave de uma instância de arquivo lógico dentro de um sistema de arquivos. Os nomes de caminho completo devem ser fornecidos.

Exemplo: C:\Windows\system\win.ini

Essa propriedade é herdada de CIM_LogicalFile.

Caminho

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Fixo, Esquema ("Win32"), DisplayName ("Caminho")

Caminho do arquivo, incluindo as barras invertidas à esquerda e à direita. Exemplo: "\windows\system\"

Essa propriedade é herdada de CIM_LogicalFile.

Legível

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Legível")

Se True, o arquivo poderá ser lido.

Essa propriedade é herdada de CIM_LogicalFile.

Status

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (10), DisplayName ("Status")

Cadeia de caracteres que indica o status atual do objeto. As status operacionais e não operacionais podem ser definidas. Os status operacionais podem incluir "OK", "Degradado" e "Falha de Pred". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).

As status não operacionais podem incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante o disco espelho-resilvering, recarregando uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Falha de pred ("Falha de pred")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem contato ("Sem contato")

Comm Perdido ("Comm Perdido")

System

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Arquivo do Sistema")

Se True, o arquivo será um arquivo do sistema.

Essa propriedade é herdada de CIM_LogicalFile.

Versão

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32"), DisplayName ("Versão")

Cadeia de caracteres de versão do recurso de versão (se houver).

Gravável

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Gravável")

Se True, o arquivo poderá ser gravado.

Essa propriedade é herdada de CIM_LogicalFile.

Comentários

A classe CIM_DataFile é derivada de CIM_LogicalFile.

O WMI implementa a classe CIM_DataFile e todos os seus métodos. A classe CIM_DataFile é uma classe dinâmica.

Esta documentação é derivada das descrições da classe CIM publicadas pelo DMTF. A Microsoft pode ter feito alterações para corrigir erros secundários, estar em conformidade com os padrões de documentação do SDK da Microsoft ou fornecer mais informações.

Devido a fins de segurança, o WMI não dá suporte diretamente à chamada de um computador remoto e à instrução de copiar arquivos para si mesmo. No entanto, você pode usar a linguagem de programação relevante para chamar FTP ou RoboCopy, por exemplo.

Exemplos

O exemplo de código da Central de Scripts a seguir usa uma classe CIM_DataFile como parte de um aplicativo maior para Gerar relatórios de ambiente de troca usando o PowerShell.

O exemplo de código Localizar arquivos com WMI PowerShell na Galeria do TechNet usa um CIM_DataFile para pesquisar um ou mais arquivos em vários computadores.

O exemplo de código VBS a seguir descreve como executar uma pesquisa curinga padrão em um arquivo de dados. Observe que os delimitadores de barra invertida devem ter escape com outra barra invertida (\\). Além disso, ao usar "CIM_DataFile. FileName" na cláusula WHERE, o processo WMIPRVSE examinará todos os diretórios em qualquer dispositivo de armazenamento disponível. Isso pode levar algum tempo, especialmente se você mapeou compartilhamentos remotos e pode disparar avisos antivírus.

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

O snippet a seguir limita o intervalo de pesquisa a uma unidade, caminho e extensão de arquivo específicos.

Set colFiles = objWMIService.ExecQuery("Select * from CIM_DataFile where Drive='"C:"' And Path='"\\"' and Name Like '%~%' and Extension='doc' ")

O exemplo de código do PowerShell a seguir recupera um ú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	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

CIM_LogicalFile
Tarefas do WMI: arquivos e pastas
Constantes de direitos de acesso de arquivo e diretório

Partilhar via

classe CIM_DataFile

Sintaxe

Membros

Métodos

Propriedades

Comentários

Exemplos

Requisitos

Confira também

Comentários

Recursos adicionais