Hyper-V 使用之 PowerShell 操作 Hyper-V

[TOC]

## 1. Hyper-V 模块列表

运行以下命令以显示适用于 Hyper-V PowerShell 模块的 PowerShell 命令的可搜索列表

```shell
Get-Command -Module hyper-v | Out-GridView
```

运行上面命令后会弹出下面窗口，通过筛选可以查看Hyper-V的模块

![](/UploadFlie/MarkdownImg/20250718/202507181112366386.png)

## 2. 查看 Hyper-V 命令详细

通过在 PowerShell 中使用 `Get-Help 加 Hyper-V 命令` 可以查看 Hyper-V 相关命令的详细信息，如构建命令的方法、必需和可选参数定义以及可以使用的别名，例如下面示例查看 Hyper-V 中 `Get-VM` 命令

```shell
# Hyper-V 命令
Get-Help Get-VM
```

**结果展示：**

```shell
名称
 Get-VM
摘要
 Gets the virtual machines from one or more Hyper-V hosts.
语法
 Get-VM [[-Name] <String[]>] [-CimSession <CimSession[]>] [-ComputerName <String[]>] [-Credential <PSCredential[]>] [<CommonParameters>]

Get-VM [[-Id] <Guid>] [-CimSession <CimSession[]>] [-ComputerName <String[]>] [-Credential <PSCredential[]>] [<CommonParameters>]

Get-VM [-ClusterObject] <PSObject> [<CommonParameters>]
说明
 The Get-VM cmdlet gets the virtual machines from one or more Hyper-V hosts.
相关链接
 Online Version: https://learn.microsoft.com/powershell/module/hyper-v/get-vm?view=windowsserver2025-ps&wt.mc_id=ps-gethelp
备注
 若要查看示例，请键入: "get-help Get-VM -examples".
 有关详细信息，请键入: "get-help Get-VM -detailed".
 若要获取技术信息，请键入: "get-help Get-VM -full".
 有关在线帮助，请键入: "get-help Get-VM -online"
```

> Get-Help 运行时会检查本机的帮助文档，如果不存在对应的文档，会进行对应帮助文档的下载

## 3. 查看 Hyper-V 虚拟机列表

**查看所有虚拟机列表**

```shell
PS C:\WINDOWS\system32> Get-VM

Name             State   CPUUsage(%) MemoryAssigned(M) Uptime             Status Version
----             -----   ----------- ----------------- ------             ------ -------
Ubuntu 18.04 LTS Running 0           7270              4.05:28:06.6860000 正常运行   12.0
```

**查看已启动的虚拟机列表**

```shell
PS C:\WINDOWS\system32> Get-VM | where {$_.State -eq 'Running'}

Name             State   CPUUsage(%) MemoryAssigned(M) Uptime           Status Version
----             -----   ----------- ----------------- ------           ------ -------
Ubuntu 18.04 LTS Running 0           7240              02:21:59.9790000 正常运行   12.0
```

**查看关机状态的虚拟机**

```shell
PS C:\WINDOWS\system32> Get-VM | where {$_.State -eq 'Off'}

Name             State CPUUsage(%) MemoryAssigned(M) Uptime   Status Version
----             ----- ----------- ----------------- ------   ------ -------
Ubuntu 18.04 LTS Off   0           0                 00:00:00 正常运行   12.0
```

## 4. 启动和关机虚拟机

**启动命令：**

```shell
# 语法：Start-VM -Name <virtual machine name>
# 注意名称这个参数要使用双引号
PS C:\WINDOWS\system32> Start-VM -Name "Ubuntu 18.04 LTS"
```

**关机命令：**

```shell
PS C:\WINDOWS\system32> Stop-VM -Name "Ubuntu 18.04 LTS"
```

**批量启用关机状态虚拟机命令：**

```shell
PS C:\WINDOWS\system32> Get-VM | where {$_.State -eq 'Off'} | Start-VM
```

**批量关机启用状态虚拟机命令：**

```shell
PS C:\WINDOWS\system32> Get-VM | where {$_.State -eq 'Running'} | Stop-VM
```

> 注意启动和关机命令，虚拟机的名称需要使用双引号，否则会报错。Start-VM和Stop-VM也可以省略-Name，直接使用Start-VM "Ubuntu 18.04 LTS" 也可以启动虚拟机

## 5. 新建虚拟机

新建虚拟机需要在PowerShell 集成脚本环境 (ISE) 中创建，在开始菜单这种查找 `PowerShell ISE` 打开后输出下面代码便可创建一个新的虚拟机

```shell
$VMName = "VMNAME"
$VM = @{
 Name = $VMName
 MemoryStartupBytes = 2147483648
 Generation = 2
 NewVHDPath = "C:\Virtual Machines\$VMName\$VMName.vhdx"
 NewVHDSizeBytes = 53687091200
 BootDevice = "VHD"
 Path = "C:\Virtual Machines\$VMName"
 SwitchName = (Get-VMSwitch).Name
}
New-VM @VM
```

上面是使用 PowerShell 中的 Hyper-V 模块创建新虚拟机的脚本，通过 splatting 技术（参数哈希表）简化了命令调用。下面详细分析如下：

### 5.1. 变量定义

```powershell
$VMName = "VMNAME"
```

- 定义了一个变量 `$VMName`，用于存储虚拟机的名称（此处为 `"VMNAME"`，实际使用时需替换为具体名称，如 `"WebServer01"`）。

### 5.2. 参数哈希表 `$VM`

通过哈希表 `$VM` 定义了创建虚拟机所需的所有参数，键为参数名，值为参数值，后续通过 `@VM` 传递给 `New-VM` 命令。

### 5.3. 创建虚拟机命令

```powershell
New-VM @VM
```

- `New-VM` 是 Hyper-V 模块中用于创建虚拟机的核心命令。
- `@VM` 是 splatting 语法，将哈希表 `$VM` 中的键值对作为参数传递给 `New-VM`，等价于：
```powershell
New-VM -Name "VMNAME" -MemoryStartupBytes 2147483648 -Generation 2 ...（其他参数）
```

### 5.4. 总结
这段代码的作用是：在本地 Hyper-V 主机上创建一个名为 `VMNAME` 的第 2 代虚拟机，配置 2GB 启动内存、50GB 虚拟硬盘，存储路径为 `C:\Virtual Machines\VMNAME`，并自动连接到主机上的虚拟交换机，启动设备为虚拟硬盘。

实际使用时，通常需要修改 `$VMName`、存储路径、内存/硬盘大小等参数以适应需求。