hyper v direct ssh

超级电视式SSH

项目概述

hyper-v-direct-ssh是一个旨在管理Hyper-V虚拟机（VM）并与其建立直接SSH连接的PowerShell模块。该模块提供了用于启动和停止VM，检索VM信息以及确保脚本使用管理员特权运行的功能。

特征

• 确保脚本使用管理员特权运行。
• 在系统上检查并启用Hyper-V。
• 验证PowerShell版本是7或更高的。
• 检索并管理VM名称。
• 启动和停止VM。
• 检索VM IP地址。
• 启动与VMS的SSH连接。
• 检查VM心跳状态。

用法

先决条件

验证管理特权

确保您的系统具有管理特权。该脚本需要提高权限来管理Hyper-V并执行某些命令。

启用Hyper-V

确保在系统上启用Hyper-V。您可以使用以下步骤启用Hyper-V：

1. 打开PowerShell作为管理员。
2. 运行以下命令启用Hyper-V：

    Enable-WindowsOptionalFeature - Online - FeatureName Microsoft - Hyper - V - All

3. 重新启动您的系统以应用更改。

安装PowerShell 7或更高

该脚本需要PowerShell版本7或更高版本。请按照以下步骤安装或更新PowerShell：

1. 转到powershell github发布页面。
2. 为您的操作系统下载最新版本。
3. 按照发布页面上提供的安装说明。

安装SSH客户端

确保SSH客户端安装在系统上。您可以通过以下步骤安装OpenSSH客户端：

在Windows上：

1. 打开PowerShell作为管理员。
2. 运行以下命令：

    Add-WindowsCapability - Online - Name OpenSSH.Client * 

在MacOS上：

1. 开放式终端。
2. 运行以下命令检查是否已经安装了SSH：

   ssh -V

3. 如果未安装SSH，请使用Homebrew安装它：

   brew install openssh

在Linux上：

1. 开放式终端。

2. 运行以下命令：

   sudo apt-get install openssh-client

   或用于基于RPM的分布：

   sudo yum install openssh-clients

为VM配置网络

确保将VM配置为获得IP地址，并可以通过SSH访问它们。在运行脚本之前，请先验证网络设置和连接。

下载脚本

将脚本保存为VMManagement.ps1在您的本地计算机上。确保可以访问文件路径，并记下运行脚本的路径。

运行脚本

1. 打开PowerShell作为管理员。
2. 导航到保存VMManagement.ps1脚本的目录。
3. 使用以下命令运行脚本：

   .VMManagement.ps1

运行脚本

要使用模块，请将脚本保存为VMManagement.ps1 ，然后使用PowerShell运行它。确保您具有必要的管理特权，并且在系统上启用了Hyper-V。

.VMManagement.ps1

功能

Get-Run-AsAdministrator

确保脚本具有管理员特权。

参数：

• ScriptPath ：需要作为管理员运行的脚本的路径。

例子：

 Get-Run - AsAdministrator - ScriptPath " C:PathToScript.ps1 " 

Enable-HyperV

检查是否在系统上启用了Hyper-V，并启用它。

例子：

 Enable-HyperV 

Test-PwshVersion

检查当前的PowerShell版本是否为7或更高。

例子：

 Test-PwshVersion 

Get-VMList

检索VM名称列表。

例子：

 $vms = Get-VMList 

Get-VMName

提示用户从列表中选择VM。

例子：

 $vmName = Get-VMName 

Get-UserName

提示用户输入SSH的用户名。

例子：

 $username = Get-UserName 

Start-VMInstance

启动指定的VM。

参数：

• vmName ：启动VM的名称。

例子：

 $vm = Start-VMInstance - vmName " MyVM " 

Add-Dash

每两个字符每两个字符添加破折号。

参数：

• str ：将添加破折号的字符串。

例子：

 $dashedString = Add-Dash - str " A1B2C3D4 " 

Get-VMIP

检索指定VM的IP地址。

参数：

• vmObject ：要检索IP地址的VM对象。

例子：

 $ipAddress = Get-VMIP - vmObject $vm 

Stop-VMInstance

停止指定的VM。

参数：

• vmName ：VM的名称要停止。

例子：

 Stop-VMInstance - vmName " MyVM " 

Invoke-SSHConnection

启动与指定VM的SSH连接。

参数：

• user ：SSH连接的用户名。
• vmIP ：VM的IP地址。

例子：

 Invoke-SSHConnection - user " username " - vmIP " 192.168.1.100 " 

Get-VMHeartbeat

检查指定VM的心跳状态。

参数：

• vmObject ：要检查心跳状态的VM对象。

例子：

 $heartbeat = Get-VMHeartbeat - vmObject $vm 

示例工作流程

1. 确保脚本具有管理员特权。
2. 如果尚未启用Hyper-V，则启用Hyper-V。
3. 检查PowerShell版本是否为7或更高。
4. 检索并显示一个VM列表供用户选择。
5. 启动选定的VM。
6. 检查VM的心跳状态。
7. 检索VM的IP地址。
8. 启动与VM的SSH连接。
9. SSH会话结束后停止VM。