Introduction

Managing multiple virtual machines (VMs) in Hyper-V can become a time-consuming task, especially when VMs need to be imported into the system in bulk. While the Hyper-V Manager offers a manual process for importing VMs, using PowerShell to automate the process can save significant time and effort, particularly when dealing with large numbers of VMs.

In this article, we’ll walk you through a PowerShell script that automates the process of importing multiple VMs into Hyper-V Manager. The script checks for VM configuration files, imports them, and even starts the VMs automatically. Let’s dive into the details of how this script works and how you can use it to streamline your VM importation process.

Script Overview

The script uses PowerShell to automate the import of multiple Hyper-V virtual machines from a designated base folder. It searches for .vmcx configuration files within subfolders, imports each VM, and optionally starts it. Here’s how it works in steps.

Full PowerShell Script

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# Define the path to the folder containing the VMs
$VMBaseFolder = "D:\VMs"

# Check if the base folder exists
if (Test-Path -Path $VMBaseFolder) {
    # Get a list of all subfolders in the base VM folder (assuming each subfolder is a VM)
    $VMFolders = Get-ChildItem -Path $VMBaseFolder -Directory

    # Loop through each VM folder to search for any .vmcx file inside the "Virtual Machines" subfolder
    foreach ($VMFolder in $VMFolders) {
        # Define the path to the "Virtual Machines" subfolder inside each VM folder
        $VirtualMachinesFolder = Join-Path -Path $VMFolder.FullName -ChildPath "Virtual Machines"

        # Check if the "Virtual Machines" folder exists
        if (Test-Path -Path $VirtualMachinesFolder) {
            # Find any .vmcx file in the "Virtual Machines" folder
            $VMConfigFiles = Get-ChildItem -Path $VirtualMachinesFolder -Filter "*.vmcx" -File

            # If any .vmcx files are found
            if ($VMConfigFiles.Count -gt 0) {
                foreach ($VMConfigFile in $VMConfigFiles) {
                    try {
                        Write-Host "Importing VM from $($VMConfigFile.FullName)..."

                        # Import the VM using the .vmcx configuration file
                        Import-VM -Path $VMConfigFile.FullName

                        # Optionally, start the VM after importing
                        $VMName = (Get-VM -Path $VMConfigFile.FullName).Name
                        Start-VM -Name $VMName

                        Write-Host "VM '$VMName' imported and started successfully."
                    } catch {
                        Write-Host "Failed to import VM from $($VMConfigFile.FullName). Error: $_"
                    }
                }
            } else {
                Write-Host "No .vmcx configuration file found in folder $VirtualMachinesFolder"
            }
        } else {
            Write-Host "No 'Virtual Machines' folder found in $($VMFolder.FullName)"
        }
    }

    Write-Host "VM import process completed."
} else {
    Write-Host "The specified VM base folder path does not exist: $VMBaseFolder"
}

Script Explanation

1. Define the Base Folder

1

$VMBaseFolder = "D:\VMs"

This variable stores the path to the folder that contains your virtual machine directories. Update this path to reflect the location where your VMs are stored.

2. Check Folder Existence

1

if (Test-Path -Path $VMBaseFolder) {

This checks whether the specified folder exists. If the folder doesn’t exist, the script prints an error message and halts execution.

3. Get VM Folders

1

$VMFolders = Get-ChildItem -Path $VMBaseFolder -Directory

This command retrieves all the subdirectories (assumed to be VM folders) inside the base folder. Each VM folder should contain a “Virtual Machines” folder where the VM configuration files reside.

4. Loop Through Each VM Folder

1

foreach ($VMFolder in $VMFolders) {

The script loops through each VM folder. Inside each folder, it looks for a “Virtual Machines” subfolder.

5. Check for Virtual Machines Folder

1

$VirtualMachinesFolder = Join-Path -Path $VMFolder.FullName -ChildPath "Virtual Machines"

This command constructs the path to the “Virtual Machines” folder inside each VM directory.

6. Search for VM Configuration Files

1

$VMConfigFiles = Get-ChildItem -Path $VirtualMachinesFolder -Filter "*.vmcx" -File

Once the “Virtual Machines” folder is found, this command searches for .vmcx files, which are Hyper-V virtual machine configuration files. If one or more files are found, the script proceeds with importing them.

7. Import Each VM

1

Import-VM -Path $VMConfigFile.FullName

For each .vmcx file, the script uses the Import-VM cmdlet to import the virtual machine into Hyper-V Manager.

8. Start the VM

1

Start-VM -Name $VMName

After importing the VM, the script retrieves the VM’s name and starts it using the Start-VM cmdlet. This is an optional step, and you can remove it if you don’t want the VM to start automatically after import.

9. Error Handling

1
2
3

} catch {
    Write-Host "Failed to import VM from $($VMConfigFile.FullName). Error: $_"
}

The script includes error handling to catch any issues during the import process. If an error occurs, it prints a detailed message, but the script continues processing other VMs.

10. Completion Message

1

Write-Host "VM import process completed."

After all VMs have been processed, the script prints a completion message.

Conclusion

Automating the import of multiple Hyper-V virtual machines with PowerShell can save a considerable amount of time, especially for system administrators dealing with large VM environments. This script simplifies the import process by automatically detecting VM configuration files, importing them into Hyper-V, and even starting them if desired.

By adjusting the $VMBaseFolder variable to point to your VM storage location, you can easily adapt this script to suit your environment. Whether you’re migrating VMs, setting up a new Hyper-V server, or just simplifying repetitive tasks, this script is a valuable tool for managing your virtual infrastructure more efficiently.