Win32_Share 클래스

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 클래스에는 이러한 메서드가 있습니다.

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

 

속성

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

AccessMask

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: 사용되지 않음

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

AllowMaximum

데이터 형식: 부울

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 네트워크 관리 구조| SHARE_INFO_502|shi502_max_uses")

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

캡션

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: 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 상속됩니다.

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

확인 ("확인")

오류 ("오류")

성능 저하됨 ("성능 저하")

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

Pred Fail ("Pred Fail")

시작 ("시작")

중지 ("중지")

서비스 ("서비스")

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

NonRecover ("NonRecover")

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

Lost Comm ("Lost Comm")

형식

데이터 형식: 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, GetAccessMaskSetShareInfo 메서드는 모두 인스턴스 메서드입니다.

보안 권한에 따라 이 클래스의 모든 속성을 검색할 수 없습니다. 예를 들어 AllowMaximum, MaximumAllowed, PathType 속성은 null을 반환할 수 있습니다. 일반적으로 전원 사용자 및 관리자는 모든 속성 값을 검색할 수 있습니다.

예제

다음 Script Centercode 예제 에서는 컴퓨터의 모든 공유를 나열하고 각 공유에 대한 모든 공유 권한을 나열합니다.

Win32_Share PowerShell 샘플 쿼리와 유사한 공유 정보 가져오기 는 Win32_Share 결과를 제공합니다.

다음 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 작업: 파일 및 폴더