Metode ValidatePlannedSystem dari kelas Msvm_VirtualSystemManagementService

Memvalidasi sistem terencana yang ditentukan. Ini melibatkan pemeriksaan konfigurasi komputer virtual, perangkat, konfigurasi rekam jepret, perangkat rekam jepret, file status tersimpan, dan file penyimpanan.

Sintaks

uint32 ValidatePlannedSystem(
  [in]  Msvm_PlannedComputerSystem REF PlannedSystem,
  [out] CIM_ConcreteJob            REF Job
);

Parameter

PlannedSystem [in]

Referensi ke objek Msvm_PlannedComputerSystem yang mewakili sistem yang direncanakan untuk divalidasi.

Job [out]

Jika operasi dilakukan secara asinkron, metode ini akan mengembalikan 4096, dan parameter ini akan berisi referensi ke objek yang berasal dari CIM_ConcreteJob.

Menampilkan nilai

Metode ini mengembalikan salah satu nilai berikut.

Selesai tanpa Kesalahan (0)

Parameter Metode Diperiksa - Pekerjaan Dimulai (4096)

Gagal (32768)

Akses Ditolak (32769)

Tidak Didukung (32770)

Status tidak diketahui (32771)

Batas waktu (32772)

Parameter tidak valid (32773)

Sistem sedang digunakan (32774)

Status tidak valid untuk operasi ini (32775)

Tipe data salah (32776)

Sistem tidak tersedia (32777)

Kehabisan memori (32778)

File yang Digunakan (32779)

Contoh

Sampel C# berikut menggunakan metode ValidatePlannedSystem untuk memvalidasi komputer virtual yang direncanakan. Kode ini diambil dari sampel komputer virtual yang direncanakan Hyper-V. Utilitas yang dirujuk dapat ditemukan di Utilitas umum untuk sampel virtualisasi (V2).

Penting

Agar berfungsi dengan benar, kode berikut harus dijalankan di server host komputer virtual, dan harus dijalankan dengan hak istimewa Administrator.

/// <summary>
/// Finds the first Planned VM matching pvmName and validates it, displaying
/// any warnings produced.
/// </summary>
/// <param name="pvmName">The name of the PVM to be validated.</param>
internal static void
ValidatePvm(
    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("ValidatePlannedSystem"))
    {
        inParams["PlannedSystem"] = pvm.Path;

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

        using (ManagementBaseObject outParams = 
            managementService.InvokeMethod("ValidatePlannedSystem", inParams, null))
        {
            if (WmiUtilities.ValidateOutput(outParams, scope))
            {
                using (ManagementObject job = 
                    new ManagementObject((string)outParams["Job"]))
                {
                    WmiUtilities.PrintMsvmErrors(job);
                }
            }
        }
    }
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Ruang nama	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Lihat juga

Msvm_VirtualSystemManagementService