Win32_Directory clase

Artículo
06/03/2023

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
Propiedades

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	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

CIM_Directory
Clases de sistema operativo

Compartir a través de

Win32_Directory clase

Sintaxis

Miembros

Métodos

Propiedades

Comentarios

Ejemplos

Requisitos

Consulte también

Comentarios

Recursos adicionales