Win32_NetworkConnection 클래스

아티클
06/12/2023

Win32_NetworkConnectionWMI 클래스는 Windows 기반 환경에서 활성 네트워크 연결을 나타냅니다.

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

구문

[Dynamic, Provider("CIMWin32"), UUID("{8502C4CD-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkConnection : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  uint32   AccessMask;
  string   Comment;
  string   ConnectionState;
  string   ConnectionType;
  string   DisplayType;
  string   LocalName;
  string   Name;
  boolean  Persistent;
  string   ProviderName;
  string   RemoteName;
  string   RemotePath;
  string   ResourceType;
  string   UserName;
};

멤버

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

속성

속성

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

AccessMask

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

instance 대신 반환되는 사용자 또는 그룹이 보유한 지정된 파일 또는 디렉터리에 대한 액세스 권한 목록입니다. FAT 볼륨에서 FULL_ACCESS 값이 대신 반환되어 개체에 대한 보안이 설정되지 않았음을 나타냅니다.

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)

DACL(임의 액세스 제어 목록)에 대한 쓰기 권한을 부여합니다.

WRITE_OWNER (524288)

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

SYNCHRONIZE (1048576)

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

캡션

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

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

이 속성은 CIM_ManagedSystemElement 상속됩니다.

설명

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API| Windows 네트워킹 구조| NETRESOURCE|lpComment")

네트워크 공급자가 제공한 주석입니다.

ConnectionState

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

네트워크 연결의 현재 상태입니다.

연결 됨("연결됨")

오류 ("오류")

일시 중지됨 ("일시 중지됨")

연결 끊김 ("연결 끊김")

연결 ("연결")

다시 연결 ("다시 연결")

ConnectionType

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API| Windows 네트워킹 구조| NETRESOURCE|dwScope")

네트워크에 연결하는 데 사용되는 연결의 지속성 유형입니다.

현재 연결 ("현재 연결")

영구 연결 ("영구 연결")

설명

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

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

이 속성은 CIM_ManagedSystemElement 상속됩니다.

DisplayType

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API| Windows 네트워킹 구조| NETRESOURCE|dwDisplayType")

네트워크 개체는 네트워크 검색 사용자 인터페이스에 표시되어야 합니다.

도메인 ("도메인")

제네릭 ("제네릭")

서버 ("서버")

공유 ("공유")

InstallDate

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

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

이 속성은 CIM_ManagedSystemElement 상속됩니다.

LocalName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API| Windows 네트워킹 구조| NETRESOURCE|lpLocalName")

연결된 네트워크 디바이스의 로컬 이름입니다.

예: "c:\public"

이름

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

현재 네트워크 연결의 이름입니다. RemoteName 및 LocalName의 값 조합입니다.

예: "\\NTRELEASE(c:\public)"

Persistent

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: MappingStrings ("Win32API| Windows 네트워킹 함수| WNetEnumResource")

연결은 다음 로그온에서 운영 체제에 의해 자동으로 다시 연결됩니다.

ProviderName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API| Windows 네트워킹 구조| NETRESOURCE|lpProvider")

리소스를 소유하는 공급자의 이름입니다. 공급자 이름을 알 수 없는 경우 이 속성은 NULL 일 수 있습니다.

RemoteName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API| Windows 네트워킹 구조| NETRESOURCE|lpRemoteName")

네트워크 리소스의 원격 네트워크 리소스 이름입니다. 현재 또는 영구 연결의 경우 RemoteName 에는 LocalName 속성의 값 이름과 연결된 네트워크 이름이 포함됩니다. RemoteName의 이름은 네트워크 공급자의 명명 규칙을 따라야 합니다.

예: "\\NTRELEASE"

RemotePath

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API| Windows 네트워킹 구조| NETRESOURCE|lpRemoteName")

네트워크 리소스에 대한 전체 경로입니다.

예: "\\infosrv1\public"

ResourceType

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API| Windows 네트워킹 구조| NETRESOURCE|dwType")

열거하거나 연결할 리소스의 유형입니다.

디스크 ("디스크")

인쇄 ("인쇄")

Any ("Any")

상태

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

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

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

이 속성은 CIM_ManagedSystemElement 상속됩니다.

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

OK ("OK")

오류 ("오류")

성능 저하됨 ("Degraded")

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

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

시작 중("시작")

중지 ("중지")

서비스 ("서비스")

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

NonRecover ("NonRecover")

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

Lost Comm ("Lost Comm")

UserName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MappingStrings ("Win32API| Windows 네트워킹 함수| WNetGetUser")

네트워크 연결을 설정하는 데 사용되는 사용자 이름 또는 기본 사용자 이름입니다.

예: "SYSTEM"

설명

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

예제

다음 VBScript 코드 샘플은 로컬 네트워크 연결에 대한 정보를 검색합니다.

On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\Root\CIMv2")
Set colItems = objWMIService.ExecQuery("Select * from Win32_NetworkConnection",,48)
For Each objItem in colItems
    Wscript.Echo "AccessMask: " & objItem.AccessMask
    Wscript.Echo "Caption: " & objItem.Caption
    Wscript.Echo "Comment: " & objItem.Comment
    Wscript.Echo "ConnectionState: " & objItem.ConnectionState
    Wscript.Echo "ConnectionType: " & objItem.ConnectionType
    Wscript.Echo "Description: " & objItem.Description
    Wscript.Echo "DisplayType: " & objItem.DisplayType
    Wscript.Echo "InstallDate: " & objItem.InstallDate
    Wscript.Echo "LocalName: " & objItem.LocalName
    Wscript.Echo "Name: " & objItem.Name
    Wscript.Echo "Persistent: " & objItem.Persistent
    Wscript.Echo "ProviderName: " & objItem.ProviderName
    Wscript.Echo "RemoteName: " & objItem.RemoteName
    Wscript.Echo "RemotePath: " & objItem.RemotePath
    Wscript.Echo "ResourceType: " & objItem.ResourceType
    Wscript.Echo "Status: " & objItem.Status
    Wscript.Echo "UserName: " & objItem.UserName
Next

요구 사항

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

추가 정보

CIM_LogicalElement
운영 체제 클래스

다음을 통해 공유

Win32_NetworkConnection 클래스

구문

멤버

속성

설명

예제

요구 사항

추가 정보

피드백

추가 리소스