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 클래스에는 이러한 메서드가 있습니다.
| 메서드 | 설명 |
|---|---|
| 만들기 | 서버 리소스에 대한 공유를 시작하는 클래스 메서드입니다. |
| 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")
개체에 대한 간단한 텍스트 설명입니다.
-
-
설명
-
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
-
한정자: DisplayName ("Description")
개체에 대한 텍스트 설명입니다.
-
-
InstallDate
-
-
데이터 형식: datetime
-
액세스 형식: 읽기 전용
-
한정자: MappingStrings ("MIF. DMTF|ComponentID|001.5"), DisplayName ("설치 날짜")
개체가 설치된 시기를 나타냅니다. 값이 부족해도 개체가 설치되지 않았음을 의미하지는 않습니다.
-
-
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 |
|
| DLL |
|
참고 항목
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기