Classe Win32_Directory
A classe WMIWin32_Directory representa uma entrada de diretório em um sistema de computador que executa o Windows. Um diretório é um tipo de arquivo que agrupa logicamente arquivos de dados e fornece informações de caminho para os arquivos agrupados. Exemplo: C:\TEMP. Win32_Directory não inclui diretórios de unidades de rede.
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("{8502C4C7-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Directory : CIM_Directory
{
string Caption;
string Description;
datetime InstallDate;
string Name;
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 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;
};
Membros
A classe Win32_Directory tem estes tipos de membros:
Métodos
A classe Win32_Directory tem esses métodos.
| Método | Descrição |
|---|---|
| ChangeSecurityPermissions | Método de classe que altera as permissões de segurança para o arquivo lógico especificado no caminho do objeto. |
| ChangeSecurityPermissionsEx | Método de classe que altera as permissões de segurança para o arquivo lógico especificado no caminho do objeto. |
| Comprimir | Método de classe que compacta o arquivo lógico (ou diretório) especificado no caminho do objeto. |
| CompressEx | Método de classe que compacta o arquivo lógico (ou diretório) especificado no caminho do objeto. |
| Copiar | Método de classe que copia o arquivo lógico ou diretório especificado no caminho do objeto para o local especificado pelo parâmetro de entrada. |
| CopyEx | Método de classe que copia o arquivo lógico ou diretório especificado no caminho do objeto para o local especificado pelo parâmetro FileName . |
| Excluir | Método de classe que exclui o arquivo lógico (ou diretório) especificado no caminho do objeto. |
| DeleteEx | Método de classe que exclui o arquivo lógico (ou diretório) especificado no caminho do objeto. |
| GetEffectivePermission | Método de classe que determina se o chamador tem as permissões agregadas especificadas pelo argumento Permissions não apenas no objeto de arquivo, mas no compartilhamento em que o arquivo ou diretório reside (se estiver em um compartilhamento). |
| Renomear | Método de classe que renomeia o arquivo lógico (ou diretório) especificado no caminho do objeto. |
| Takeownership | Método de classe que obtém a propriedade do arquivo lógico especificado no caminho do objeto. |
| TakeOwnerShipEx | Método de classe que obtém a propriedade do arquivo lógico especificado no caminho do objeto. |
| Descompactar | Método de classe que descompacta o arquivo lógico (ou diretório) especificado no caminho do objeto. |
| UncompressEx | Método de classe que descompacta o arquivo lógico (ou diretório) especificado no caminho do objeto. |
Propriedades
A classe Win32_Directory 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 diretório. Para 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)
-
Concede o direito de ler dados do arquivo. Para um diretório, esse valor concede o direito de listar o conteúdo do diretório.
-
FILE_WRITE_DATA (arquivo) ou FILE_ADD_FILE (diretório) (2)
-
Concede o direito de gravar dados no arquivo. Para um diretório, esse valor concede o direito de criar um arquivo no diretório .
-
FILE_APPEND_DATA (arquivo) ou FILE_ADD_SUBDIRECTORY (4)
-
Concede o direito de acrescentar dados ao arquivo. Para um diretório, esse valor concede o direito de criar um subdiretório.
-
FILE_READ_EA (8)
-
Concede o direito de ler atributos estendidos.
-
FILE_WRITE_EA (16)
-
Concede o direito de gravar atributos estendidos.
-
FILE_EXECUTE (arquivo) ou FILE_TRAVERSE (diretório) (32)
-
Concede o direito de executar um arquivo. Para um diretório, o diretório pode ser percorrido.
-
FILE_DELETE_CHILD (diretório) (64)
-
Concede o direito de excluir um diretório e todos os arquivos que ele contém (seus filhos), mesmo que os arquivos sejam somente leitura.
-
FILE_READ_ATTRIBUTES (128)
-
Concede o direito de ler atributos de arquivo.
-
FILE_WRITE_ATTRIBUTES (256)
-
Concede o direito de alterar atributos de arquivo.
-
DELETE (65536)
-
Concede acesso de exclusão.
-
READ_CONTROL (131072)
-
Concede acesso de leitura ao descritor de segurança e ao proprietário.
-
WRITE_DAC (262144)
-
Concede acesso de gravação à ACL discricionária.
-
WRITE_OWNER (524288)
-
Atribui o proprietário da gravação.
-
SYNCHRONIZE (1048576)
-
Sincroniza o acesso e permite que um processo aguarde até que um objeto entre no estado sinalizado.
-
ACCESS_SYSTEM_SECURITY (18809343)
-
Controla a capacidade de obter ou definir a SACL no descritor de segurança de um objeto.
Arquivar
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
-
Qualificadores: Esquema ("Win32"), DisplayName ("Deve ser arquivado")
Indica se o bit de arquivo morto na pasta foi definido. O bit de arquivo morto é usado por programas de backup para identificar arquivos que devem ser copiados em backup. 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")
Indica se a pasta foi compactada ou não. O WMI reconhece pastas compactadas usando o próprio WMI ou usando a interface gráfica do usuário; no entanto, ele não reconhece .ZIP arquivos como sendo compactados. 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 compression")
Algoritmo ou ferramenta (geralmente um método) usado para compactar o arquivo lógico. Se não for possível (ou não desejado) descrever o esquema de compactação (talvez porque não seja conhecido), use as seguintes palavras: "Desconhecido" para representar que não se sabe se o arquivo lógico é compactado; "Compactado" para representar que o arquivo é compactado, mas seu esquema de compactação não é conhecido ou não é divulgado; e "Não Compactado" para representar que o arquivo lógico 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 primeira classe concreta a aparecer na cadeia de herança usada na criação de uma instância. Quando usada com as outras propriedades principais da classe, essa propriedade permite que todas as instâncias dessa classe e suas subclasses sejam identificadas exclusivamente.
Essa propriedade é herdada de CIM_LogicalFile.
CreationDate
-
Tipo de dados: datetime
-
Tipo de acesso: Somente leitura
-
Qualificadores: DisplayName ("Data de Criação")
Data em que o objeto do sistema de arquivos foi criado. Para obter mais informações sobre como trabalhar com formatos de data e hora do WMI, consulte Tarefas do WMI: Datas e Horas.
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")
Nome da classe de criação do sistema de computador de escopo.
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 computador em que o objeto do sistema de arquivos é armazenado.
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 de unidade da unidade (incluindo dois-pontos) em que o objeto do sistema de arquivos é armazenado.
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")
MS-DOS -nome compatível com a pasta.
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")
Indica se a pasta foi criptografada ou não. Se True, a pasta será criptografada.
Essa propriedade é herdada de CIM_LogicalFile.
Encryptionmethod
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: DisplayName ("Método encryption")
Algoritmo ou ferramenta usada para criptografar o arquivo lógico. Se não for possível (ou não desejado) descrever o esquema de criptografia (talvez por motivos de segurança), use as seguintes palavras: "Desconhecido" para representar que não se sabe se o arquivo lógico está criptografado; "Criptografado" para representar que o arquivo está criptografado, mas seu esquema de criptografia não é conhecido ou não é divulgado; e "Não Criptografado" para representar que o arquivo lógico não está 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 para o objeto do sistema de arquivos, sem incluir o ponto (.) que separa a extensão do nome do arquivo.
Exemplos: "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 o ponto ou extensão) do arquivo.
Exemplo: "autoexec"
Essa propriedade é herdada de CIM_LogicalFile.
FileSize
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
-
Qualificadores: DisplayName ("Size"), Unidades ("bytes")
Tamanho do objeto do sistema de arquivos, em bytes. Embora as pastas possuam uma propriedade FileSize , o valor 0 sempre é retornado. Para determinar o tamanho de uma pasta, use o FileSystemObject ou adicione o tamanho de todos os arquivos armazenados na pasta.
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")
Tipo de arquivo (indicado pela propriedade Extension ).
Por exemplo, é provável que um arquivo .mdb tenha o tipo de arquivo Microsoft Access Application. Um arquivo .asp provavelmente tem o tipo de arquivo Documento HTML. As pastas normalmente são relatadas simplesmente como Pasta.
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")
Tipo de sistema de arquivos (NTFS, FAT, FAT32) instalado na unidade em que o arquivo ou pasta está localizado.
Essa propriedade é herdada de CIM_LogicalFile.
Oculto
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
-
Qualificadores: Esquema ("Win32"), DisplayName ("Oculto")
Indica se o objeto do sistema de arquivos está 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.
Essa propriedade é herdada de CIM_LogicalFile.
Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.
LastAccessed
-
Tipo de dados: datetime
-
Tipo de acesso: Somente leitura
-
Qualificadores: DisplayName ("Último Acessado")
Data em que o arquivo foi acessado pela última vez. Para obter mais informações sobre como trabalhar com formatos de data e hora do WMI, consulte Tarefas do WMI: Datas e Horas.
Essa propriedade é herdada de CIM_LogicalFile.
Lastmodified
-
Tipo de dados: datetime
-
Tipo de acesso: Somente leitura
-
Qualificadores: DisplayName ("Última modificação")
Data em que o arquivo foi modificado pela última vez. Para obter mais informações sobre como trabalhar com formatos de data e hora do WMI, consulte Tarefas do WMI: Datas e Horas.
Essa propriedade é herdada de CIM_LogicalFile.
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 para o arquivo. O caminho inclui as barras invertidas à esquerda e à direita, mas não a letra da unidade ou o nome da pasta.
Para a pasta c:\windows\system32\wbem, o caminho é \windows\system32\. Para a pasta c:\scripts, o caminho é \.
Essa propriedade é herdada de CIM_LogicalFile.
Legível
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
-
Qualificadores: DisplayName ("Legível")
Indica se você pode ler itens na pasta. 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.
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")
Lost Comm ("Lost Comm")
System
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
-
Qualificadores: Esquema ("Win32"), DisplayName ("Arquivo do Sistema")
Indica se o objeto é um arquivo do sistema. Se true, o arquivo é um arquivo do sistema
Essa propriedade é herdada de CIM_LogicalFile.
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 Win32_Directory é derivada de CIM_Directory.
Visão geral
Pastas são objetos do sistema de arquivos projetados para conter outros objetos do sistema de arquivos. No entanto, isso não significa que todas as pastas sejam iguais. Em vez disso, as pastas podem variar consideravelmente. Algumas pastas são pastas do sistema operacional, que geralmente não devem ser modificadas por um script. Algumas pastas são somente leitura, o que significa que os usuários podem acessar o conteúdo dessa pasta, mas não podem adicionar, excluir ou modificar esses conteúdos. Algumas pastas são compactadas para armazenamento ideal, enquanto outras ficam ocultas e não são visíveis para os usuários.
O WMI usa a classe Win32_Directory para gerenciar pastas. Significativamente, as propriedades e os métodos disponíveis nessa classe são idênticos às propriedades e aos métodos disponíveis na classe CIM_DataFile , a classe usada para gerenciar arquivos. Isso significa que, depois de aprender a gerenciar pastas usando o WMI, você, sem nenhum trabalho extra, também saberá como gerenciar arquivos.
A classe de associação Win32_Subdirectory também é usada para gerenciar arquivos e pastas. A classe Win32_Subdirectory relaciona uma pasta e suas subpastas imediatas. Por exemplo, na estrutura de pastas C:\Scripts\Logs, Logs é uma subpasta de Scripts e Scripts é uma subpasta da pasta raiz C:\. No entanto, Os logs não são considerados uma subpasta de C:\.
Você pode recuperar as propriedades de qualquer pasta no sistema de arquivos usando a classe Win32_Directory . As propriedades disponíveis usando essa classe são mostradas na Tabela 11.1. Para recuperar as propriedades de uma única pasta, construa uma consulta WQL (Windows Query Language) para a classe Win32_Directory , certificando-se de incluir o nome da pasta. Por exemplo, essa consulta se associa à pasta D:\Archive:
Copy "SELECT * FROM Win32_Directory WHERE Name = 'D:\\Archive'"
Ao especificar um nome de arquivo ou pasta em uma consulta WQL, certifique-se de usar duas barras invertidas (\\) para separar componentes de caminho.
Se você quiser limitar a recuperação de dados a uma única unidade de disco, inclua uma cláusula Where especificando a letra da unidade. Por exemplo, essa consulta retorna uma lista de todas as pastas na unidade C:
"SELECT * FROM Win32_Directory WHERE Drive = 'C:'"
Se você precisar enumerar todas as pastas em um computador, lembre-se de que essa consulta pode levar um longo tempo para ser concluída.
Exemplos
O exemplo de VBScript a seguir recupera as propriedades da pasta C:\Scripts.
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFolders = objWMIService.ExecQuery("SELECT * FROM Win32_Directory WHERE Name = 'c:\\Scripts'")
For Each objFolder in colFolders
Wscript.Echo "Archive: " & objFolder.Archive
Wscript.Echo "Caption: " & objFolder.Caption
Wscript.Echo "Compressed: " & objFolder.Compressed
Wscript.Echo "Compression method: " & objFolder.CompressionMethod
Wscript.Echo "Creation date: " & objFolder.CreationDate
Wscript.Echo "Encrypted: " & objFolder.Encrypted
Wscript.Echo "Encryption method: " & objFolder.EncryptionMethod
Wscript.Echo "Hidden: " & objFolder.Hidden
Wscript.Echo "In use count: " & objFolder.InUseCount
Wscript.Echo "Last accessed: " & objFolder.LastAccessed
Wscript.Echo "Last modified: " & objFolder.LastModified
Wscript.Echo "Name: " & objFolder.Name
Wscript.Echo "Path: " & objFolder.Path
Wscript.Echo "Readable: " & objFolder.Readable
Wscript.Echo "System: " & objFolder.System
Wscript.Echo "Writeable: " & objFolder.Writeable
Next
O exemplo de VBScript a seguir retorna uma lista de todas as pastas ocultas em um computador.
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFiles = objWMIService.ExecQuery("SELECT * FROM Win32_Directory WHERE Hidden = True")
For Each objFile in colFiles
Wscript.Echo objFile.Name
Next
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