Msvm_VirtualSystemManagementService 클래스의 DestroySystem 메서드

  • 아티클

호스트 시스템의 관리 scope 이전에 정의된 가상 머신을 제거합니다. 연결된 모든 리소스 정의도 제거됩니다. 이 메서드를 호출하기 전에 가상 머신이 전원이 꺼져 있거나 저장된 상태여야 합니다.

구문

uint32 DestroySystem(
  [in]  CIM_ComputerSystem REF AffectedSystem,
  [out] CIM_ConcreteJob    REF Job
);

매개 변수

AffectedSystem [in]

형식: CIM_ComputerSystem

제거될 가상 머신 instance 나타내는 CIM_ComputerSystem instance 대한 참조입니다.

작업 [out]

형식: CIM_ConcreteJob

작업이 비동기적으로 수행되면 이 메서드는 4096을 반환하고 이 매개 변수에는 CIM_ConcreteJob 파생된 개체에 대한 참조가 포함됩니다.

반환 값

형식: uint32

이 메서드가 동기적으로 실행되면 성공하면 0을 반환합니다. 이 메서드가 비동기적으로 실행되는 경우 4096을 반환하고 Job 출력 매개 변수를 사용하여 비동기 작업의 진행률을 추적할 수 있습니다. 다른 반환 값은 오류를 나타냅니다.

오류 없이 완료됨 (0)

지원되지 않음 (1)

실패( 2)

시간 제한 (3)

잘못된 매개 변수 (4)

잘못된 상태 (5)

DMTF 예약됨 (..)

메서드 매개 변수 확인 - 작업 시작 (4096)

Reserved 메서드 (4097..32767)

공급업체별 (32768..65535)

설명

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

예제

다음 C# 샘플에서는 DestroySystem 메서드를 사용하여 계획된 가상 머신을 제거합니다. 이 코드는 Hyper-V 계획된 가상 머신 샘플에서 가져옵니다. 참조된 유틸리티는 V2(가상화 샘플)에 대한 공통 유틸리티에서 찾을 수 있습니다.

중요

올바르게 작동하려면 다음 코드를 가상 머신 호스트 서버에서 실행해야 하며 관리자 권한으로 실행해야 합니다.

/// <summary>
/// Finds the first Planned VM matching pvmName and removes it.
/// </summary>
/// <param name="pvmName">The name of the PVM to be removed.</param>
internal static void
RemovePvm(
    string pvmName
    )
{
    ManagementScope scope = new ManagementScope(@"root\virtualization\v2");

    using (ManagementObject pvm = WmiUtilities.GetPlannedVirtualMachine(pvmName, scope))
    using (ManagementObject managementService = WmiUtilities.GetVirtualMachineManagementService(scope))
    using (ManagementBaseObject inParams =
        managementService.GetMethodParameters("DestroySystem"))
    {
        inParams["AffectedSystem"] = pvm.Path;

        Console.WriteLine("Removing Planned Virtual Machine \"{0}\" ({1})...",
                pvm["ElementName"], pvm["Name"]);

        using (ManagementBaseObject outParams =
            managementService.InvokeMethod("DestroySystem", inParams, null))
        {
            WmiUtilities.ValidateOutput(outParams, scope);
        }
    }
}

요구 사항

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

추가 정보

Msvm_VirtualSystemManagementService