hyper v direct ssh

Hyper-V-directo-SSH

Descripción general del proyecto

hyper-v-direct-ssh es un módulo PowerShell diseñado para administrar las máquinas virtuales Hyper-V (VM) y establecer conexiones SSH directas para ellas. Este módulo proporciona funciones para comenzar y detener las máquinas virtuales, recuperar información de VM y garantizar que el script se ejecute con privilegios de administrador.

Características

• Asegúrese de que el script se ejecute con los privilegios del administrador.
• Verifique y habilite Hyper-V en el sistema.
• Verificar la versión de PowerShell es 7 o más.
• Recupere y administre los nombres de VM.
• Comience y detenga las máquinas virtuales.
• Recuperar direcciones IP de VM.
• Iniciar conexiones SSH a las máquinas virtuales.
• Compruebe el estado de latidos del corazón de la VM.

Uso

Requisitos previos

Verificar los privilegios administrativos

Asegúrese de tener privilegios administrativos en su sistema. El script requiere permisos elevados para administrar Hyper-V y ejecutar ciertos comandos.

Habilitar Hyper-V

Asegúrese de que Hyper-V esté habilitado en su sistema. Puede habilitar Hyper-V usando los siguientes pasos:

1. Abierto de PowerShell como administrador.
2. Ejecute el siguiente comando para habilitar Hyper-V:

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

3. Reinicie su sistema para aplicar los cambios.

Instalar PowerShell 7 o más

El script requiere PowerShell versión 7 o mayor. Siga estos pasos para instalar o actualizar PowerShell:

1. Vaya a la página de lanzamientos de PowerShell GitHub.
2. Descargue la última versión para su sistema operativo.
3. Siga las instrucciones de instalación proporcionadas en la página de lanzamiento.

Instalar el cliente SSH

Asegúrese de que el cliente SSH esté instalado en su sistema. Puede instalar el cliente OpenSSH siguiendo estos pasos:

En Windows:

1. Abierto de PowerShell como administrador.
2. Ejecute el siguiente comando:

    Add-WindowsCapability - Online - Name OpenSSH.Client * 

En macOS:

1. Terminal abierto.
2. Ejecute el siguiente comando para verificar si SSH ya está instalado:

   ssh -V

3. Si no está instalado SSH, use HomeBrew para instalarlo:

   brew install openssh

En Linux:

1. Terminal abierto.

2. Ejecute el siguiente comando:

   sudo apt-get install openssh-client

   o para distribuciones basadas en RPM:

   sudo yum install openssh-clients

Configurar red para máquinas virtuales

Asegúrese de que sus máquinas virtuales estén configuradas para obtener una dirección IP y que esté accesible a través de SSH. Verifique la configuración de la red y la conectividad antes de ejecutar el script.

Descargar el guión

Guarde el script como VMManagement.ps1 en su máquina local. Asegúrese de que la ruta del archivo sea accesible y anote la ruta para ejecutar el script.

Ejecutar el guión

1. Abierto de PowerShell como administrador.
2. Navegue al directorio donde se guarda el script VMManagement.ps1 .
3. Ejecute el script usando el siguiente comando:

   .VMManagement.ps1

Ejecutando el script

Para usar el módulo, guarde el script como VMManagement.ps1 y ejecútelo usando PowerShell. Asegúrese de tener los privilegios administrativos necesarios y que Hyper-V esté habilitado en su sistema.

.VMManagement.ps1

Funciones

Get-Run-AsAdministrator

Asegura que el script se ejecute con privilegios de administrador.

Parámetros:

• ScriptPath : la ruta al script que debe ejecutarse como administrador.

Ejemplo:

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

Enable-HyperV

Comprueba si Hyper-V está habilitado en el sistema y lo habilita si no.

Ejemplo:

 Enable-HyperV 

Test-PwshVersion

Comprueba si la versión actual de PowerShell es 7 o más.

Ejemplo:

 Test-PwshVersion 

Get-VMList

Recupera una lista de nombres de VM.

Ejemplo:

 $vms = Get-VMList 

Get-VMName

Le pide al usuario que seleccione una VM de una lista.

Ejemplo:

 $vmName = Get-VMName 

Get-UserName

Le pide al usuario que ingrese un nombre de usuario para SSH.

Ejemplo:

 $username = Get-UserName 

Start-VMInstance

Inicia una VM especificada.

Parámetros:

• vmName : el nombre de la VM para comenzar.

Ejemplo:

 $vm = Start-VMInstance - vmName " MyVM " 

Add-Dash

Agrega guiones a una cadena cada dos caracteres.

Parámetros:

• str : la cadena a la que se agregarán guiones.

Ejemplo:

 $dashedString = Add-Dash - str " A1B2C3D4 " 

Get-VMIP

Recupera la dirección IP de una VM especificada.

Parámetros:

• vmObject : el objeto VM para el cual se puede recuperar la dirección IP.

Ejemplo:

 $ipAddress = Get-VMIP - vmObject $vm 

Stop-VMInstance

Detiene una VM especificada.

Parámetros:

• vmName : el nombre de la VM para detenerse.

Ejemplo:

 Stop-VMInstance - vmName " MyVM " 

Invoke-SSHConnection

Inicia una conexión SSH a una VM especificada.

Parámetros:

• user : el nombre de usuario para la conexión SSH.
• vmIP : la dirección IP de la VM.

Ejemplo:

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

Get-VMHeartbeat

Verifica el estado del latido de una VM especificada.

Parámetros:

• vmObject : el objeto VM para el cual se va a verificar el estado del corazón.

Ejemplo:

 $heartbeat = Get-VMHeartbeat - vmObject $vm 

Ejemplo de flujo de trabajo

1. Asegúrese de que el script se ejecute con los privilegios del administrador.
2. Habilite Hyper-V si aún no está habilitado.
3. Verifique que la versión de PowerShell sea 7 o mayor.
4. Recupere y muestre una lista de máquinas virtuales para que el usuario la seleccione.
5. Inicie la VM seleccionada.
6. Verifique el estado del corazón de la VM.
7. Recupere la dirección IP de la VM.
8. Iniciar una conexión SSH con la VM.
9. Detén la VM después de que termine la sesión SSH.