Win32_Share 클래스

아티클
11/30/2023

Win32_Share 클래스는 Windows를 실행하는 컴퓨터 시스템의 공유 리소스를 나타냅니다. 디스크 드라이브, 프린터, 프로세스 간 통신 또는 기타 공유 가능한 디바이스일 수 있습니다. WMI 클래스를 검색하는 방법에 대한 자세한 내용은 클래스 검색을 참조 하세요.

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

구문

[Dynamic, Provider("CIMWin32"), UUID("{8502C4D6-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), AMENDMENT]
class Win32_Share : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  uint32   AccessMask;
  boolean  AllowMaximum;
  uint32   MaximumAllowed;
  string   Name;
  string   Path;
  uint32   Type;
};

멤버

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

메서드
속성

메서드

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

메서드	설명
만들기	서버 리소스에 대한 공유를 시작하는 클래스 메서드입니다.
Delete	공유 리소스에 대한 연결이 끊어지도록 서버의 공유 리소스 목록에서 공유 이름을 삭제하는 클래스 메서드입니다.
GetAccessMask	인스턴스를 대신하여 반환되는 사용자 또는 그룹이 보유한 공유에 대한 액세스 권한을 반환합니다. 항상 NULL인 AccessMask 속성 대신 이 메서드를 사용해야 합니다.
SetShareInfo	공유 리소스의 매개 변수를 설정하는 클래스 메서드입니다.

속성

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

AccessMask

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 사용되지 않음

이 속성은 사용되지 않으며 더 이상 사용되지 않습니다. 대신 Win32_Share.GetAccessMask 메서드를 사용합니다. AccessMask 속성의 값은 WMI에 의해 null로 설정됩니다. 공유를 만들 때 액세스를 설정하는 방법에 대한 자세한 내용은 Create 메서드를 참조하세요.

AllowMaximum

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API|네트워크 관리 구조|SHARE_INFO_502|shi502_max_uses")

이 리소스에 대한 동시 사용자 수가 제한되었습니다. True이면 MaximumAllowed 속성의 값이 무시됩니다.

캡션

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

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

이 속성은 CIM_ManagedSystemElement 상속됩니다.

설명

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

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

이 속성은 CIM_ManagedSystemElement 상속됩니다.

InstallDate

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

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

이 속성은 CIM_ManagedSystemElement 상속됩니다.

MaximumAllowed

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API|네트워크 관리 구조|SHARE_INFO_502|shi502_max_uses")

이 리소스를 동시에 사용할 수 있는 최대 사용자 수를 제한합니다. 값은 AllowMaximum 속성이 FALSE로 설정된 경우에만 유효합니다.

이름

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 키, 재정의("이름"), MappingStrings("Win32API|네트워크 관리 구조|SHARE_INFO_1|shi1_netname")

Windows를 실행하는 컴퓨터 시스템에서 공유로 설정된 경로에 지정된 별칭입니다.

Windows 2008 예제: "\SERVER01\public" - Windows Server 2008에서는 UNC를 이름에 배치해야 합니다.

Path

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API|네트워크 관리 구조|SHARE_INFO_502|shi502_path")

Windows 공유의 로컬 경로입니다.

예: "C:\Program Files"

상태

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

개체의 현재 상태 나타내는 문자열입니다. 운영 및 비작동 상태 정의할 수 있습니다. 작동 상태 "OK", "Degraded" 및 "Pred Fail"을 포함할 수 있습니다. "Pred Fail"은 요소가 제대로 작동하지만 오류를 예측하고 있음을 나타냅니다(예: SMART 지원 하드 디스크 드라이브).

비작동 상태 "오류", "시작", "중지" 및 "서비스"를 포함할 수 있습니다. "서비스"는 디스크 미러 다시 실행, 사용자 권한 목록 다시 로드 또는 기타 관리 작업 중에 적용할 수 있습니다. 이러한 모든 작업이 온라인 상태인 것은 아니지만 관리되는 요소는 "OK"도 아니고 다른 상태 중 하나도 아닙니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

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

확인 ("확인")

오류 ("오류")

성능이 저하됨 ("Degraded")

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

사전 실패 ("사전 실패")

시작 ("시작")

중지 ("중지")

서비스 ("서비스")

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

NonRecover ("NonRecover")

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

로스트 커밋 ("로스트 커밋")

Type

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API|네트워크 관리 구조|SHARE_INFO_502|shi502_type")

공유되는 리소스의 유형입니다. 유형은 디스크 드라이브, 인쇄 큐, IPC(프로세스 간 통신) 및 일반 디바이스입니다.

디스크 드라이브 (0)

인쇄 큐 (1)

디바이스 (2)

IPC (3)

디스크 드라이브 관리(2147483648)

인쇄 큐 관리(2147483649)

디바이스 관리(2147483650)

IPC 관리(2147483651)

설명

Win32_Share 클래스는 CIM_LogicalElement 파생됩니다.

이 클래스의 Create 메서드는 정적 메서드입니다. Delete, GetAccessMask 및 SetShareInfo 메서드는 모두 인스턴스 메서드입니다.

보안 권한에 따라 이 클래스의 모든 속성을 검색하지 못할 수 있습니다. 예를 들어 AllowMaximum, MaximumAllowed, Path 및 Type 속성은 null을 반환할 수 있습니다. 일반적으로 Power Users 및 관리istrators는 모든 속성 값을 검색할 수 있습니다.

예제

다음 PowerShell 샘플은 로컬 시스템의 공유를 표시합니다.

$shares = Get-WMIObject -class Win32_share
"Shares on : {0}" -f $((gwmi win32_computersystem).name)
$shares | sort name | ft -auto

또는 보다 정확하게 필터링하려는 경우 다음 PowerShell 코드 조각을 사용할 수 있습니다.

gwmi -q "SELECT * FROM Win32_Share WHERE Name != 'ADMIN$' AND Name != 'IPC$'"

다음 VBScript 샘플은 로컬 시스템의 공유를 표시합니다.

strComputer = "." 
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2") 
Set colItems = objWMIService.ExecQuery("SELECT * FROM Win32_Share")


For Each objItem in colItems 
 Wscript.Echo "Name: " & objItem.Name
 Wscript.Echo "Caption: " & objItem.Caption & "=" & objItem.Path
Next

요구 사항

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

참고 항목

CIM_LogicalElement
운영 체제 클래스
WMI 작업: 파일 및 폴더

다음을 통해 공유

Win32_Share 클래스

구문

멤버

메서드

속성

설명

예제

요구 사항

참고 항목

피드백

추가 리소스