Msvm_VirtualHardDiskSettingData 클래스

가상 하드 디스크에 대한 설정 데이터를 제공합니다.

다음 구문은 MOF(관리 개체 형식) 코드를 간소화하고 상속된 모든 속성을 포함합니다.

구문

[AMENDMENT]
class Msvm_VirtualHardDiskSettingData : CIM_SettingData
{
  string   InstanceID;
  string   Caption = "Virtual Hard Disk Setting Data";
  string   Description = "Setting Data for a Virtual Hard Disk";
  string   ElementName;
  uint16   Type;
  uint16   Format;
  string   Path;
  string   ParentPath;
  DATETIME ParentTimestamp;
  string   ParentIdentifier;
  uint64   MaxInternalSize;
  uint32   BlockSize;
  uint32   LogicalSectorSize;
  uint32   PhysicalSectorSize;
  string   VirtualDiskId;
  uint64   DataAlignment;
  uint16   PmemAddressAbstractionType;
  boolean  IsPmemCompatible;
};

멤버

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

• 속성

속성

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

BlockSize

데이터 형식: uint32

액세스 형식: 읽기/쓰기

가상 하드 디스크에서 사용하는 블록 크기(바이트)입니다.

캡션

데이터 형식: string

액세스 형식: 읽기 전용

개체에 대한 간단한 설명입니다. 이 속성은 CIM_ManagedElement 상속되며 항상 "가상 하드 디스크 설정 데이터"로 설정됩니다.

DataAlignment

데이터 형식: uint64

액세스 형식: 읽기/쓰기

가상 디스크의 데이터 페이로드에 대해 원하는 맞춤(바이트)을 지정합니다.

참고

Windows 10 버전 1709에 추가되었습니다.

설명

데이터 형식: 문자열

액세스 형식: 읽기 전용

개체에 대한 설명입니다. 이 속성은 CIM_ManagedElement 상속되며 항상 "가상 하드 디스크에 대한 데이터 설정"으로 설정됩니다.

ElementName

데이터 형식: 문자열

액세스 형식: 읽기 전용

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

형식

데이터 형식: uint16

액세스 형식: 읽기/쓰기

가상 하드 디스크의 형식입니다. 다음 값 중 하나가 됩니다.

VHD (2)

VHDX (3)

VHDSet (4)

참고

Windows 10 및 Windows Server 2016 추가되었습니다.

InstanceID

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: Key

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

IsPmemCompatible

데이터 형식: boolean

액세스 형식: 읽기/쓰기

가상 디스크를 영구 메모리 디바이스의 백업 저장소로 사용할 수 있는지 여부를 지정합니다.

참고

Windows 10 버전 1709에 추가되었습니다.

LogicalSectorSize

데이터 형식: uint32

액세스 형식: 읽기/쓰기

가상 하드 디스크에서 사용하는 논리 섹터 크기(바이트)입니다.

MaxInternalSize

데이터 형식: uint64

액세스 형식: 읽기/쓰기

가상 머신에서 볼 수 있는 가상 하드 디스크의 최대 크기(바이트)입니다. 이 크기는 섹터 크기의 다음으로 큰 배수로 반올림됩니다.

ParentIdentifier

데이터 형식: 문자열

액세스 형식: 읽기 전용

가상 하드 디스크의 부모를 고유하게 식별하는 데 사용되는 GUID입니다. 가상 하드 디스크에 부모가 없으면 이 필드는 비어 있습니다.

참고

Windows 10 및 Windows Server 2016 추가되었습니다.

ParentPath

데이터 형식: 문자열

액세스 형식: 읽기/쓰기

가상 하드 디스크의 부모입니다. 가상 하드 디스크에 부모가 없는 경우 이 속성은 비어 있습니다.

ParentTimestamp

데이터 형식: DATETIME

액세스 형식: 읽기 전용

가상 하드 디스크의 부모 타임스탬프입니다. 가상 하드 디스크에 부모가 없으면 이 필드는 비어 있습니다.

참고

Windows 10 및 Windows Server 2016 추가되었습니다.

Path

데이터 형식: 문자열

액세스 형식: 읽기/쓰기

가상 하드 디스크의 정규화된 경로입니다.

PhysicalSectorSize

데이터 형식: uint32

액세스 형식: 읽기/쓰기

가상 하드 디스크에서 사용하는 실제 섹터 크기(바이트)입니다.

PmemAddressAbstractionType

데이터 형식: uint16

액세스 형식: 읽기/쓰기

이 가상 디스크와 함께 사용할 영구 메모리 주소 추상화 방법입니다.

참고

Windows 10 버전 1709에 추가되었습니다.

없음 (0)

BTT (1)

알 수 없음 (65535)

형식

데이터 형식: uint16

액세스 형식: 읽기/쓰기

가상 하드 디스크의 유형입니다. 다음 값 중 하나가 됩니다.

수정됨 (2)

동적 (3)

차이점 (4)

VirtualDiskId

데이터 형식: 문자열

액세스 형식: 읽기/쓰기

가상 디스크를 고유하게 식별하는 데 사용되는 GUID입니다.

Msvm_ImageManagementService.GetVirtualHardDiskSettingData 메서드가 Msvm_VirtualHardDiskSettingData instance 반환하는 경우 클라이언트는 이 속성을 사용하여 VHD의 고유한 디스크 ID를 가져올 수 있습니다.

충돌 검색 또는 그렇지 않은 경우 클라이언트는 VirtualDiskId 값을 새 GUID로 설정하고 이 Msvm_VirtualHardDiskSettingData instance Msvm_ImageManagementService.SetVirtualHardDiskSettingData 메서드에 전달하여 VHD의 디스크 ID를 변경할 수 있습니다. VHD가 VHDX VHD가 아니거나 VHD가 연결된 경우 작업이 실패합니다. 전달된 값의 형식이 잘못되었거나 GUID가 아니거나 0이 모두 있는 경우에도 작업이 실패합니다. 전달된 값이 현재 디스크 ID와 같으면 작업이 자동으로 성공합니다.

SetVirtualDiskInformation 함수에서 생성된 오류는 이 속성을 통해 버블업됩니다. 클라이언트는 동일한 네임스페이스의 Msvm_ImageManagementService.CreateVirtualHardDisk 메서드를 통해 VHD를 만들 때 동일한 메커니즘을 사용하여 VirtualDiskId 값을 제공할 수도 있습니다. VHD1 또는 VHD2 VHD를 만드는 데 사용할 수 있습니다.

Windows 8.1: 이 값은 Windows 8.1 R2를 Windows Server 2012 때까지 지원되지 않습니다.

요구 사항

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

추가 정보

CIM_SettingData

GetVirtualHardDiskSettingData