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 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
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 |
|
| DLL |
|
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de