Win32_Share 클래스의 SetShareInfo 메서드

SetShareInfoWMI 클래스 메서드는 공유 리소스의 매개 변수를 설정합니다.

이 항목에서는 MOF(Managed Object Format) 구문을 사용합니다. 이 메서드를 사용하는 방법에 대한 자세한 내용은 메서드 호출을 참조하세요.

구문

uint32 SetShareInfo(
  [in, optional] uint32                   MaximumAllowed,
  [in, optional] string                   Description,
  [in, optional] Win32_SecurityDescriptor Access
);

매개 변수

MaximumAllowed [in, optional]

이 리소스를 동시에 사용할 수 있는 최대 사용자 수를 제한합니다.

예: 10. 이 매개 변수는 선택 사항입니다.

설명 [in, optional]

공유되는 리소스를 설명하는 선택적 주석입니다.

액세스 [in, 선택 사항]

사용자 수준 권한에 대한 보안 설명자입니다. 보안 설명자에는 리소스의 권한, 소유자 및 액세스 기능에 대한 정보가 포함되어 있습니다. 자세한 내용은 Win32_SecurityDescriptor 참조하세요.

반환 값

다음 목록에 나열된 값 중 하나 또는 오류를 나타내는 다른 값을 반환합니다.

성공 (0)

액세스 거부됨 (2)

알 수 없는 오류 (8)

잘못된 이름 (9)

잘못된 수준 (10)

잘못된 매개 변수 (21)

중복 공유 (22)

리디렉션된 경로 (23)

알 수 없는 디바이스 또는 디렉터리 (24)

Net 이름을 찾을 수 없음 (25)

기타 (26개 4294967295)

설명

SetShareInfo 메서드는 동적 개체 메서드이며 이 클래스의 발생에 사용됩니다.

관리자 또는 계정 연산자 로컬 그룹의 구성원 또는 Communication, Print 또는 Server 연산자 그룹 구성원만 SetShareInfo를 성공적으로 실행할 수 있습니다. 인쇄 연산자는 프린터 큐만 설정할 수 있습니다. 통신 운영자는 통신 디바이스 큐만 설정할 수 있습니다.

예제

다음 PowerShell 샘플에서는 newShare 공유의 이름을 업데이트합니다.

$newShare = Get-WmiObject win32_share | Where-Object {$_.name -eq "newShare"}
[void]$newShare.SetShareInfo($null,"This is my new description",$null)

요구 사항

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

추가 정보

운영 체제 클래스

Win32_Share