classe Win32_Directory

La classe WMIWin32_Directory rappresenta una voce di directory in un sistema computer che esegue Windows. Una directory è un tipo di file che raggruppa logicamente i file di dati e fornisce informazioni sul percorso per i file raggruppati. Esempio: C:\TEMP. Win32_Directory non include directory di unità di rete.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate nell'ordine alfabetico, non nell'ordine MOF.

Sintassi

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

Members

La classe Win32_Directory include questi tipi di membri:

• Metodi
• Proprietà

Metodi

La classe Win32_Directory include questi metodi.

Proprietà

La classe Win32_Directory include queste proprietà.

Accessmask

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: Schema ("Win32"), DisplayName ("Diritti di accesso")

Maschera di bit che rappresenta i diritti di accesso necessari per accedere o eseguire operazioni specifiche nella directory. Per i valori di bit, vedere Costanti diritti di accesso file e directory.

Nota

Nei volumi FAT il valore FULL_ACCESS viene restituito, invece, che indica che non è stata impostata alcuna sicurezza sull'oggetto.

Questa proprietà viene ereditata da CIM_LogicalFile.

FILE_READ_DATA (file) o FILE_LIST_DIRECTORY (directory) (1)

Concede il diritto di leggere i dati dal file. Per una directory, questo valore concede il diritto di elencare il contenuto della directory.

FILE_WRITE_DATA (file) o FILE_ADD_FILE (directory) (2)

Concede il diritto di scrivere dati nel file. Per una directory, questo valore concede il diritto di creare un file nella directory.

FILE_APPEND_DATA (file) o FILE_ADD_SUBDIRECTORY ( 4)

Concede il diritto di aggiungere dati al file. Per una directory, questo valore concede il diritto di creare una sottodirectory.

FILE_READ_EA (8)

Concede il diritto di leggere gli attributi estesi.

FILE_WRITE_EA (16)

Concede il diritto di scrivere attributi estesi.

FILE_EXECUTE (file) o FILE_TRAVERSE (directory) ( 32)

Concede il diritto di eseguire un file. Per una directory, la directory può essere attraversata.

FILE_DELETE_CHILD (directory) ( 64)

Concede il diritto di eliminare una directory e tutti i file che contiene (i relativi elementi figlio), anche se i file sono di sola lettura.

FILE_READ_ATTRIBUTES (128)

Concede il diritto di leggere gli attributi di file.

FILE_WRITE_ATTRIBUTES (256)

Concede il diritto di modificare gli attributi del file.

DELETE (65536)

Concede l'accesso all'eliminazione.

READ_CONTROL (131072 )

Concede l'accesso in lettura al descrittore e al proprietario della sicurezza.

WRITE_DAC (262144 )

Concede l'accesso in scrittura all'ACL discrezionale.

WRITE_OWNER (524288 )

Assegna il proprietario di scrittura.

SYNC (1048576)

Sincronizza l'accesso e consente a un processo di attendere che un oggetto immetta lo stato segnalato.

ACCESS_SYSTEM_SECURITY (18809343 )

Controlla la possibilità di ottenere o impostare SACL nel descrittore di sicurezza di un oggetto.

Commenti

La classe Win32_Directory deriva da CIM_Directory.

Panoramica

Le cartelle sono oggetti file system progettati per contenere altri oggetti del file system. Ciò non significa che tutte le cartelle siano uguali, tuttavia. Al contrario, le cartelle possono variare notevolmente. Alcune cartelle sono cartelle del sistema operativo, che in genere non devono essere modificate da uno script. Alcune cartelle sono di sola lettura, il che significa che gli utenti possono accedere al contenuto di tale cartella, ma non possono aggiungere, eliminare o modificare tali contenuti. Alcune cartelle vengono compresse per l'archiviazione ottimale, mentre altre sono nascoste e non visibili agli utenti.

WMI usa la classe Win32_Directory per gestire le cartelle. In modo significativo, le proprietà e i metodi disponibili in questa classe sono identici alle proprietà e ai metodi disponibili nella classe CIM_DataFile , la classe usata per gestire i file. Ciò significa che dopo aver appreso come gestire le cartelle usando WMI, si saprà anche come gestire i file senza alcun lavoro aggiuntivo.

La classe di associazione Win32_Subdirectory viene usata anche per gestire file e cartelle. La classe Win32_Subdirectory correla una cartella e le relative sottocartelle immediate. Ad esempio, nella struttura di cartelle C:\Scripts\Logs, Logs è una sottocartella di Scripts e Scripts è una sottocartella della cartella radice C:\. Tuttavia, i log non sono considerati una sottocartella di C:\.

È possibile recuperare le proprietà di qualsiasi cartella nel file system usando la classe Win32_Directory . Le proprietà disponibili usando questa classe sono visualizzate nella tabella 11.1. Per recuperare le proprietà per una singola cartella, creare una query WQL (Windows Query Language) per la classe Win32_Directory , assicurandosi di includere il nome della cartella. Ad esempio, questa query viene associata alla cartella D:\Archive:

Copy "SELECT * FROM Win32_Directory WHERE Name = 'D:\\Archive'"

Quando si specifica un nome di file o cartella in una query WQL, assicurarsi di usare due barre rovesciata (\\) per separare i componenti del percorso.

Se si desidera limitare il recupero dei dati a una singola unità disco, includere una clausola Where che specifica la lettera di unità. Ad esempio, questa query restituisce un elenco di tutte le cartelle nell'unità C:

"SELECT * FROM Win32_Directory WHERE Drive = 'C:'"

Se è necessario enumerare tutte le cartelle in un computer, tenere presente che il completamento della query può richiedere molto tempo.

Esempio

Nell'esempio VBScript seguente vengono recuperate le proprietà per la cartella 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

Nell'esempio VBScript seguente viene restituito un elenco di tutte le cartelle nascoste in un computer.

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

Requisiti

Vedi anche

CIM_Directory

Classi del sistema operativo