Win32_Directory 클래스

아티클
06/12/2023

Win32_DirectoryWMI 클래스는 Windows를 실행하는 컴퓨터 시스템의 디렉터리 항목을 나타냅니다. 디렉터리 는 데이터 파일을 논리적으로 그룹화하고 그룹화된 파일에 대한 경로 정보를 제공하는 파일 형식입니다. 예: C:\TEMP. Win32_Directory 네트워크 드라이브의 디렉터리를 포함하지 않습니다.

다음 구문은 MOF(Managed Object Format) 코드를 단순화한 것으로 상속된 속성이 모두 포함되어 있습니다. 속성은 MOF 순서가 아닌 알파벳순으로 나열됩니다.

구문

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

멤버

Win32_Directory 클래스에는 다음과 같은 유형의 멤버가 있습니다.

메서드
속성

메서드

Win32_Directory 클래스에는 이러한 메서드가 있습니다.

메서드	설명
ChangeSecurityPermissions	개체 경로에 지정된 논리 파일에 대한 보안 권한을 변경하는 클래스 메서드입니다.
ChangeSecurityPermissionsEx	개체 경로에 지정된 논리 파일에 대한 보안 권한을 변경하는 클래스 메서드입니다.
압축	개체 경로에 지정된 논리 파일(또는 디렉터리)을 압축하는 클래스 메서드입니다.
CompressEx	개체 경로에 지정된 논리 파일(또는 디렉터리)을 압축하는 클래스 메서드입니다.
복사	개체 경로에 지정된 논리 파일 또는 디렉터리를 입력 매개 변수로 지정된 위치에 복사하는 클래스 메서드입니다.
CopyEx	개체 경로에 지정된 논리 파일 또는 디렉터리를 FileName 매개 변수로 지정된 위치에 복사하는 클래스 메서드입니다.
삭제	개체 경로에 지정된 논리 파일(또는 디렉터리)을 삭제하는 클래스 메서드입니다.
DeleteEx	개체 경로에 지정된 논리 파일(또는 디렉터리)을 삭제하는 클래스 메서드입니다.
GetEffectivePermission	호출자에게 파일 개체뿐만 아니라 공유에 대한 Permissions 인수로 지정된 집계된 사용 권한이 있는지 여부를 결정하는 클래스 메서드입니다(공유에 있는 경우).
이름 바꾸기	개체 경로에 지정된 논리 파일(또는 디렉터리)의 이름을 바꾸는 클래스 메서드입니다.
TakeOwnerShip	개체 경로에 지정된 논리 파일의 소유권을 가져오는 클래스 메서드입니다.
TakeOwnerShipEx	개체 경로에 지정된 논리 파일의 소유권을 가져오는 클래스 메서드입니다.
압축	개체 경로에 지정된 논리 파일(또는 디렉터리)의 압축을 해제하는 클래스 메서드입니다.
UncompressEx	개체 경로에 지정된 논리 파일(또는 디렉터리)의 압축을 해제하는 클래스 메서드입니다.

속성

Win32_Directory 클래스에는 이러한 속성이 있습니다.

AccessMask

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32"), DisplayName ("액세스 권한")

디렉터리에 대한 특정 작업에 액세스하거나 수행하는 데 필요한 액세스 권한을 나타내는 비트 마스크입니다. 비트 값은 파일 및 디렉터리 액세스 권한 상수를 참조하세요.

참고

FAT 볼륨에서 FULL_ACCESS 값이 대신 반환됩니다. 이는 개체에 대한 보안이 설정되지 않음을 나타냅니다.

이 속성은 CIM_LogicalFile 상속됩니다.

FILE_READ_DATA(파일) 또는 FILE_LIST_DIRECTORY(디렉터리)( 1)

파일에서 데이터를 읽을 수 있는 권한을 부여합니다. 디렉터리의 경우 이 값은 디렉터리의 콘텐츠를 나열할 수 있는 권한을 부여합니다.

FILE_WRITE_DATA(파일) 또는 FILE_ADD_FILE(디렉터리)( 2)

파일에 데이터를 쓸 수 있는 권한을 부여합니다. 디렉터리의 경우 이 값은 디렉터리에 파일을 만들 수 있는 권한을 부여합니다.

FILE_APPEND_DATA(파일) 또는 FILE_ADD_SUBDIRECTORY (4)

파일에 데이터를 추가할 수 있는 권한을 부여합니다. 디렉터리의 경우 이 값은 하위 디렉터리를 만들 수 있는 권한을 부여합니다.

FILE_READ_EA (8)

확장 특성을 읽을 수 있는 권한을 부여합니다.

FILE_WRITE_EA (16)

확장 특성을 작성할 수 있는 권한을 부여합니다.

FILE_EXECUTE(파일) 또는 FILE_TRAVERSE(디렉터리)( 32)

파일을 실행할 수 있는 권한을 부여합니다. 디렉터리의 경우 디렉터리를 트래버스할 수 있습니다.

FILE_DELETE_CHILD(디렉터리) (64)

파일이 읽기 전용인 경우에도 디렉터리와 디렉터리에 포함된 모든 파일(해당 자식)을 삭제할 수 있는 권한을 부여합니다.

FILE_READ_ATTRIBUTES (128)

파일 특성을 읽을 수 있는 권한을 부여합니다.

FILE_WRITE_ATTRIBUTES (256)

파일 특성을 변경할 수 있는 권한을 부여합니다.

DELETE (65536)

삭제 액세스 권한을 부여합니다.

READ_CONTROL (131072)

보안 설명자 및 소유자에 대한 읽기 권한을 부여합니다.

WRITE_DAC (262144)

임의 ACL에 대한 쓰기 권한을 부여합니다.

WRITE_OWNER (524288)

쓰기 소유자를 할당합니다.

SYNCHRONIZE (1048576)

액세스를 동기화하고 프로세스에서 개체가 신호 상태가 될 때까지 대기할 수 있습니다.

ACCESS_SYSTEM_SECURITY (18809343)

개체의 보안 설명자에서 SACL을 얻거나 설정하는 기능을 제어합니다.

보관

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32"), DisplayName ("보관해야 함")

폴더의 보관 비트가 설정되었는지 여부를 나타냅니다. 보관 비트는 백업 프로그램에서 백업해야 하는 파일을 식별하는 데 사용됩니다. True이면 파일을 보관해야 합니다.

이 속성은 CIM_LogicalFile 상속됩니다.

캡션

데이터 형식: string
액세스 형식: 읽기 전용
한정자: MaxLen (64), DisplayName ("Caption")

개체에 대한 간단한 텍스트 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

Compressed

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32"), DisplayName ("압축됨")

폴더가 압축되었는지 여부를 나타냅니다. WMI는 WMI 자체를 사용하거나 그래픽 사용자 인터페이스를 사용하여 압축된 폴더를 인식합니다. 그러나 .ZIP 파일을 압축된 것으로 인식하지는 않습니다. True이면 파일이 압축됩니다.

이 속성은 CIM_LogicalFile 상속됩니다.

CompressionMethod

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: DisplayName ("압축 방법")

논리 파일을 압축하는 데 사용되는 알고리즘 또는 도구(일반적으로 메서드)입니다. 압축 체계를 설명할 수 없거나 원하지 않는 경우(알 수 없기 때문일 수 있음) 다음 단어를 사용합니다. "Unknown"을 사용하여 논리 파일이 압축되었는지 여부를 알 수 없음을 나타냅니다. 파일이 압축되었지만 압축 체계가 알려지지 않았거나 공개되지 않음을 나타내는 "압축"입니다. 및 논리 파일이 압축되지 않음을 나타내는 "압축되지 않음"입니다.

이 속성은 CIM_LogicalFile 상속됩니다.

CreationClassName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: CIM_Key, DisplayName ("클래스 이름")

instance 만드는 데 사용되는 상속 체인에 표시할 첫 번째 구체적인 클래스의 이름입니다. 클래스의 다른 키 속성과 함께 사용할 경우 이 속성을 사용하면 이 클래스의 모든 인스턴스와 해당 하위 클래스를 고유하게 식별할 수 있습니다.

이 속성은 CIM_LogicalFile 상속됩니다.

CreationDate

데이터 형식: datetime
액세스 형식: 읽기 전용
한정자: DisplayName ("만들기 날짜")

파일 시스템 개체를 만든 날짜입니다. WMI 날짜 및 시간 형식 작업에 대한 자세한 내용은 WMI 작업: 날짜 및 시간을 참조하세요.

이 속성은 CIM_LogicalFile 상속됩니다.

CSCreationClassName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 전파됨 ("CIM_FileSystem. CSCreationClassName"), CIM_Key, DisplayName ("컴퓨터 시스템 클래스 이름")

범위 지정 컴퓨터 시스템의 생성 클래스 이름입니다.

이 속성은 CIM_LogicalFile 상속됩니다.

CSName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 전파됨 ("CIM_FileSystem. CSName"), CIM_Key, DisplayName ("컴퓨터 시스템 이름")

파일 시스템 개체가 저장되는 컴퓨터의 이름입니다.

이 속성은 CIM_LogicalFile 상속됩니다.

설명

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: DisplayName ("Description")

개체에 대한 텍스트 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

드라이브

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 고정, 스키마 ("Win32"), DisplayName ("드라이브")

파일 시스템 개체가 저장되는 드라이브의 드라이브 문자(콜론 포함)입니다.

예: "c:"

이 속성은 CIM_LogicalFile 상속됩니다.

EightDotThreeFileName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32"), DisplayName ("8점 3 파일 이름")

MS-DOS -호환되는 폴더 이름입니다.

예: "c:\progra~1"

이 속성은 CIM_LogicalFile 상속됩니다.

암호화됨

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32"), DisplayName ("Encrypted")

폴더가 암호화되었는지 여부를 나타냅니다. True이면 폴더가 암호화됩니다.

이 속성은 CIM_LogicalFile 상속됩니다.

EncryptionMethod

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: DisplayName ("암호화 방법")

논리 파일을 암호화하는 데 사용되는 알고리즘 또는 도구입니다. 암호화 체계를 설명할 수 없거나 원하지 않는 경우(보안상의 이유로) 다음 단어를 사용합니다. "알 수 없음"을 사용하여 논리 파일이 암호화되었는지 여부를 알 수 없음을 나타냅니다. 파일이 암호화되었지만 암호화 체계를 알 수 없거나 공개되지 않음을 나타내는 "암호화됨"입니다. 및 논리 파일이 암호화되지 않음을 나타내는 "Not Encrypted"입니다.

이 속성은 CIM_LogicalFile 상속됩니다.

내선 번호

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 수정됨, 스키마 ("Win32"), DisplayName ("파일 확장명")

확장명을 파일 이름과 구분하는 점(.)을 포함하지 않고 파일 시스템 개체의 파일 이름 확장명입니다.

예: "txt", "mof", "mdb"

이 속성은 CIM_LogicalFile 상속됩니다.

FileName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 수정됨, 스키마 ("Win32"), DisplayName ("파일 이름")

파일의 파일 이름(점 또는 확장명 없음)입니다.

예: "autoexec"

이 속성은 CIM_LogicalFile 상속됩니다.

FileSize

데이터 형식: uint64
액세스 형식: 읽기 전용
한정자: DisplayName ("Size"), 단위 ("바이트")

파일 시스템 개체의 크기(바이트)입니다. 폴더에는 FileSize 속성이 있지만 값 0은 항상 반환됩니다. 폴더의 크기를 확인하려면 FileSystemObject를 사용하거나 폴더에 저장된 모든 파일의 크기를 추가합니다.

스크립트에서 uint64 값을 사용하는 방법에 대한 자세한 내용은 WMI 스크립트 만들기를 참조하세요.

이 속성은 CIM_LogicalFile 상속됩니다.

FileType

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32"), DisplayName ("파일 형식")

파일 형식( Extension 속성으로 표시됨).

예를 들어 .mdb 파일의 파일 형식은 Microsoft Access Application일 가능성이 높습니다. .asp 파일의 파일 형식이 HTML 문서일 수 있습니다. 폴더는 일반적으로 단순히 폴더로 보고됩니다.

이 속성은 CIM_LogicalFile 상속됩니다.

FSCreationClassName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 전파됨 ("CIM_FileSystem. CreationClassName"), CIM_Key, DisplayName ("파일 시스템 클래스 이름")

파일 시스템의 클래스입니다.

이 속성은 CIM_LogicalFile 상속됩니다.

FSName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 전파됨 ("CIM_FileSystem. 이름"), CIM_Key, DisplayName ("파일 시스템 이름")

파일 또는 폴더가 있는 드라이브에 설치된 파일 시스템 유형(NTFS, FAT, FAT32)입니다.

이 속성은 CIM_LogicalFile 상속됩니다.

숨김

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32"), DisplayName ("Hidden")

파일 시스템 개체가 숨겨져 있는지 여부를 나타냅니다. True이면 파일이 숨겨집니다.

이 속성은 CIM_LogicalFile 상속됩니다.

InstallDate

데이터 형식: datetime
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("설치 날짜")

개체가 설치된 시기를 나타냅니다. 값이 부족해도 개체가 설치되지 않았음을 의미하지는 않습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

InUseCount

데이터 형식: uint64
액세스 형식: 읽기 전용
한정자: DisplayName ("현재 파일 열기 수")

파일에 대해 현재 활성 상태인 "파일 열기"의 수입니다.

이 속성은 CIM_LogicalFile 상속됩니다.

스크립트에서 uint64 값을 사용하는 방법에 대한 자세한 내용은 WMI 스크립트 만들기를 참조하세요.

LastAccessed

데이터 형식: datetime
액세스 형식: 읽기 전용
한정자: DisplayName ("마지막 액세스")

파일에 마지막으로 액세스한 날짜입니다. WMI 날짜 및 시간 형식 작업에 대한 자세한 내용은 WMI 작업: 날짜 및 시간을 참조하세요.

이 속성은 CIM_LogicalFile 상속됩니다.

LastModified

데이터 형식: datetime
액세스 형식: 읽기 전용
한정자: DisplayName ("마지막으로 수정됨")

파일이 마지막으로 수정된 날짜입니다. WMI 날짜 및 시간 형식 작업에 대한 자세한 내용은 WMI 작업: 날짜 및 시간을 참조하세요.

이 속성은 CIM_LogicalFile 상속됩니다.

이름

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: Key

Name 속성은 파일 시스템 내에서 instance 논리 파일의 키 역할을 하는 상속된 이름을 나타내는 문자열입니다. 전체 경로 이름을 제공해야 합니다. 예: C:\Windows\system\win.ini

이 속성은 CIM_LogicalFile 상속됩니다.

Path

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 고정, 스키마 ("Win32"), DisplayName ("경로")

파일의 경로입니다. 경로에는 선행 및 후행 백슬라이시가 포함되지만 드라이브 문자 또는 폴더 이름은 포함되지 않습니다.

c:\windows\system32\wbem 폴더의 경우 경로는 \windows\system32\입니다. c:\scripts 폴더의 경우 경로는 \입니다.

이 속성은 CIM_LogicalFile 상속됩니다.

가독성

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: DisplayName ("읽기 가능")

폴더의 항목을 읽을 수 있는지 여부를 나타냅니다. True이면 파일을 읽을 수 있습니다.

이 속성은 CIM_LogicalFile 상속됩니다.

상태

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MaxLen (10), DisplayName ("상태")

개체의 현재 상태 나타내는 문자열입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

여기에는 다음 값이 포함됩니다.

확인 ("확인")

오류 ("오류")

저하됨 ("성능 저하")

알 수 없음 ("알 수 없음")

Pred Fail ("Pred Fail")

시작 ("시작")

중지 ("중지")

서비스 ("서비스")

스트레스( "스트레스")

NonRecover ("NonRecover")

연락처 없음 ("연락처 없음")

Lost Comm ("Lost Comm")

시스템

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32"), DisplayName ("시스템 파일")

개체가 시스템 파일인지 여부를 나타냅니다. True이면 파일은 시스템 파일입니다.

이 속성은 CIM_LogicalFile 상속됩니다.

쓰기 가능

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: DisplayName ("쓰기 가능")

True이면 파일을 쓸 수 있습니다.

이 속성은 CIM_LogicalFile 상속됩니다.

설명

Win32_Directory 클래스는 CIM_Directory 파생됩니다.

개요

폴더는 다른 파일 시스템 개체를 포함하도록 설계된 파일 시스템 개체입니다. 그러나 모든 폴더가 비슷하다는 의미는 아닙니다. 대신 폴더는 상당히 다를 수 있습니다. 일부 폴더는 일반적으로 스크립트에서 수정해서는 안 되는 운영 체제 폴더입니다. 일부 폴더는 읽기 전용이므로 사용자가 해당 폴더의 내용에 액세스할 수 있지만 해당 내용을 추가, 삭제 또는 수정할 수는 없습니다. 일부 폴더는 최적의 스토리지를 위해 압축되는 반면 다른 폴더는 숨겨지고 사용자에게 표시되지 않습니다.

WMI는 Win32_Directory 클래스를 사용하여 폴더를 관리합니다. 이 클래스에서 사용할 수 있는 속성과 메서드는 파일을 관리하는 데 사용되는 클래스인 CIM_DataFile 클래스에서 사용할 수 있는 속성 및 메서드와 동일합니다. 즉, WMI를 사용하여 폴더를 관리하는 방법을 학습한 후에는 추가 작업 없이 파일을 관리하는 방법도 알게 됩니다.

Win32_Subdirectory 연결 클래스는 파일 및 폴더를 관리하는 데도 사용됩니다. Win32_Subdirectory 클래스는 폴더와 해당 직계 하위 폴더를 연결합니다. 예를 들어 폴더 구조 C:\Scripts\Logs에서 로그는 스크립트의 하위 폴더이고 스크립트는 루트 폴더 C:\의 하위 폴더입니다. 그러나 로그는 C:\의 하위 폴더로 간주되지 않습니다.

Win32_Directory 클래스를 사용하여 파일 시스템에서 폴더의 속성을 검색할 수 있습니다. 이 클래스를 사용하여 사용할 수 있는 속성은 표 11.1에 표시됩니다. 단일 폴더의 속성을 검색하려면 Win32_Directory 클래스에 대한 WQL(Windows 쿼리 언어) 쿼리를 생성하여 폴더 이름을 포함해야 합니다. 예를 들어 이 쿼리는 D:\Archive 폴더에 바인딩됩니다.

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

WQL 쿼리에서 파일 또는 폴더 이름을 지정할 때 두 개의 백슬래시(\\)를 사용하여 경로 구성 요소를 구분해야 합니다.

데이터 검색을 단일 디스크 드라이브로 제한하려면 드라이브 문자를 지정하는 Where 절을 포함합니다. 예를 들어 이 쿼리는 C 드라이브의 모든 폴더 목록을 반환합니다.

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

컴퓨터의 모든 폴더를 열거해야 하는 경우 이 쿼리를 완료하는 데 시간이 오래 걸릴 수 있습니다.

예제

다음 VBScript 샘플은 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

다음 VBScript 샘플에서는 컴퓨터의 숨겨진 모든 폴더 목록을 반환합니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
네임스페이스	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

추가 정보

CIM_Directory
운영 체제 클래스

다음을 통해 공유

Win32_Directory 클래스

구문

멤버

메서드

속성

설명

예제

요구 사항

추가 정보

피드백

추가 리소스