Msvm_VirtualEthernetSwitch 클래스

가상 이더넷 스위치를 나타냅니다. 각 스위치에는 네트워크 어댑터를 연결할 수 있는 다양한 포트가 있습니다. 스위치 자체는 매우 구성할 수 없으며 주로 자리 표시자 역할을 합니다.

다음 구문은 간소화된 MOF(Managed Object Format) 코드이며 상속된 모든 속성을 포함합니다.

구문

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualEthernetSwitch : CIM_ComputerSystem
{
  string   InstanceID;
  string   Caption = "Virtual Switch";
  string   Description = "Microsoft Virtual Switch";
  string   ElementName;
  datetime InstallDate;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   CreationClassName = "Msvm_VirtualEthernetSwitch";
  string   Name = "GUID";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   Roles[];
  string   NameFormat;
  string   OtherIdentifyingInfo[];
  string   IdentifyingDescriptions[];
  uint16   Dedicated[];
  string   OtherDedicatedDescriptions[];
  uint16   ResetCapability = 5;
  uint16   PowerManagementCapabilities[];
  uint32   MaxVMQOffloads;
  uint32   MaxIOVOffloads;
};

멤버

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

• 메서드
• 속성

메서드

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

메서드	설명
RequestStateChange	상태 변경을 요청합니다.
SetPowerState	이 메서드는 지원되지 않습니다.

속성

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

AvailableRequestedStates

데이터 형식: uint16 배열

액세스 형식: 읽기 전용

상태 변경을 시작하는 데 사용되는 RequestStateChange 메서드의 RequestedState 매개 변수에 대한 가능한 값을 나타냅니다. 나열된 값은 CIM_EnabledLogicalElementCapabilities 연결된 instance RequestedStatesSupported 속성에 포함된 값의 하위 집합입니다. 여기서 선택한 값은 CIM_EnabledLogicalElement 개체의 현재 상태 함수입니다. 구현에서 가능한 값 집합을 현재 상태의 함수로 보급할 수 있는 경우 이 속성은 Null 이 아닐 수 있습니다. 구현에서 현재 상태의 함수로 가능한 값 집합을 확인할 수 없는 경우 이 속성은 Null 이 됩니다.

이 속성은 CIM_EnabledLogicalElement 상속됩니다.

사용 (2)

사용 안 함 (3)

종료 (4)

오프라인 (6)

테스트 (7)

연기 (8)

정지 (9)

다시 부팅 (10)

초기화 (11)

DMTF 예약 됨(.. )

캡션

데이터 형식: string

액세스 형식: 읽기 전용

개체에 대한 간단한 설명입니다. 이 속성은 CIM_ManagedElement 상속되며 항상 "가상 스위치"로 설정됩니다.

CommunicationStatus

데이터 형식: uint16

액세스 형식: 읽기 전용

계측이 기본 관리되는 요소와 통신하는 기능을 나타냅니다. Null 값은 이 속성이 구현되지 않음을 나타냅니다. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

알 수 없음 (0)

사용할 수 없음 (1)

통신 확인 (2)

통신 끊김 (3)

연락처 없음 (4)

DMTF 예약 됨(..)

Vendor Reserved (0x8000.. )

CreationClassName

데이터 형식: 문자열

액세스 형식: 읽기 전용

instance 만드는 데 사용되는 클래스 또는 하위 클래스의 이름입니다. 이 속성은 CIM_System 상속되며 항상 "Msvm_VirtualEthernetSwitch"로 설정됩니다.

전용

데이터 형식: uint16 배열

액세스 형식: 읽기 전용

컴퓨터 시스템이 범용 시스템이 아닌 특수 목적 시스템(특정 용도 전용)인지 여부를 나타냅니다. 이 속성은 CIM_ComputerSystem 상속되며 항상 0(전용 아님)으로 설정됩니다.

설명

데이터 형식: 문자열

액세스 형식: 읽기 전용

개체에 대한 설명입니다. 이 속성은 CIM_ManagedElement 상속되며 항상 "Microsoft Virtual Switch"로 설정됩니다.

DetailedStatus

데이터 형식: uint16

액세스 형식: 읽기 전용

PrimaryStatus 속성을 추가 상태 세부 정보로 보완합니다. Null 값은 이 속성이 구현되지 않음을 나타냅니다. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

사용할 수 없음 (0)

추가 정보 없음 (1)

스트레스 ( 2)

예측 실패 (3)

복구할 수 없는 오류 (4)

오류에서 엔터티 지원 (5)

DMTF 예약 됨(..)

Vendor Reserved (0x8000.. )

ElementName

데이터 형식: 문자열

액세스 형식: 읽기 전용

개체의 표시 이름입니다. 이 속성은 CIM_ManagedElement 상속됩니다.

EnabledDefault

데이터 형식: uint16

액세스 형식: 읽기 전용

요소의 사용 상태에 대한 관리자의 기본 또는 시작 구성입니다. 이 속성은 CIM_EnabledLogicalElement 상속되며 다음 값 중 하나가 됩니다.

사용 (2)

사용 안 함 (3)

사용하지만 오프라인 (6)

EnabledState

데이터 형식: uint16

액세스 형식: 읽기 전용

요소의 사용 및 사용 안 함 상태입니다. 이 속성은 요청된 상태 간의 전환을 나타낼 수도 있습니다. 이 속성은 CIM_EnabledLogicalElement 상속되며 항상 5(해당 없음)로 설정됩니다.

HealthState

데이터 형식: uint16

액세스 형식: 읽기 전용

요소의 현재 상태를 지정합니다. 이 특성은 이 요소의 상태를 나타내지만 해당 하위 구성 요소의 상태를 반드시 나타내는 것은 아닙니다.

심각한 오류가 발생하면 이벤트 로그에 자세한 내용을 검사. EnabledState 속성에는 추가 정보가 포함될 수도 있습니다. 예를 들어 디스크 공간이 매우 낮으면 HealthState 가 25로 설정되고 가상 머신이 일시 중지되고 EnabledState 가 32768(일시 중지됨)으로 설정됩니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

값	의미
확인 5	요소는 완벽하게 작동하며 정상적인 작동 매개 변수 내에서 오류 없이 작동합니다.
주요 오류 20	요소에 큰 오류가 발생했습니다.
심각한 오류 25	요소는 비기능이며 복구가 불가능할 수 있습니다.

IdentifyingDescriptions

데이터 형식: 문자열 배열

액세스 형식: 읽기 전용

이 속성은 CIM_ComputerSystem 상속되며 항상 Null로 설정됩니다.

InstallDate

데이터 형식: datetime

액세스 형식: 읽기 전용

관리 운영 체제에 대해 가상 머신 구성을 만든 날짜 및 시간( Null)입니다. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

InstanceID

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: Key

이 클래스의 instance 고유하게 식별합니다. 이 속성은 CIM_ManagedElement 상속됩니다.

MaxIOVOffloads

데이터 형식: uint32

액세스 형식: 읽기 전용

이 스위치에서 사용할 수 있는 SR-IOV(단일 루트 IO 가상화) 가상 함수 오프로드의 최대 수입니다.

MaxVMQOffloads

데이터 형식: uint32

액세스 형식: 읽기/쓰기

이 스위치의 포트에 허용되는 최대 VMQ(가상 머신 큐) 오프로드 수입니다.

이름

데이터 형식: 문자열

액세스 형식: 읽기 전용

개체가 알려진 레이블입니다. 이 속성은 CIM_System 상속되며 항상 "GUID"로 설정됩니다.

NameFormat

데이터 형식: 문자열

액세스 형식: 읽기 전용

하위 클래스 추론을 사용하여 시스템 이름이 생성된 방법을 식별하는 문자열입니다. 이 속성은 CIM_ComputerSystem 상속되며 항상 Null로 설정됩니다.

OperatingStatus

데이터 형식: uint16

액세스 형식: 읽기 전용

요소의 작동 조건에 대한 현재 상태 정보를 제공하며 EnabledState 속성의 값과 관련하여 자세한 정보를 제공하는 데 사용할 수 있습니다. Null 값은 이 속성이 구현되지 않음을 나타냅니다. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

알 수 없음 (0)

사용할 수 없음 (1)

서비스 (2)

시작 (3)

중지 (4)

중지됨 (5)

중단됨 (6)

휴면 ( 7)

완료됨 (8)

마이그레이션 (9)

이주 (10)

이민 (11)

스냅샷 만들기 (12)

종료 중(13)

테스트 중(14)

전환 (15)

서비스 중 (16)

DMTF 예약 됨(..)

Vendor Reserved (0x8000.. )

OperationalStatus

데이터 형식: uint16 배열

액세스 형식: 읽기 전용

개체의 현재 상태를 포함하는 배열입니다. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

OtherDedicatedDescriptions

데이터 형식: 문자열 배열

액세스 형식: 읽기 전용

Dedicated 배열에 값 2(기타)가 포함된 경우 시스템이 전용인 방법 또는 이유를 설명하는 문자열입니다. 이 속성은 CIM_ComputerSystem 상속되며 항상 Null로 설정됩니다.

OtherEnabledState

데이터 형식: 문자열

액세스 형식: 읽기 전용

EnabledState 속성이 1(기타)로 설정된 경우 요소의 사용 또는 사용 안 함 상태입니다. EnabledState가 1 이외의 값인 경우 이 속성을 Null로 설정해야 합니다. 이 속성은 CIM_EnabledLogicalElement 상속되며 항상 Null로 설정됩니다.

OtherIdentifyingInfo

데이터 형식: 문자열 배열

액세스 형식: 읽기 전용

이 속성은 CIM_ComputerSystem 상속되며 항상 Null로 설정됩니다.

PowerManagementCapabilities

데이터 형식: uint16 배열

액세스 형식: 읽기 전용

이 속성은 CIM_ComputerSystem 상속되지만 사용되지 않습니다.

PrimaryOwnerContact

데이터 형식: 문자열

액세스 형식: 읽기 전용

기본 시스템 소유자에 연결할 수 있는 방법(예: 전화 번호 또는 전자 메일 주소)을 나타내는 문자열입니다. 이 속성은 CIM_System 상속되며 항상 Null로 설정됩니다.

PrimaryOwnerName

데이터 형식: 문자열

액세스 형식: 읽기 전용

기본 시스템 소유자의 이름입니다. 이 속성은 CIM_System 상속되며 항상 Null로 설정됩니다.

PrimaryStatus

데이터 형식: uint16

액세스 형식: 읽기 전용

높은 수준의 상태 정보를 제공합니다. 이 속성은 DetailedStatus 속성과 함께 사용하여 요소 및 하위 구성 요소의 상위 수준 및 상세 상태 상태 제공해야 합니다. Null 값은 이 속성이 구현되지 않음을 나타냅니다. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

알 수 없음 (0)

확인 (1)

성능 저하됨 (2)

오류 (3)

DMTF 예약됨 (..)

Vendor Reserved (0x8000.. )

RequestedState

데이터 형식: uint16

액세스 형식: 읽기 전용

RequestStateChange 메서드에 전달된 요소에 대해 마지막으로 요청되거나 원하는 상태이거나, 상태 변경이 진행 중인 경우 12(해당 없음)입니다. 요소의 실제 상태는 EnabledState로 표시됩니다. 이 속성은 마지막으로 요청된 상태와 현재 사용 또는 사용 안 함 상태를 비교하기 위해 제공됩니다. 이 속성은 CIM_EnabledLogicalElement 상속됩니다.

ResetCapability

데이터 형식: uint16

액세스 형식: 읽기 전용

이 속성은 CIM_ComputerSystem 상속되며 항상 5(구현되지 않음)로 설정됩니다.

역할

데이터 형식: 문자열 배열

액세스 형식: 읽기 전용

시스템이 정보 기술 환경에서 수행하는 역할을 설명하는 문자열 배열입니다. 이 속성은 CIM_System 상속되며 항상 Null로 설정됩니다.

상태

데이터 형식: 문자열

액세스 형식: 읽기 전용

요소의 상태 지정하는 문자열입니다. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

StatusDescriptions

데이터 형식: 문자열 배열

액세스 형식: 읽기 전용

한정자: ArrayType ("인덱싱됨")

해당 OperationalStatus 배열 값을 설명하는 문자열이 포함된 배열입니다. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

TimeOfLastStateChange

데이터 형식: datetime

액세스 형식: 읽기 전용

요소의 사용 상태가 마지막으로 변경된 날짜 및 시간입니다. 이 속성은 CIM_EnabledLogicalElement 상속됩니다.

TransitioningToState

데이터 형식: uint16

액세스 형식: 읽기 전용

instance 전환 중인 대상 상태를 나타냅니다. 이 속성은 CIM_EnabledLogicalElement 상속됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
네임스페이스	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe