hyper v direct ssh

Hyper-V-Direct-SSH

プロジェクトの概要

hyper-v-direct-ssh Hyper-V仮想マシン（VM）を管理し、それらへの直接SSH接続を確立するように設計されたPowerShellモジュールです。このモジュールは、VMSを起動および停止し、VM情報の取得、および管理者の特権でスクリプトが実行されるようにするための関数を提供します。

特徴

• 管理者の特権でスクリプトが実行されることを確認してください。
• システムでHyper-Vを確認して有効にします。
• PowerShellバージョンが7以上であることを確認します。
• VM名を取得して管理します。
• VMSを開始して停止します。
• 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

2文字ごとにダッシュを文字列に追加します。

パラメーター：

• 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がまだ有効になっていない場合は、有効にします。
3. PowerShellバージョンが7以上であることを確認してください。
4. ユーザーが選択できるVMのリストを取得して表示します。
5. 選択したVMを開始します。
6. VMのハートビートステータスを確認してください。
7. VMのIPアドレスを取得します。
8. VMへのSSH接続を開始します。
9. SSHセッションが終了した後、VMを停止します。