classe CIM_DataFile

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 da DMTF (Força-Tarefa de Gerenciamento Distribuído) (Modelo de Informações Comuns) 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 na 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 esses tipos de membros:

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 Permissão . 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")

Máscara de bits que representa os direitos de acesso necessários para acessar ou executar operações específicas no arquivo. Para obter valores de bit, 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 deve 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 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: Propagado ("CIM_FileSystem. CSCreationClassName"), CIM_Key, DisplayName ("Nome da classe do sistema de 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: Propagado ("CIM_FileSystem. CSName"), CIM_Key, DisplayName ("Nome do Sistema de Computador")

Nome do sistema de 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.

Unidade

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Fixo, Esquema ("Win32"), DisplayName ("Drive")

Letra de unidade (incluindo o dois-pontos que segue 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 ("Eight Dot Three File Name")

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 ("Encrypted")

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 encryption")

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: Propagado ("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: Propagado ("CIM_FileSystem. Nome"), 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 ("Install Date")

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 do arquivo atual")

Número de "aberturas de arquivo" que estão ativas 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 ("Last Accessed")

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 uma).

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 em um sistema de arquivos. Os nomes de caminho completos 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 pode 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. O status operacional e não operacional pode ser definido. O status operacional pode incluir "OK", "Degradado" e "Falha de Pred". "Falha de Pred" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).

O status não operacional pode incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante a recuperação de espelho de disco, o recarregamento de uma lista de permissões do 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 ("Mensagens Perdidas")

Sistema

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32"), DisplayName ("Arquivo do Sistema")

Se true, o arquivo é 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 ("Version")

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

Gravável

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Writeable")

Se true, o arquivo pode 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.

Essa 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 a 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.

Os arquivos Localizar com o exemplo de código do WMI PowerShell na Galeria do TechNet usam 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 ser escapados 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ê tiver mapeado compartilhamentos remotos e puder 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