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。