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
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 |
|
| DLL |
|
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per