사용자 지정 스위치 기능 상태

Hyper-V 플랫폼 및 Hyper-V 확장 가능한 스위치 인터페이스는 확장 가능한 스위치에 대한 사용자 지정 상태 정보를 가져오는 인프라를 제공합니다. 이 정보를 스위치 기능 상태 정보라고 합니다.

사용자 지정 스위치 기능 상태 정의는 MOF(관리 개체 형식) 클래스 정의를 사용하여 WMI 관리 계층에 등록됩니다. 사용자 지정 스위치 기능 상태 정의의 특성을 정의하는 구조체 멤버 외에도 MOF 클래스에는 다음이 포함되어야 합니다.

• 사용자 지정 스위치 기능 상태 정의를 고유하게 식별하는 UUID입니다.

• 확장 가능한 스위치 확장을 고유하게 식별하는 GUID입니다. 이 GUID는 MOF 클래스의 ExtensionId 한정자로 선언되며 확장의 INF 파일에 선언된 NetCfgInstanceId 항목의 값과 일치해야 합니다.

• 설명이 포함된 클래스 이름 문자열입니다. 공급업체의 이름은 문자열에 포함되어야 합니다.

다음은 확장 가능한 스위치의 정의를 상태 사용자 지정 기능에 대한 MOF 클래스의 예를 보여 줍니다.

#pragma namespace("\\\\.\\root\\virtualization\\v2")

[ Dynamic,
  UUID("B3E57D77-8E95-4977-97DE-524F8DAF03E4"),
  ExtensionId("5CBF81BE-5055-47CD-9055-A76B2B4E369E"), 
  Provider("VmmsWmiInstanceAndMethodProvider"), 
  InterfaceVersion("1"),
  InterfaceRevison("0"),
  Locale(0x409),
  Description(
   "Fabricam, Inc. Switch custom feature status description.") : Amended,
  DisplayName("Fabricam, Inc. Switch custom feature status friendly name.") : Amended]
class Fabrikam_CustomSwitchData  : Msvm_EthernetSwitchFeatureSettingData{
    [ Read,
       Write,
       WmiDataId(1),
       InterfaceVersion("1"),
       InterfaceRevision("0"),
       Description(
         "The current status of custom feature on this switch.") : Amended]
     uint32 CurrentStatus = 0 ;
};

확장 가능한 스위치의 사용자 지정 기능 상태 정의에 대한 MOF 클래스는 MOF 컴파일러(Mofcomp.exe)를 사용하여 CIM(공용 정보 모델) 리포지토리에 등록됩니다. 등록되면 POWERShell cmdlet 및 WMI 기반 애플리케이션 프로그램을 통해 MOF 클래스를 구성할 수 있습니다.

다음 예제에서는 사용자 지정 스위치 기능 상태 정의에 대한 MOF 클래스가 포함된 파일(Fabrikam_CustomSwitchData.mof)을 등록하기 위해 입력해야 하는 명령을 보여 줍니다.

net stop vmms
mofcomp -N:root\virtualization\v2 Fabrikam_CustomSwitchData.mof
net start vmms

MOF 컴파일러를 사용하는 방법에 대한 자세한 내용은 드라이버의 MOF 파일 컴파일을 참조하세요.

다음 예제에서는 사용자 지정 스위치 기능 상태 정의를 사용하여 스위치 데이터를 가져오는 방법을 보여줍니다. 이 예제에서 Fabrikam_CustomSwitchData MOF 클래스는 "TestSwitch"라는 스위치에서 스위치 상태 가져오는 데 사용됩니다. Fabrikam, Inc. 확장은 vSwitch "TestSwitch"에서 사용하도록 설정되며 상태 대해 123을 반환합니다.

PS C:\> $switchData = Get-VMSwitchExtensionSwitchData -SwitchName TestSwitch -FeatureId B3E57D77-8E95-4977-97DE-524F8DAF03E4
# Output the current value
PS C:\> $switchData$customSwitchData.Data.CurrentStatus
123

확장 가능한 스위치 확장에서 스위치 기능 상태 관리하는 방법에 대한 자세한 내용은 사용자 지정 스위치 기능 상태 관리 정보를 참조하세요.