classe Win32_Directory

Articolo
06/03/2023

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.

Metodo	Descrizione
ChangeSecurityPermissions	Metodo di classe che modifica le autorizzazioni di sicurezza per il file logico specificato nel percorso dell'oggetto.
ChangeSecurityPermissionsEx	Metodo di classe che modifica le autorizzazioni di sicurezza per il file logico specificato nel percorso dell'oggetto.
Comprimere	Metodo di classe che comprime il file logico (o la directory) specificato nel percorso dell'oggetto.
CompressEx	Metodo di classe che comprime il file logico (o la directory) specificato nel percorso dell'oggetto.
Copia	Metodo di classe che copia il file logico o la directory specificata nel percorso dell'oggetto nel percorso dell'oggetto specificato dal parametro di input.
CopyEx	Metodo di classe che copia il file logico o la directory specificata nel percorso dell'oggetto nel percorso dell'oggetto specificato dal parametro FileName .
Elimina	Metodo di classe che elimina il file logico (o la directory) specificato nel percorso dell'oggetto.
DeleteEx	Metodo di classe che elimina il file logico (o la directory) specificato nel percorso dell'oggetto.
GetEffectivePermission	Metodo di classe che determina se il chiamante dispone delle autorizzazioni aggregate specificate dall'argomento Permissions non solo sull'oggetto file, ma nella condivisione il file o la directory si trovano in (se è in una condivisione).
Rinominare	Metodo di classe che rinomina il file logico (o la directory) specificato nel percorso dell'oggetto.
TakeOwnerShip	Metodo di classe che ottiene la proprietà del file logico specificato nel percorso dell'oggetto.
TakeOwnerShipEx	Metodo di classe che ottiene la proprietà del file logico specificato nel percorso dell'oggetto.
Decomprimere	Metodo di classe che annulla la compressione del file logico (o della directory) specificato nel percorso dell'oggetto.
UncompressEx	Metodo di classe che annulla la compressione del file logico (o della directory) specificato nel percorso dell'oggetto.

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.

Archiviazione

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("Deve essere archiviato")

Indica se il bit di archivio nella cartella è stato impostato. Il bit di archivio viene usato dai programmi di backup per identificare i file che devono essere sottoposti a backup. Se True, il file deve essere archiviato.

Questa proprietà viene ereditata da CIM_LogicalFile.

Didascalia

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MaxLen (64), DisplayName ("Caption")

Breve descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Compressed

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: schema ("Win32"), DisplayName ("compresso")

Indica se la cartella è stata compressa o meno. WMI riconosce le cartelle compresse usando WMI stesso o l'interfaccia utente grafica; non riconosce tuttavia .ZIP file come compressi. Se True, il file viene compresso.

Questa proprietà viene ereditata da CIM_LogicalFile.

CompressionMethod

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Metodo di compressione")

Algoritmo o strumento (in genere un metodo) usato per comprimere il file logico. Se non è possibile (o non si desidera) descrivere lo schema di compressione (forse perché non è noto), usare le parole seguenti: "Sconosciuto" per rappresentare che non è noto se il file logico è compresso; "Compresso" per rappresentare che il file è compresso, ma il relativo schema di compressione non è noto o non divulgato; e "Non compresso" per rappresentare che il file logico non è compresso.

Questa proprietà viene ereditata da CIM_LogicalFile.

CreationClassName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: CIM_Key, DisplayName ("Nome classe")

Nome della prima classe concreta da visualizzare nella catena di ereditarietà utilizzata nella creazione di un'istanza. Se utilizzata con le altre proprietà chiave della classe, questa proprietà consente di identificare in modo univoco tutte le istanze di questa classe e delle relative sottoclassi.

Questa proprietà viene ereditata da CIM_LogicalFile.

CreationDate

Tipo di dati: datetime
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Data creazione")

Data di creazione dell'oggetto file system. Per altre informazioni sull'uso dei formati di data e ora WMI, vedere Attività WMI: Date e ore.

Questa proprietà viene ereditata da CIM_LogicalFile.

CSCreationClassName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: propagati ("CIM_FileSystem. CSCreationClassName"), CIM_Key, DisplayName ("Computer System Class Name")

Nome della classe di creazione del sistema computer di ambito.

Questa proprietà viene ereditata da CIM_LogicalFile.

CSName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: propagati ("CIM_FileSystem. CSName"), CIM_Key, DisplayName ("Nome sistema computer")

Nome del computer in cui è archiviato l'oggetto del file system.

Questa proprietà viene ereditata da CIM_LogicalFile.

Descrizione

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Description")

Descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Unità

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Fisso, Schema ("Win32"), DisplayName ("Unità")

Lettera di unità dell'unità (inclusi i due punti) in cui è archiviato l'oggetto file system.

Esempio: "c:"

Questa proprietà viene ereditata da CIM_LogicalFile.

EightDotThreeFileName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("Eight Dot Three File Name")

MS-DOS - nome compatibile per la cartella.

Esempio: "c:\progra~1"

Questa proprietà viene ereditata da CIM_LogicalFile.

Crittografata

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("Encrypted")

Indica se la cartella è stata crittografata o meno. Se True, la cartella viene crittografata.

Questa proprietà viene ereditata da CIM_LogicalFile.

Encryptionmethod

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Metodo di crittografia")

Algoritmo o strumento usato per crittografare il file logico. Se non è possibile (o non si desidera) descrivere lo schema di crittografia (ad esempio per motivi di sicurezza), usare le parole seguenti: "Sconosciuto" per rappresentare che non è noto se il file logico è crittografato; "Crittografato" per rappresentare che il file è crittografato, ma il relativo schema di crittografia non è noto o non divulgato; e "Non crittografato" per rappresentare che il file logico non è crittografato.

Questa proprietà viene ereditata da CIM_LogicalFile.

Estensione

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: fisso, schema ("Win32"), DisplayName ("estensione file")

Estensione del nome file per l'oggetto file system, senza includere il punto (.) che separa l'estensione dal nome del file.

Esempi: "txt", "mof", "mdb"

Questa proprietà viene ereditata da CIM_LogicalFile.

FileName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Fixed, Schema ("Win32"), DisplayName ("File Name")

Nome file (senza il punto o l'estensione) del file.

Esempio: "autoexec"

Questa proprietà viene ereditata da CIM_LogicalFile.

Dimensione

Tipo di dati: uint64
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Size"), Unità ("byte")

Dimensioni dell'oggetto file system, in byte. Anche se le cartelle dispongono di una proprietà FileSize , il valore 0 viene sempre restituito. Per determinare le dimensioni di una cartella, usare FileSystemObject o aggiungere le dimensioni di tutti i file archiviati nella cartella.

Per altre informazioni sull'uso di valori uint64 negli script, vedere Scripting in WMI.

Questa proprietà viene ereditata da CIM_LogicalFile.

Filetype

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("Tipo di file")

Tipo di file (indicato dalla proprietà Extension ).

Ad esempio, è probabile che un file con estensione mdb abbia il tipo di file Applicazione di Microsoft Access. Un file con estensione asp ha probabilmente il tipo di file HTML Document. Le cartelle vengono in genere segnalate semplicemente come cartella.

Questa proprietà viene ereditata da CIM_LogicalFile.

FSCreationClassName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: propagati ("CIM_FileSystem. CreationClassName"), CIM_Key, DisplayName ("Nome classe file system")

Classe del file system.

Questa proprietà viene ereditata da CIM_LogicalFile.

FSName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: propagati ("CIM_FileSystem. Name"), CIM_Key, DisplayName ("Nome file system")

Tipo di file system (NTFS, FAT, FAT32) installato nell'unità in cui si trova il file o la cartella.

Questa proprietà viene ereditata da CIM_LogicalFile.

Hidden

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("Hidden")

Indica se l'oggetto file system è nascosto. Se True, il file è nascosto.

Questa proprietà viene ereditata da CIM_LogicalFile.

InstallDate

Tipo di dati: datetime
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data di installazione")

Indica quando l'oggetto è stato installato. La mancanza di un valore non indica che l'oggetto non è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

InUseCount

Tipo di dati: uint64
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Conteggio apertura file corrente")

Numero di "file aperti" attualmente attivi nel file.

Questa proprietà viene ereditata da CIM_LogicalFile.

Per altre informazioni sull'uso di valori uint64 negli script, vedere Scripting in WMI.

LastAccessed

Tipo di dati: datetime
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Ultimo accesso")

Data dell'ultimo accesso al file. Per altre informazioni sull'uso dei formati di data e ora WMI, vedere Attività WMI: Date e ore.

Questa proprietà viene ereditata da CIM_LogicalFile.

LastModified

Tipo di dati: datetime
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Ultima modifica")

Data dell'ultima modifica del file. Per altre informazioni sull'uso dei formati di data e ora WMI, vedere Attività WMI: Date e ore.

Questa proprietà viene ereditata da CIM_LogicalFile.

Nome

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Chiave

La proprietà Name è una stringa che rappresenta il nome ereditato che funge da chiave di un'istanza di file logica all'interno di un file system. È necessario specificare i nomi completi dei percorsi. Esempio: C:\Windows\system\win.ini

Questa proprietà viene ereditata da CIM_LogicalFile.

Percorso

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Fisso, Schema ("Win32"), DisplayName ("Path")

Percorso del file. Il percorso include le barre rovesciata iniziali e finali, ma non la lettera di unità o il nome della cartella.

Per la cartella c:\windows\system32\wbem, il percorso è \windows\system32\. Per la cartella c:\scripts, il percorso è \.

Questa proprietà viene ereditata da CIM_LogicalFile.

Leggibile

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("leggibile")

Indica se è possibile leggere gli elementi nella cartella . Se True, il file può essere letto.

Questa proprietà viene ereditata da CIM_LogicalFile.

Status

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MaxLen (10), DisplayName ("Status")

Stringa che indica lo stato corrente dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sono inclusi i valori seguenti:

OK ("OK")

Errore ("Errore ")

Danneggiato ("danneggiato ")

Sconosciuto ("Sconosciuto ")

Pred Fail ("Pred Fail ")

Avvio ("Avvio ")

Arresto ("arresto ")

Servizio ("Servizio ")

Sottolineato ("sottolineato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto")

Lost Comm ("Lost Comm")

Sistema

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("File di sistema")

Indica se l'oggetto è un file di sistema. Se True, il file è un file di sistema

Questa proprietà viene ereditata da CIM_LogicalFile.

Scrivibile

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Scrivibile")

Se True, il file può essere scritto.

Questa proprietà viene ereditata da CIM_LogicalFile.

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

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Spazio dei nomi	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

CIM_Directory
Classi del sistema operativo

Condividi tramite

classe Win32_Directory

Sintassi

Members

Metodi

Proprietà

Commenti

Esempio

Requisiti

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive