Msvm_VirtualSystemManagementService 클래스

단일 호스트 시스템에 있는 가상화 서비스를 나타냅니다. Msvm_VirtualSystemManagementService 가상 머신의 정의, 수정 및 삭제를 제어하는 데 사용됩니다. 또한 가상 머신의 복제, 스냅샷 만들기 및 가져오기 또는 내보내기와 같은 가상 머신에서 작업을 수행하는 메서드도 있습니다. 가상 머신별 정보를 검색하려면 Msvm_ComputerSystem 사용합니다.

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

구문

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualSystemManagementService : CIM_VirtualSystemManagementService
{
  string   InstanceID;
  string   Caption = "Virtual System Management Service";
  string   Description = "Service for creating, manipulating, and managing virtual machines";
  string   ElementName = "Hyper-V Virtual System Management Service";
  datetime InstallDate;
  string   Name = "vmms";
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "The service is running normally" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_VirtualSystemManagementService";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   StartMode;
  boolean  Started = True;
};

멤버

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

메서드

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

방법 설명
AddBootSourceSettings "상태" 가상 시스템 구성에 적용될 때 가상 시스템 구성에 부팅 원본을 추가합니다.
AddFeatureSettings 가상 머신 이더넷 연결의 구성에 이더넷 기능 설정을 추가합니다.
AddFibreChannelChap 가상 머신의 가상 파이버 채널 포트에 DH-CHAP 매개 변수를 추가합니다.
AddGuestServiceSettings 가상 시스템 구성에 게스트 서비스 설정을 추가합니다.
"현재" 가상 시스템 구성의 일부에 적용되는 경우 활성 가상 시스템의 부작용 게스트 서비스가 수정될 수 있습니다.
AddKvpItems 가상 머신에 키-값 쌍을 추가합니다.
AddResourceSettings 가상 머신 구성에 리소스를 추가합니다.
AddSystemComponentSettings 가상 시스템 구성에 일반 설정을 추가합니다.
DefinePlannedSystem 계획된 가상 시스템을 정의합니다.
완전히 지정되지 않은 입력은 기본값으로 채워질 수 있습니다.
DefineSystem 새 가상 머신 정의를 만듭니다.
DestroySystem 기존 가상 머신 정의를 삭제합니다.
DiagnoseNetworkConnection Windows 네트워크 가상화 환경에서 VM의 네트워크 연결을 진단합니다.
ExportSystemDefinition 가상 머신 또는 가상 머신의 스냅샷을 파일로 내보냅니다.
FormatError 포함된 Msvm_Error 인스턴스의 지정된 배열에 대한 형식이 지정된 오류 메시지 문자열을 반환합니다.
GenerateWwpn WWPN(World Wide Port Names) 집합을 생성합니다.
GetCurrentWwpnFromGenerator WWPN을 예약하지 않고 현재 WWPN(World Wide Port Name)을 미리 볼 수 있는 기능을 제공합니다.
GetDefinitionFileSummaryInformation 지정된 가상 머신 정의 파일에 대한 가상 머신 요약 정보를 반환합니다.
GetSizeOfSystemFiles 가상 머신의 시스템 파일의 총 크기를 검색합니다.
GetSummaryInformation 가상 머신 요약 정보를 반환합니다.
GetVirtualSystemThumbnailImage 기존 가상 머신의 썸네일 이미지를 검색합니다.
ImportSnapshotDefinitions 지정된 폴더에서 지정된 계획된 컴퓨터 시스템과 연결된 스냅샷 정의 파일을 검색하고 이 위치의 모든 연결된 정의 파일에 대해 계획된 컴퓨터 시스템에 새 스냅샷을 만듭니다.
ImportSystemDefinition 지정된 가상 머신 정의를 기반으로 계획된 새 컴퓨터 시스템을 만듭니다.
ModifyDiskMergeSettings 디스크 병합 설정 데이터를 수정합니다.
ModifyFeatureSettings 가상 머신 이더넷 연결의 현재 기능 설정을 수정합니다.
ModifyGuestServiceSettings 게스트 서비스 설정을 수정합니다.
"현재" 가상 시스템 구성의 일부에 적용되는 경우 활성 가상 시스템의 부작용 게스트 서비스가 수정될 수 있습니다.
ModifyKvpItems 가상 머신에서 기존 키-값 쌍을 수정합니다.
ModifyResourceSettings 가상 리소스 설정을 수정합니다.
ModifyServiceSettings 서비스의 설정 데이터를 수정합니다.
ModifySystemComponentSettings 일반 시스템 구성 요소 설정을 수정합니다.
ModifySystemSettings 가상 머신 설정을 수정합니다.
RealizePlannedSystem 계획된 가상 머신의 구성의 유효성을 검사하고 실현된 가상 머신으로 변환합니다.
RemoveBootSourceSettings 가상 시스템 구성에서 가상 리소스 설정을 제거합니다.
"현재" 가상 시스템 구성의 일부에 적용되는 경우 활성 가상 시스템의 부작용 리소스가 제거될 수 있습니다.
RemoveFeatureSettings 가상 머신 이더넷 연결에서 기능 설정을 제거합니다.
RemoveFibreChannelChap 가상 머신의 가상 파이버 채널 포트에서 DH-CHAP 매개 변수를 제거합니다.
RemoveGuestServiceSettings 가상 시스템 구성에서 게스트 서비스 설정을 제거합니다.
"현재" 가상 시스템 구성의 일부에 적용되는 경우 활성 가상 시스템의 부작용 게스트 서비스가 수정될 수 있습니다.
RemoveKvpItems 가상 머신에서 기존 키-값 쌍을 제거합니다.
RemoveResourceSettings 가상 머신 구성에서 가상 리소스 설정을 제거합니다.
RemoveSystemComponentSettings 가상 시스템 구성에서 일반 구성 요소 설정을 제거합니다.
RequestStateChange 이 메서드는 지원되지 않습니다.
SetGuestNetworkAdapterConfiguration 게스트 운영 체제 내에서 네트워크 어댑터를 구성합니다.
SetInitialMachineConfigurationData VM의 초기 컴퓨터 구성 데이터를 설정합니다.
StartService 이 메서드는 지원되지 않습니다.
StopService 이 메서드는 지원되지 않습니다.
TestNetworkConnection Windows 네트워크 가상화 환경에서 VM의 네트워크 연결을 테스트합니다.
UpgradeSystemVersion 가상 시스템을 업그레이드합니다.
"현재" 가상 시스템 구성의 시스템 설정에 적용되는 경우
ValidatePlannedSystem 지정된 계획된 시스템의 유효성을 검사합니다.

속성

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

AvailableRequestedStates

데이터 형식: uint16 배열

액세스 형식: 읽기 전용

RequestStateChange 메서드의 RequestedState 매개 변수에 사용할 수 있는 값을 나타냅니다. 이 속성은 CIM_EnabledLogicalElement 상속되며 항상 Null로 설정됩니다.

캡션

데이터 형식: 문자열

액세스 형식: 읽기 전용

개체에 대한 간단한 설명입니다. 이 속성은 CIM_ManagedElement 상속되며 항상 "Hyper-V 가상 시스템 관리 서비스"로 설정됩니다.

CommunicationStatus

데이터 형식: uint16

액세스 형식: 읽기 전용

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

알 수 없음 (0)

사용할 수 없음 (1)

통신 확인 (2)

통신 손실 (3)

연락처 없음 (4)

DMTF 예약됨 (..)

Vendor Reserved (0x8000.)

CreationClassName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: Key, MaxLen (256)

인스턴스를 만드는 데 사용되는 클래스 또는 하위 클래스의 이름입니다. 이 속성은 CIM_Service 상속되며 항상 "Msvm_VirtualSystemManagementService"로 설정됩니다.

설명

데이터 형식: 문자열

액세스 형식: 읽기 전용

개체에 대한 설명입니다. 이 속성은 CIM_ManagedElement 상속되며 항상 "가상 머신 만들기, 조작 및 관리를 위한 서비스"로 설정됩니다.

DetailedStatus

데이터 형식: uint16

액세스 형식: 읽기 전용

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

사용할 수 없음 (0)

추가 정보 없음 (1)

스트레스 ( 2)

예측 실패 (3)

복구할 수 없는 오류 (4)

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

DMTF 예약됨 (..)

Vendor Reserved (0x8000.)

ElementName

데이터 형식: 문자열

액세스 형식: 읽기 전용

개체의 표시 이름입니다. 이 속성은 CIM_ManagedElement 상속되며 항상 "Hyper-V 가상 시스템 관리 서비스"로 설정됩니다.

EnabledDefault

데이터 형식: uint16

액세스 형식: 읽기 전용

요소의 사용 상태에 대한 관리자의 기본 또는 시작 구성입니다. 이 속성은 CIM_EnabledLogicalElement 상속되며 항상 2(사용)로 설정됩니다.

의미
2
사용

EnabledState

데이터 형식: uint16

액세스 형식: 읽기 전용

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

의미
2
사용

HealthState

데이터 형식: uint16

액세스 형식: 읽기 전용

요소의 현재 상태입니다. 이 특성은 이 요소의 상태를 나타내지만 반드시 해당 하위 구성 요소의 상태를 나타내지는 않습니다. 가능한 값은 0~30이며, 여기서 5는 요소가 완전히 정상이고 30은 요소가 완전히 비기능적임을 의미합니다. 이 속성은 CIM_ManagedSystemElement 상속되며 항상 5(확인)로 설정됩니다.

의미
5
상태가 정상입니다.

InstallDate

데이터 형식: datetime

액세스 형식: 읽기 전용

가상 머신 구성을 만든 날짜 및 시간입니다. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

InstanceID

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자:

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

이름

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: Key, MaxLen (256)

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

OperatingStatus

데이터 형식: uint16

액세스 형식: 읽기 전용

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

알 수 없음 (0)

사용할 수 없음 (1)

서비스 (2)

시작 (3)

중지 (4)

중지됨 (5)

중단됨 (6)

휴면 (7)

완료됨 (8)

마이그레이션 ( 9)

이주 (10)

이민 (11)

스냅샷 만들기 (12)

종료 (13)

테스트 중 (14)

전환 (15)

In Service (16)

DMTF 예약( ..)

공급업체 예약 (0x8000.)

OperationalStatus

데이터 형식: uint16 배열

액세스 형식: 읽기 전용

개체의 현재 상태입니다. 이 속성은 CIM_ManagedSystemElement 상속되며 각 배열 요소는 항상 2(확인)로 설정됩니다.

OtherEnabledState

데이터 형식: 문자열

액세스 형식: 읽기 전용

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

PrimaryOwnerContact

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MaxLen (256)

서비스의 기본 소유자에 연결할 수 있는 방법에 대한 모든 정보(예: 전화 번호, 전자 메일 주소 등). 이 속성은 CIM_Service 상속되며 항상 Null로 설정됩니다.

PrimaryOwnerName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MaxLen (64)

서비스에 대한 기본 소유자의 이름(정의된 경우)입니다. 기본 소유자는 서비스에 대한 초기 지원 연락처입니다. 이 속성은 CIM_Service 상속되며 항상 Null로 설정됩니다.

PrimaryStatus

데이터 형식: uint16

액세스 형식: 읽기 전용

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

알 수 없음 (0)

확인 (1)

성능 저하됨 (2)

오류 (3)

DMTF 예약( ..)

공급업체 예약 (0x8000.)

RequestedState

데이터 형식: uint16

액세스 형식: 읽기 전용

요소에 대해 마지막으로 요청되거나 원하는 상태입니다. 요소의 실제 상태는 EnabledState로 표시됩니다. 이 속성은 요소에 대해 마지막으로 요청된 상태와 현재 상태를 비교하기 위해 제공됩니다. CIM_EnabledLogicalElement 클래스의 특정 인스턴스는 RequestedState 속성을 지원하지 않을 수 있습니다. 이 경우 값 12("해당 없음")가 사용됩니다. 이 속성은 CIM_EnabledLogicalElement 상속되며 항상 12로 설정됩니다(해당 없음).

의미
12
해당 사항 없음

시작됨

데이터 형식: 부울

액세스 형식: 읽기 전용

서비스가 현재 실행 중인지 여부를 나타냅니다. 이 속성은 CIM_Service 상속되며 항상 True로 설정됩니다.

StartMode

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MaxLen (10)

서비스가 시스템, 운영 체제에 의해 자동으로 시작되는지 또는 요청 시만 시작되는지 여부를 나타내는 문자열 값입니다. 이 속성은 CIM_Service 상속되며 항상 Null로 설정됩니다.

Status

데이터 형식: 문자열

액세스 형식: 읽기 전용

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

StatusDescriptions

데이터 형식: 문자열 배열

액세스 형식: 읽기 전용

다양한 OperationalStatus 배열 값을 설명하는 문자열입니다. 이 속성은 CIM_ManagedSystemElement 상속되며 각 배열 요소는 항상 "서비스가 정상적으로 실행되고 있습니다"로 설정됩니다.

SystemCreationClassName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: Key, MaxLen (256)

범위 지정 시스템의 생성 클래스 이름입니다. 이 속성은 CIM_Service 상속되며 항상 "Msvm_ComputerSystem"로 설정됩니다.

SystemName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: Key, MaxLen (256)

호스팅 컴퓨터 시스템의 NetBIOS 이름입니다. 이 속성은 CIM_Service 상속됩니다.

TimeOfLastStateChange

데이터 형식: datetime

액세스 형식: 읽기 전용

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

TransitioningToState

데이터 형식: uint16

액세스 형식: 읽기 전용

인스턴스가 전환되는 대상 상태를 나타냅니다. 이 속성은 CIM_EnabledLogicalElement 상속되며 항상 Null로 설정됩니다.

설명

Msvm_VirtualSystemManagementService 클래스에 대한 액세스는 UAC 필터링에 의해 제한될 수 있습니다. 자세한 내용은 사용자 계정 컨트롤 및 WMI를 참조하세요.

요구 사항

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

참고 항목

CIM_VirtualSystemManagementService

CIM_VirtualSystemManagementService

Msvm_VirtualSystemManagementService(V1)

가상 시스템 관리 클래스