Win32_Directory clase
La Win32_Directoryclase WMI representa una entrada de directorio en un sistema informático que ejecuta Windows. Un directorio es un tipo de archivo que agrupa lógicamente los archivos de datos y proporciona información de ruta de acceso para los archivos agrupados. Ejemplo: C:\TEMP. Win32_Directory no incluye directorios de unidades de red.
La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades se enumeran en orden alfabético, no en orden MOF.
Sintaxis
[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;
};
Miembros
La clase Win32_Directory tiene estos tipos de miembros:
Métodos
La clase Win32_Directory tiene estos métodos.
| Método | Descripción |
|---|---|
| ChangeSecurityPermissions | Método de clase que cambia los permisos de seguridad para el archivo lógico especificado en la ruta de acceso del objeto. |
| ChangeSecurityPermissionsEx | Método de clase que cambia los permisos de seguridad para el archivo lógico especificado en la ruta de acceso del objeto. |
| Comprimir | Método de clase que comprime el archivo lógico (o directorio) especificado en la ruta de acceso del objeto. |
| CompressEx | Método de clase que comprime el archivo lógico (o directorio) especificado en la ruta de acceso del objeto. |
| Copiar | Método de clase que copia el archivo lógico o directorio especificado en la ruta de acceso del objeto a la ubicación especificada por el parámetro de entrada. |
| CopyEx | Método de clase que copia el archivo lógico o directorio especificado en la ruta de acceso del objeto a la ubicación especificada por el parámetro FileName . |
| Eliminar | Método de clase que elimina el archivo lógico (o directorio) especificado en la ruta de acceso del objeto. |
| DeleteEx | Método de clase que elimina el archivo lógico (o directorio) especificado en la ruta de acceso del objeto. |
| GetEffectivePermission | Método de clase que determina si el autor de la llamada tiene los permisos agregados especificados por el argumento Permissions no solo en el objeto de archivo, sino en el recurso compartido en el que reside el archivo o directorio (si está en un recurso compartido). |
| Cambiar nombre | Método de clase que cambia el nombre del archivo lógico (o directorio) especificado en la ruta de acceso del objeto. |
| TakeOwnerShip | Método de clase que obtiene la propiedad del archivo lógico especificado en la ruta de acceso del objeto. |
| TakeOwnerShipEx | Método de clase que obtiene la propiedad del archivo lógico especificado en la ruta de acceso del objeto. |
| Descomprimir | Método de clase que descomprime el archivo lógico (o directorio) especificado en la ruta de acceso del objeto. |
| UncompressEx | Método de clase que descomprime el archivo lógico (o directorio) especificado en la ruta de acceso del objeto. |
Propiedades
La clase Win32_Directory tiene estas propiedades.
-
AccessMask
-
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Derechos de acceso")
Máscara de bits que representa los derechos de acceso necesarios para acceder o realizar operaciones específicas en el directorio. Para obtener valores de bits, consulte Constantes de derechos de acceso a archivos y directorios.
Nota
En los volúmenes FAT, se devuelve el valor de FULL_ACCESS en su lugar, lo que indica que no se ha establecido ninguna seguridad en el objeto .
Esta propiedad se hereda de CIM_LogicalFile.
-
-
FILE_READ_DATA (archivo) o FILE_LIST_DIRECTORY (directorio) ( 1)
-
Concede el derecho a leer datos del archivo. Para un directorio, este valor concede el derecho a enumerar el contenido del directorio.
-
FILE_WRITE_DATA (archivo) o FILE_ADD_FILE (directorio) ( 2)
-
Concede el derecho de escribir datos en el archivo. Para un directorio, este valor concede el derecho a crear un archivo en el directorio.
-
FILE_APPEND_DATA (archivo) o FILE_ADD_SUBDIRECTORY (4)
-
Concede el derecho de anexar datos al archivo. Para un directorio, este valor concede el derecho a crear un subdirectorio.
-
FILE_READ_EA (8)
-
Concede el derecho a leer atributos extendidos.
-
FILE_WRITE_EA (16)
-
Concede el derecho a escribir atributos extendidos.
-
FILE_EXECUTE (archivo) o FILE_TRAVERSE (directorio) ( 32)
-
Concede el derecho de ejecutar un archivo. Para un directorio, se puede recorrer el directorio.
-
FILE_DELETE_CHILD (directorio) ( 64)
-
Concede el derecho a eliminar un directorio y todos los archivos que contiene (sus elementos secundarios), incluso si los archivos son de solo lectura.
-
FILE_READ_ATTRIBUTES (128)
-
Concede el derecho a leer atributos de archivo.
-
FILE_WRITE_ATTRIBUTES (256)
-
Concede el derecho a cambiar los atributos de archivo.
-
DELETE (65536)
-
Concede acceso de eliminación.
-
READ_CONTROL (131072)
-
Concede acceso de lectura al descriptor de seguridad y al propietario.
-
WRITE_DAC (262144)
-
Concede acceso de escritura a la ACL discrecional.
-
WRITE_OWNER (524288)
-
Asigna el propietario de escritura.
-
SYNCHRONIZE (1048576)
-
Sincroniza el acceso y permite que un proceso espere a que un objeto entre en el estado señalado.
-
ACCESS_SYSTEM_SECURITY (18809343)
-
Controla la capacidad de obtener o establecer la SACL en el descriptor de seguridad de un objeto.
Archivar
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Debe archivarse")
Indica si se ha establecido el bit de archivo de la carpeta. Los programas de copia de seguridad usan el bit de archivo para identificar los archivos de los que se debe realizar una copia de seguridad. Si es True, se debe archivar el archivo.
Esta propiedad se hereda de CIM_LogicalFile.
Caption
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen (64), DisplayName ("Caption")
Una breve descripción textual del objeto.
Esta propiedad se hereda de CIM_ManagedSystemElement.
Compressed
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Comprimido")
Indica si la carpeta se ha comprimido o no. WMI reconoce carpetas comprimidas mediante WMI en sí o mediante la interfaz gráfica de usuario; sin embargo, no reconoce .ZIP archivos como comprimidos. Si es True, el archivo se comprime.
Esta propiedad se hereda de CIM_LogicalFile.
CompressionMethod
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Método de compresión")
Algoritmo o herramienta (normalmente un método) usado para comprimir el archivo lógico. Si no es posible (o no deseado) describir el esquema de compresión (quizás porque no se conoce), use las siguientes palabras: "Desconocido" para representar que no se sabe si el archivo lógico está comprimido; "Comprimido" para representar que el archivo está comprimido, pero su esquema de compresión no se conoce o no se revela; y "No comprimido" para representar que el archivo lógico no está comprimido.
Esta propiedad se hereda de CIM_LogicalFile.
CreationClassName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: CIM_Key, DisplayName ("Nombre de clase")
Nombre de la primera clase concreta que aparece en la cadena de herencia utilizada en la creación de una instancia. Cuando se usa con las demás propiedades clave de la clase , esta propiedad permite identificar todas las instancias de esta clase y sus subclases.
Esta propiedad se hereda de CIM_LogicalFile.
CreationDate
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Fecha de creación")
Fecha en que se creó el objeto del sistema de archivos. Para obtener más información sobre cómo trabajar con formatos de fecha y hora de WMI, vea Tareas WMI: fechas y horas.
Esta propiedad se hereda de CIM_LogicalFile.
CSCreationClassName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: propagados ("CIM_FileSystem. CSCreationClassName"), CIM_Key, DisplayName ("Nombre de clase de sistema de equipo")
Nombre de clase de creación del sistema de equipo de ámbito.
Esta propiedad se hereda de CIM_LogicalFile.
CSName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: propagados ("CIM_FileSystem. CSName"), CIM_Key, DisplayName ("Nombre del sistema de equipo")
Nombre del equipo donde se almacena el objeto del sistema de archivos.
Esta propiedad se hereda de CIM_LogicalFile.
Descripción
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Descripción")
Descripción textual del objeto.
Esta propiedad se hereda de CIM_ManagedSystemElement.
Conducir
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Fijo, Esquema ("Win32"), DisplayName ("Unidad")
Letra de unidad de la unidad (incluidos los dos puntos) donde se almacena el objeto del sistema de archivos.
Ejemplo: "c:"
Esta propiedad se hereda de CIM_LogicalFile.
EightDotThreeFileName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Ocho puntos tres nombre de archivo")
MS-DOS:nombre compatible con la carpeta.
Ejemplo: "c:\progra~1"
Esta propiedad se hereda de CIM_LogicalFile.
Cifrado
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Cifrado")
Indica si la carpeta se ha cifrado o no. Si es True, la carpeta está cifrada.
Esta propiedad se hereda de CIM_LogicalFile.
EncryptionMethod
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Método de cifrado")
Algoritmo o herramienta que se usa para cifrar el archivo lógico. Si no es posible (o no desea) describir el esquema de cifrado (quizás por motivos de seguridad), use las siguientes palabras: "Desconocido" para representar que no se sabe si el archivo lógico está cifrado; "Cifrado" para representar que el archivo está cifrado, pero su esquema de cifrado no se conoce o no se revela; y "No cifrado" para representar que el archivo lógico no está cifrado.
Esta propiedad se hereda de CIM_LogicalFile.
Extensión
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Fijo, Esquema ("Win32"), DisplayName ("Extensión de archivo")
Extensión de nombre de archivo para el objeto del sistema de archivos, no incluido el punto (.) que separa la extensión del nombre de archivo.
Ejemplos: "txt", "mof", "mdb"
Esta propiedad se hereda de CIM_LogicalFile.
FileName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Fijo, Esquema ("Win32"), DisplayName ("Nombre de archivo")
Nombre de archivo (sin el punto o la extensión) del archivo.
Ejemplo: "autoexec"
Esta propiedad se hereda de CIM_LogicalFile.
FileSize
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Size"), Units ("bytes")
Tamaño del objeto del sistema de archivos, en bytes. Aunque las carpetas poseen una propiedad FileSize , siempre se devuelve el valor 0. Para determinar el tamaño de una carpeta, use FileSystemObject o agregue el tamaño de todos los archivos almacenados en la carpeta.
Para más información sobre el uso de valores uint64 en scripts, vea Scripting in WMI.
Esta propiedad se hereda de CIM_LogicalFile.
FileType
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Tipo de archivo")
Tipo de archivo (indicado por la propiedad Extension ).
Por ejemplo, es probable que un archivo .mdb tenga el tipo de archivo Aplicación de Microsoft Access. Es probable que un archivo .asp tenga el tipo de archivo DOCUMENTO HTML. Las carpetas normalmente se notifican simplemente como Carpeta.
Esta propiedad se hereda de CIM_LogicalFile.
FSCreationClassName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: propagados ("CIM_FileSystem. CreationClassName"), CIM_Key, DisplayName ("Nombre de clase del sistema de archivos")
Clase del sistema de archivos.
Esta propiedad se hereda de CIM_LogicalFile.
FSName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: propagados ("CIM_FileSystem. Name"), CIM_Key, DisplayName ("Nombre del sistema de archivos")
Tipo de sistema de archivos (NTFS, FAT, FAT32) instalado en la unidad donde se encuentra el archivo o la carpeta.
Esta propiedad se hereda de CIM_LogicalFile.
Oculto
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Oculto")
Indica si el objeto del sistema de archivos está oculto. Si es True, el archivo está oculto.
Esta propiedad se hereda de CIM_LogicalFile.
InstallDate
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")
Indica cuándo se instaló el objeto. La falta de un valor no indica que el objeto no está instalado.
Esta propiedad se hereda de CIM_ManagedSystemElement.
InUseCount
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Recuento actual de apertura de archivos")
Número de "archivos abiertos" que están activos actualmente en el archivo.
Esta propiedad se hereda de CIM_LogicalFile.
Para más información sobre el uso de valores uint64 en scripts, vea Scripting in WMI.
LastAccessed
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Último acceso")
Fecha de acceso al archivo por última vez. Para obtener más información sobre cómo trabajar con formatos de fecha y hora de WMI, vea Tareas WMI: fechas y horas.
Esta propiedad se hereda de CIM_LogicalFile.
LastModified
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Última modificación")
Fecha en que se modificó por última vez el archivo. Para obtener más información sobre cómo trabajar con formatos de fecha y hora de WMI, vea Tareas WMI: fechas y horas.
Esta propiedad se hereda de CIM_LogicalFile.
Nombre
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Clave
La propiedad Name es una cadena que representa el nombre heredado que actúa como clave de una instancia de archivo lógico dentro de un sistema de archivos. Se deben proporcionar nombres de ruta de acceso completos. Ejemplo: C:\Windows\system\win.ini
Esta propiedad se hereda de CIM_LogicalFile.
Ruta de acceso
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Fijo, Esquema ("Win32"), DisplayName ("Path")
Ruta de acceso del archivo. La ruta de acceso incluye las barras diagonales inversas iniciales y finales, pero no la letra de unidad ni el nombre de la carpeta.
Para la carpeta c:\windows\system32\wbem, la ruta de acceso es \windows\system32\. Para la carpeta c:\scripts, la ruta de acceso es \.
Esta propiedad se hereda de CIM_LogicalFile.
Legible
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Legible")
Indica si puede leer elementos en la carpeta. Si es True, se puede leer el archivo.
Esta propiedad se hereda de CIM_LogicalFile.
Estado
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen (10), DisplayName ("Status")
Cadena que indica el estado actual del objeto.
Esta propiedad se hereda de CIM_ManagedSystemElement.
Los valores son los siguientes:
Ok ("OK")
Error ("Error")
Degradado ("Degradado")
Desconocido ("Desconocido")
Error previo ("Error previo")
Inicio ("Inicio")
Detener ("Detener")
Servicio ("Servicio")
Estresado ("Estresado")
NonRecover ("NonRecover")
Sin contacto ("Sin contacto")
Lost Comm ("Lost Comm")
Sistema
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32"), DisplayName ("Archivo del sistema")
Indica si el objeto es un archivo del sistema. Si es True, el archivo es un archivo del sistema.
Esta propiedad se hereda de CIM_LogicalFile.
Writeable (Grabable)
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Writeable")
Si es True, se puede escribir el archivo.
Esta propiedad se hereda de CIM_LogicalFile.
Comentarios
La clase Win32_Directory se deriva de CIM_Directory.
Información general
Las carpetas son objetos del sistema de archivos diseñados para contener otros objetos del sistema de archivos. Sin embargo, esto no significa que todas las carpetas sean iguales. En su lugar, las carpetas pueden variar considerablemente. Algunas carpetas son carpetas del sistema operativo, que por lo general no deben modificarse mediante un script. Algunas carpetas son de solo lectura, lo que significa que los usuarios pueden acceder al contenido de esa carpeta, pero no pueden agregarlos, eliminarlos o modificarlos. Algunas carpetas se comprimen para un almacenamiento óptimo, mientras que otras están ocultas y no son visibles para los usuarios.
WMI usa la clase Win32_Directory para administrar carpetas. Significativamente, las propiedades y los métodos disponibles en esta clase son idénticos a las propiedades y métodos disponibles en la clase CIM_DataFile , la clase utilizada para administrar archivos. Esto significa que después de haber aprendido a administrar carpetas mediante WMI, usted, sin ningún trabajo adicional, también sabe cómo administrar archivos.
La clase de asociación Win32_Subdirectory también se usa para administrar archivos y carpetas. La clase Win32_Subdirectory relaciona una carpeta y sus subcarpetas inmediatas. Por ejemplo, en la estructura de carpetas C:\Scripts\Logs, Logs es una subcarpeta de Scripts y Scripts es una subcarpeta de la carpeta raíz C:\. Sin embargo, los registros no se consideran una subcarpeta de C:\.
Puede recuperar las propiedades de cualquier carpeta del sistema de archivos mediante la clase Win32_Directory . Las propiedades disponibles con esta clase se muestran en la tabla 11.1. Para recuperar las propiedades de una sola carpeta, construya una consulta del lenguaje de consulta de Windows (WQL) para la clase Win32_Directory , asegurándose de incluir el nombre de la carpeta. Por ejemplo, esta consulta se enlaza a la carpeta D:\Archive:
Copy "SELECT * FROM Win32_Directory WHERE Name = 'D:\\Archive'"
Al especificar un nombre de archivo o carpeta en una consulta WQL, asegúrese de usar dos barras diagonales inversas (\\) para separar los componentes de ruta de acceso.
Si desea limitar la recuperación de datos a una sola unidad de disco, incluya una cláusula Where que especifique la letra de unidad. Por ejemplo, esta consulta devuelve una lista de todas las carpetas de la unidad C:
"SELECT * FROM Win32_Directory WHERE Drive = 'C:'"
Si necesita enumerar todas las carpetas de un equipo, tenga en cuenta que esta consulta puede tardar mucho tiempo en completarse.
Ejemplos
En el siguiente ejemplo de VBScript se recuperan las propiedades de la carpeta 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
El siguiente ejemplo de VBScript devuelve una lista de todas las carpetas ocultas de un equipo.
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 | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de