hyper v direct ssh

Hyper-V-Direct-SSH

Visão geral do projeto

hyper-v-direct-ssh é um módulo PowerShell projetado para gerenciar máquinas virtuais Hyper-V (VMS) e estabelecer conexões SSH diretas com elas. Este módulo fornece funções para iniciar e interromper as VMs, recuperar informações da VM e garantir que o script seja executado com privilégios de administrador.

Características

• Verifique se o script é executado com privilégios de administrador.
• Verifique e habilite o Hyper-V no sistema.
• Verificar a versão do PowerShell é 7 ou superior.
• Recuperar e gerenciar nomes de VM.
• Inicie e pare as vms.
• Recuperar endereços IP VM.
• Inicie as conexões SSH com as VMs.
• Verifique o status de batimento cardíaco da VM.

Uso

Pré -requisitos

Verifique os privilégios administrativos

Certifique -se de ter privilégios administrativos em seu sistema. O script requer permissões elevadas para gerenciar o Hyper-V e executar certos comandos.

Ativar hyper-v

Verifique se o Hyper-V está ativado no seu sistema. Você pode ativar o Hyper-V usando as seguintes etapas:

1. Open PowerShell como administrador.
2. Execute o seguinte comando para ativar o Hyper-V:

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

3. Reinicie seu sistema para aplicar as alterações.

Instale o PowerShell 7 ou superior

O script requer PowerShell versão 7 ou maior. Siga estas etapas para instalar ou atualizar o PowerShell:

1. Vá para a página PowerShell Github libera.
2. Faça o download da versão mais recente do seu sistema operacional.
3. Siga as instruções de instalação fornecidas na página de liberação.

Instale o cliente SSH

Verifique se o cliente SSH está instalado no seu sistema. Você pode instalar o cliente OpenSSH seguindo estas etapas:

No Windows:

1. Open PowerShell como administrador.
2. Execute o seguinte comando:

    Add-WindowsCapability - Online - Name OpenSSH.Client * 

No macOS:

1. Terminal aberto.
2. Execute o seguinte comando para verificar se o SSH já está instalado:

   ssh -V

3. Se o SSH não estiver instalado, use o Homebrew para instalá -lo:

   brew install openssh

No Linux:

1. Terminal aberto.

2. Execute o seguinte comando:

   sudo apt-get install openssh-client

   ou para distribuições baseadas em RPM:

   sudo yum install openssh-clients

Configure a rede para VMs

Certifique -se de que suas VMs estejam configuradas para obter um endereço IP e que sejam acessíveis via SSH. Verifique as configurações e conectividade da rede antes de executar o script.

Baixe o script

Salve o script como VMManagement.ps1 em sua máquina local. Verifique se o caminho do arquivo está acessível e anote o caminho para executar o script.

Execute o script

1. Open PowerShell como administrador.
2. Navegue até o diretório em que o script VMManagement.ps1 é salvo.
3. Execute o script usando o seguinte comando:

   .VMManagement.ps1

Executando o script

Para usar o módulo, salve o script como VMManagement.ps1 e execute -o usando o PowerShell. Verifique se você possui os privilégios administrativos necessários e se o Hyper-V está ativado no seu sistema.

.VMManagement.ps1

Funções

Get-Run-AsAdministrator

Garante que o script seja executado com privilégios de administrador.

Parâmetros:

• ScriptPath : o caminho para o script que precisa ser executado como administrador.

Exemplo:

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

Enable-HyperV

Verifica se o Hyper-V está ativado no sistema e o permite, se não.

Exemplo:

 Enable-HyperV 

Test-PwshVersion

Verifica se a versão atual do PowerShell é 7 ou superior.

Exemplo:

 Test-PwshVersion 

Get-VMList

Recupera uma lista de nomes da VM.

Exemplo:

 $vms = Get-VMList 

Get-VMName

Solicita ao usuário selecionar uma VM em uma lista.

Exemplo:

 $vmName = Get-VMName 

Get-UserName

Solicita ao usuário inserir um nome de usuário para SSH.

Exemplo:

 $username = Get-UserName 

Start-VMInstance

Inicia uma VM especificada.

Parâmetros:

• vmName : o nome da VM para iniciar.

Exemplo:

 $vm = Start-VMInstance - vmName " MyVM " 

Add-Dash

Adiciona traços a uma string a cada dois caracteres.

Parâmetros:

• str : a string à qual os traços serão adicionados.

Exemplo:

 $dashedString = Add-Dash - str " A1B2C3D4 " 

Get-VMIP

Recupera o endereço IP de uma VM especificada.

Parâmetros:

• vmObject : O objeto VM para o qual o endereço IP deve ser recuperado.

Exemplo:

 $ipAddress = Get-VMIP - vmObject $vm 

Stop-VMInstance

Pare uma VM especificada.

Parâmetros:

• vmName : o nome da VM para parar.

Exemplo:

 Stop-VMInstance - vmName " MyVM " 

Invoke-SSHConnection

Inicia uma conexão SSH com uma VM especificada.

Parâmetros:

• user : o nome de usuário para a conexão SSH.
• vmIP : o endereço IP da VM.

Exemplo:

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

Get-VMHeartbeat

Verifica o status de batimento cardíaco de uma VM especificada.

Parâmetros:

• vmObject : O objeto VM para o qual o status do batimento cardíaco deve ser verificado.

Exemplo:

 $heartbeat = Get-VMHeartbeat - vmObject $vm 

Exemplo de fluxo de trabalho

1. Verifique se o script é executado com privilégios de administrador.
2. Ativar Hyper-V se ainda não estiver ativado.
3. Verifique se a versão do PowerShell é 7 ou superior.
4. Recupere e exiba uma lista de VMs para o usuário selecionar.
5. Inicie a VM selecionada.
6. Verifique o status de batimento cardíaco da VM.
7. Recupere o endereço IP da VM.
8. Inicie uma conexão SSH com a VM.
9. Pare a VM após o término da sessão SSH.