Msvm_GuestServiceInterfaceComponentSettingData 클래스

게스트 서비스 인터페이스 구성 요소의 구성된 상태를 나타냅니다. 이 클래스는 CIM_ResourceAllocationSettingData 클래스에서 파생됩니다.

다음 구문은 MOF 코드에서 간소화되며 상속된 모든 속성을 포함합니다.

구문

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_GuestServiceInterfaceComponentSettingData : CIM_ResourceAllocationSettingData
{
  string  ElementName;
  string  InstanceID;
  uint16  ResourceType;
  string  OtherResourceType;
  string  ResourceSubType;
  string  PoolID;
  uint16  ConsumerVisibility;
  string  HostResource[];
  string  AllocationUnits;
  uint64  VirtualQuantity;
  uint64  Reservation;
  uint64  Limit;
  uint32  Weight;
  boolean AutomaticAllocation;
  boolean AutomaticDeallocation;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  uint16  EnabledState = 3;
  uint16  DefaultEnabledStatePolicy = 2;
};

멤버

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

• 속성

속성

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

주소

데이터 형식: 문자열

액세스 형식: 읽기 전용

리소스의 주소입니다. 예를 들어 이더넷 포트의 MAC 주소입니다.

AllocationUnits

데이터 형식: 문자열

액세스 형식: 읽기 전용

이 속성은 예약 및 제한 속성에서 사용하는 할당 단위를 지정합니다. 예를 들어 ResourceType=Processor인 경우 AllocationUnits를 MHz로 설정할 수 있습니다. ResourceType=Memory인 경우 AllocationUnits를 MB로 설정할 수 있습니다.

AutomaticAllocation

데이터 형식: boolean

액세스 형식: 읽기 전용

이 속성은 리소스가 자동으로 할당되는지를 지정합니다. 예를 들어 true로 설정하면 소비하는 가상 컴퓨터 시스템이 켜지면 이 리소스가 할당됩니다. false 값은 리소스를 명시적으로 할당해야 했음을 나타냅니다. 예를 들어 이 설정은 정시에 미디어가 존재하지 않는 이동식 미디어(즉, cdrom 또는 플로피)를 나타낼 수 있습니다. 리소스를 할당하려면 명시적 작업이 필요합니다.

AutomaticDeallocation

데이터 형식: boolean

액세스 형식: 읽기 전용

이 속성은 리소스가 자동으로 할당 취소되는지를 지정합니다. 예를 들어 true로 설정하면 소비하는 가상 컴퓨터 시스템의 전원이 꺼지면 이 리소스의 할당이 취소됩니다. false로 설정하면 리소스가 다시 할당되고기본 명시적으로 할당 취소되어야 합니다.

연결

데이터 형식: 문자열 배열

액세스 형식: 읽기 전용

이 리소스가 연결된 것입니다. 예를 들어 명명된 네트워크 또는 스위치 포트입니다.

ConsumerVisibility

데이터 형식: uint16

액세스 형식: 읽기 전용

할당된 리소스에 대한 소비자 가시성을 설명합니다.

값	의미
알 수 없음 0	알 수 없습니다.
통과 2	기본 또는 호스트 리소스가 사용되며 분할을 사용하여 소비자에게 전달됩니다. DeviceID 속성에 하나 이상의 항목이 있어야 합니다.
가상화 3	리소스는 가상화되며 기본/호스트 리소스에 직접 매핑되지 않을 수 있습니다. 일부 구현은 가상화된 리소스에 대한 특정 할당을 지원할 수 있습니다. 이 경우 호스트 리소스는 DeviceID 속성을 사용하여 노출됩니다.
표시되지 않음 4	리소스의 표현은 리소스 소비자의 컨텍스트 내에 존재하지 않습니다.
DMTF 예약됨 ..
예약된 공급업체 32767..65535

DefaultEnabledStatePolicy

데이터 형식: uint16

액세스 형식: 읽기 전용

기본적으로 게스트 통신 서비스의 사용 및 사용 안 함 상태입니다.

읽기 전용 속성이지만 Msvm_VirtualSystemManagementService 클래스의 ModifyResource설정 메서드를 사용하여 변경할 수 있습니다.

참고 항목

Windows 10에 추가되었습니다.

사용(2)

사용 안 함 (3)

ElementName

데이터 형식: 문자열

액세스 형식: 읽기 전용

이 SettingData 인스턴스의 표시 이름입니다. 또한 표시 이름은 검색 또는 쿼리의 인덱스 속성으로 사용할 수 있습니다. (참고: 이름은 네임스페이스 내에서 고유할 필요가 없습니다.)

EnabledState

데이터 형식: uint16

액세스 형식: 읽기 전용

요소의 사용 및 사용 안 함 상태입니다.

읽기 전용 속성이지만 Msvm_VirtualSystemManagementService 클래스의 ModifyVirtualSystemResources 메서드(또는 Windows 10 이상에서 ModifyResource설정)를 사용하여 변경할 수 있습니다.

유효한 값:

사용(2)

사용 안 함 (3)

HostResource

데이터 형식: 문자열 배열

액세스 형식: 읽기 전용

이 속성은 호스트 또는 기본 리소스에 대한 특정 할당을 노출합니다. 포함된 인스턴스는 키 속성만 포함하며 개체 경로로 처리되어야 합니다. 가상 리소스가 여러 기본 리소스에서 예약될 수 있는 경우 이 속성은 NULL을 다시 기본 합니다. 이 경우 DeviceAllocatedFromPool 또는 ResourceAllocationFromPool 연결을 사용하여 이 가상 리소스가 예약될 수 있는 호스트 리소스 풀을 결정할 수 있습니다. 특정 할당을 사용하는 경우 이 가상 리소스에서 사용하는 모든 기본 리소스가 이 배열에 나열됩니다. 일반적으로 배열에는 하나의 항목이 포함되지만 여러 프로세서와 같은 집계 할당의 경우 여러 호스트 리소스를 지정할 수 있습니다.

InstanceID

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: Key

인스턴스화 네임스페이스의 범위 내에서 InstanceID는 이 클래스의 인스턴스를 불투명하고 고유하게 식별합니다. 네임스페이스 내에서 고유성을 보장하려면 다음 "기본 설정" 알고리즘을 사용하여 InstanceID 값을 생성해야 합니다. OrgID:LocalID는 OrgID와 LocalID를 콜론(:)으로 구분하고, OrgID는 InstanceID를 만들거나 정의하는 비즈니스 엔터티가 소유하거나 또는 인식된 전역 엔터티에 의해 비즈니스 엔터티에 할당된 등록된 ID인 저작권, 상표 또는 기타 고유 이름을 포함해야 합니다. 기관. (이 요구 사항은 스키마 클래스 이름의 SchemaName_ClassName 구조체입니다.) 또한 고유성을 보장하기 위해 OrgID 는 콜론(:) 포함해서는 안됩니다. 이 알고리즘을 사용하는 경우 InstanceID에 표시되는 첫 번째 콜론이 OrgID와 LocalID 사이에 나타나야 합니다. LocalID 는 비즈니스 엔터티에서 선택되며 다른 기본(실제) 요소를 식별하기 위해 다시 사용해서는 안 됩니다. 위의 "기본 설정" 알고리즘을 사용하지 않는 경우 정의 엔터티는 이 인스턴스의 NameSpace에 대해 이 또는 다른 공급자가 생성한 모든 InstanceID에서 결과 InstanceID가 다시 사용되지 않도록 해야 합니다. DMTF 정의 인스턴스의 경우 CIM으로 설정된 OrgID와 함께 "기본 설정" 알고리즘을 사용해야 합니다.

한도

데이터 형식: uint64

액세스 형식: 읽기 전용

이 속성은 이 할당에 대해 부여할 상한 또는 최대 리소스 양을 지정합니다. 예를 들어 메모리 페이징을 지원하는 시스템은 VirtualQuantity의 메모리 할당 제한 설정을 지원할 수 있으므로 이 할당에 대해 페이징이 강제로 발생합니다.

MappingBehavior

데이터 형식: uint16

액세스 형식: 읽기 전용

이 리소스가 기본 리소스에 매핑되는 방법을 지정합니다. HostResource 배열에 항목이 포함된 경우 이 속성은 리소스가 해당 특정 리소스에 매핑되는 방식을 반영합니다.

알 수 없음 (0)

지원 되지 않음(1)

전용 (2)

소프트 선호도 (3)

하드 선호도 (4)

DMTF 예약됨 (..)

Vendor Reserved (32767..65535)

OtherResourceType

데이터 형식: 문자열

액세스 형식: 읽기 전용

잘 정의된 값을 사용할 수 없으며 ResourceType 값이 "Other"인 경우 리소스 종류를 설명하는 문자열입니다.

부모

데이터 형식: 문자열

액세스 형식: 읽기 전용

리소스의 부모입니다. 예를 들어 현재 할당에 대한 컨트롤러입니다.

PoolID

데이터 형식: 문자열

액세스 형식: 읽기 전용

이 속성은 리소스가 현재 할당된 ResourcePool 또는 할당이 발생할 때 리소스가 할당될 ResourcePool을 지정합니다.

예약

데이터 형식: uint64

액세스 형식: 읽기 전용

이 속성은 이 할당에 사용할 수 있도록 보장되는 리소스의 양을 지정합니다. 리소스의 과다 약정을 지원하는 시스템에서 이 값은 일반적으로 할당이 수락되지 않도록 허용 제어에 사용되어 리소스 고갈을 방지합니다.

ResourceSubType

데이터 형식: 문자열

액세스 형식: 읽기 전용

이 리소스에 대한 구현 특정 하위 형식을 설명하는 문자열입니다. 예를 들어 동일한 리소스 유형의 다른 모델을 구분하는 데 사용할 수 있습니다.

ResourceType

데이터 형식: uint16

액세스 형식: 읽기 전용

이 할당 설정이 나타내는 리소스의 유형입니다.

기타 (1)

컴퓨터 시스템 (2)

프로세서 (3)

메모리 (4)

IDE 컨트롤러 (5)

병렬 SCSI HBA (6)

FC HBA (7)

iSCSI HBA (8)

IB HCA (9)

이더넷 어댑터 (10)

기타 네트워크 어댑터 (11)

I/O 슬롯 (12)

I/O 디바이스 (13)

플로피 드라이브 (14)

CD 드라이브 (15)

DVD 드라이브 (16)

직렬 포트 (17)

병렬 포트 (18)

USB 컨트롤러 (19)

그래픽 컨트롤러 (20)

스토리지 익스텐트 (21)

디스크 (22)

테이프 (23)

기타 스토리지 디바이스 (24)

Firewire 컨트롤러 (25)

분할 가능한 단위 (26)

기본 분할 가능 단위 (27)

전원 공급 장치 (28)

냉각 장치 (29)

DMTF 예약됨 (..)

Vendor Reserved (32767..65535)

VirtualQuantity

데이터 형식: uint64

액세스 형식: 읽기 전용

이 속성은 소비자에게 제공되는 리소스의 수량을 지정합니다. 예를 들어 ResourceType=Processor인 경우 이 속성은 가상 컴퓨터 시스템에 표시되는 불연속 프로세서 수를 반영합니다. ResourceType=Memory인 경우 이 속성은 가상 컴퓨터 시스템에 보고된 MB 수를 반영할 수 있습니다.

Weight

데이터 형식: uint32

액세스 형식: 읽기 전용

이 속성은 동일한 ResourcePool의 다른 할당과 관련하여 이 할당에 대한 상대적 우선 순위를 지정합니다. 이 속성은 측정 단위가 없으며 동일한 호스트 리소스에 대해 경쟁하는 다른 할당과 비교할 때만 관련이 있습니다.

요구 사항

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

참고 항목

CIM_ResourceAllocationSettingData

CIM_ResourceAllocationSettingData