hyper v direct ssh

Hyper-V-Direct-Ssh

Обзор проекта

hyper-v-direct-ssh -это модуль PowerShell, предназначенный для управления виртуальными машинами Hyper-V (VMS) и установления прямых соединений SSH с ними. Этот модуль предоставляет функции для запуска и остановки виртуальных машин, получения информации о виртуальной машине и обеспечения сценария запуска с привилегиями администратора.

Функции

• Убедитесь, что сценарий запускается с привилегиями администратора.
• Проверьте и включите Hyper-V в системе.
• Проверьте версию PowerShell 7 или более.
• Получить и управлять именами виртуальных машин.
• Начните и остановите виртуальные машины.
• Получить IP -адреса VM.
• Инициировать SSH -соединения с виртуальными машинами.
• Проверьте статус виртуальной машины.

Использование

Предварительные условия

Проверьте административные привилегии

Убедитесь, что у вас есть административные привилегии в вашей системе. Сценарий требует повышенных разрешений для управления Hyper-V и выполнять определенные команды.

Включить Hyper-V

Убедитесь, что Hyper-V включен в вашей системе. Вы можете включить Hyper-V, используя следующие шаги:

1. Open 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, выполнив эти шаги:

В окнах:

1. Open 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

Настроить сеть для виртуальных машин

Убедитесь, что ваши виртуальные машины настроены для получения IP -адреса и что они доступны через SSH. Проверьте настройки сети и подключение перед запуском сценария.

Загрузите скрипт

Сохраните скрипт как VMManagement.ps1 на вашей локальной машине. Убедитесь, что путь файла доступен, и отметьте путь для запуска сценария.

Запустите сценарий

1. Open 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

Получает список имен виртуальных машин.

Пример:

 $vms = Get-VMList 

Get-VMName

Помогает пользователю выбрать виртуальную машину из списка.

Пример:

 $vmName = Get-VMName 

Get-UserName

Помогает пользователю ввести имя пользователя для SSH.

Пример:

 $username = Get-UserName 

Start-VMInstance

Запускает указанную виртуальную машину.

Параметры:

• vmName : имя виртуальной машины для начала.

Пример:

 $vm = Start-VMInstance - vmName " MyVM " 

Add-Dash

Добавляет тире в строку каждые два символа.

Параметры:

• str : строка, в которую будут добавлены тире.

Пример:

 $dashedString = Add-Dash - str " A1B2C3D4 " 

Get-VMIP

Получает IP -адрес указанной виртуальной машины.

Параметры:

• vmObject : объект VM, для которого должен быть извлечен IP -адрес.

Пример:

 $ipAddress = Get-VMIP - vmObject $vm 

Stop-VMInstance

Останавливает указанную виртуальную машину.

Параметры:

• vmName : имя виртуальной машины, чтобы остановиться.

Пример:

 Stop-VMInstance - vmName " MyVM " 

Invoke-SSHConnection

Инициирует соединение SSH с указанной виртуальной машиной.

Параметры:

• user : имя пользователя для соединения SSH.
• vmIP : IP -адрес виртуальной машины.

Пример:

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

Get-VMHeartbeat

Проверяет состояние сердцебиения указанной виртуальной машины.

Параметры:

• vmObject : объект виртуальной машины, для которого должен быть проверен статус сердцебиения.

Пример:

 $heartbeat = Get-VMHeartbeat - vmObject $vm 

Пример рабочий процесс

1. Убедитесь, что сценарий работает с привилегиями администратора.
2. Включите Hyper-V, если он еще не включен.
3. Убедитесь, что версия PowerShell составляет 7 или более.
4. Получить и отобразить список виртуальных машин для пользователя, чтобы выбрать.
5. Начните выбранную виртуальную машину.
6. Проверьте статус сердцебиения виртуальной машины.
7. Получить IP -адрес виртуальной машины.
8. Инициировать соединение SSH с виртуальной машиной.
9. Остановите виртуальную машину после того, как сеанс SSH заканчивается.