다음을 통해 공유

사용자 지정 포트 기능 상태

  • 아티클

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

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

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

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

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

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

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

[ Dynamic,
  UUID("DAA0B7CC-74DB-41ef-8354-7002F9FA463E"),
  ExtensionId("5CBF81BE-5055-47CD-9055-A76B2B4E369E"), 
  Provider("VmmsWmiInstanceAndMethodProvider"), 
  InterfaceVersion("1"),
  InterfaceRevison("0"),
  Locale(0x409),
  Description("Fabricam, Inc. port custom feature status description.") : Amended,
  DisplayName("Fabricam, Inc.port custom feature status friendly name.") : Amended]
class Fabrikam_CustomPortData  : Msvm_EthernetPortData {
    [ Read,
       Write,
       WmiDataId(1),
      InterfaceVersion("1"),
      InterfaceRevision("0"),
       Description(
         "The current status of custom feature on this port.") : Amended]
     uint32 CurrentStatus = 0 ;
};

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

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

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

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

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

PS C:\> $portData = Get-VMSwitchExtensionPortData -VmName TestVm -FeatureId DAA0B7CC-74DB-41ef-8354-7002F9FA463E
# Output the current value
PS C:\> $portData.Data.CurrentStatus
123

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