hyper v direct ssh

hyper-v-direct-ssh

Aperçu du projet

hyper-v-direct-ssh est un module PowerShell conçu pour gérer les machines virtuelles hyper-V (VM) et établir des connexions SSH directes avec eux. Ce module fournit des fonctions pour démarrer et arrêter les machines virtuelles, récupérer des informations VM et garantir que le script s'exécute avec les privilèges de l'administrateur.

Caractéristiques

• Assurez-vous que le script s'exécute avec les privilèges de l'administrateur.
• Vérifiez et activez Hyper-V sur le système.
• Vérifiez que la version PowerShell est de 7 ou plus.
• Récupérer et gérer les noms de machines virtuelles.
• Démarrer et arrêter les machines virtuelles.
• Récupérez les adresses IP VM.
• Initier les connexions SSH aux machines virtuelles.
• Vérifiez le statut de rythme cardiaque VM.

Usage

Condition préalable

Vérifiez les privilèges administratifs

Assurez-vous d'avoir des privilèges administratifs sur votre système. Le script nécessite des autorisations élevées pour gérer Hyper-V et exécuter certaines commandes.

Activer Hyper-V

Assurez-vous que Hyper-V est activé sur votre système. Vous pouvez activer Hyper-V en utilisant les étapes suivantes:

1. Open PowerShell en tant qu'administrateur.
2. Exécutez la commande suivante pour activer Hyper-V:

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

3. Redémarrez votre système pour appliquer les modifications.

Installer PowerShell 7 ou plus

Le script nécessite PowerShell version 7 ou plus. Suivez ces étapes pour installer ou mettre à jour PowerShell:

1. Accédez à la page PowerShell GitHub Release.
2. Téléchargez la dernière version de votre système d'exploitation.
3. Suivez les instructions d'installation fournies sur la page de version.

Installer le client SSH

Assurez-vous que le client SSH est installé sur votre système. Vous pouvez installer le client OpenSSH en suivant ces étapes:

Sur Windows:

1. Open PowerShell en tant qu'administrateur.
2. Exécutez la commande suivante:

    Add-WindowsCapability - Online - Name OpenSSH.Client * 

Sur macOS:

1. Terminal ouvert.
2. Exécutez la commande suivante pour vérifier si SSH est déjà installé:

   ssh -V

3. Si SSH n'est pas installé, utilisez Homebrew pour l'installer:

   brew install openssh

Sur Linux:

1. Terminal ouvert.

2. Exécutez la commande suivante:

   sudo apt-get install openssh-client

   ou pour les distributions basées sur RPM:

   sudo yum install openssh-clients

Configurer le réseau pour les machines virtuelles

Assurez-vous que vos machines virtuelles sont configurées pour obtenir une adresse IP et qu'elles sont accessibles via SSH. Vérifiez les paramètres du réseau et la connectivité avant d'exécuter le script.

Télécharger le script

Enregistrez le script sous VMManagement.ps1 sur votre machine locale. Assurez-vous que le chemin du fichier est accessible et notez le chemin d'accès à l'exécution du script.

Exécutez le script

1. Open PowerShell en tant qu'administrateur.
2. Accédez au répertoire où le script VMManagement.ps1 est enregistré.
3. Exécutez le script à l'aide de la commande suivante:

   .VMManagement.ps1

Exécuter le script

Pour utiliser le module, enregistrez le script en tant que VMManagement.ps1 et exécutez-le à l'aide de PowerShell. Assurez-vous d'avoir les privilèges administratifs nécessaires et que Hyper-V est activé sur votre système.

.VMManagement.ps1

Fonctions

Get-Run-AsAdministrator

S'assure que le script s'exécute avec les privilèges de l'administrateur.

Paramètres:

• ScriptPath : le chemin vers le script qui doit être exécuté en tant qu'administrateur.

Exemple:

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

Enable-HyperV

Vérifie si Hyper-V est activé sur le système et le permet.

Exemple:

 Enable-HyperV 

Test-PwshVersion

Vérifie si la version PowerShell actuelle est de 7 ou plus.

Exemple:

 Test-PwshVersion 

Get-VMList

Récupère une liste de noms de machines virtuelles.

Exemple:

 $vms = Get-VMList 

Get-VMName

Invite l'utilisateur à sélectionner une machine virtuelle dans une liste.

Exemple:

 $vmName = Get-VMName 

Get-UserName

Invite l'utilisateur à entrer un nom d'utilisateur pour SSH.

Exemple:

 $username = Get-UserName 

Start-VMInstance

Démarre une machine virtuelle spécifiée.

Paramètres:

• vmName : le nom de la machine virtuelle pour commencer.

Exemple:

 $vm = Start-VMInstance - vmName " MyVM " 

Add-Dash

Ajoute des tirets à une chaîne tous les deux caractères.

Paramètres:

• str : La chaîne à laquelle des tirets seront ajoutés.

Exemple:

 $dashedString = Add-Dash - str " A1B2C3D4 " 

Get-VMIP

Récupère l'adresse IP d'une machine virtuelle spécifiée.

Paramètres:

• vmObject : l'objet VM pour lequel l'adresse IP doit être récupérée.

Exemple:

 $ipAddress = Get-VMIP - vmObject $vm 

Stop-VMInstance

Arrête une machine virtuelle spécifiée.

Paramètres:

• vmName : le nom de la machine virtuelle à arrêter.

Exemple:

 Stop-VMInstance - vmName " MyVM " 

Invoke-SSHConnection

Initie une connexion SSH à une machine virtuelle spécifiée.

Paramètres:

• user : le nom d'utilisateur de la connexion SSH.
• vmIP : l'adresse IP de la machine virtuelle.

Exemple:

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

Get-VMHeartbeat

Vérifie l'état du rythme cardiaque d'une machine virtuelle spécifiée.

Paramètres:

• vmObject : l'objet VM pour lequel le statut de battement de cœur doit être vérifié.

Exemple:

 $heartbeat = Get-VMHeartbeat - vmObject $vm 

Exemple de workflow

1. Assurez-vous que le script s'exécute avec les privilèges de l'administrateur.
2. Activez Hyper-V s'il n'est pas déjà activé.
3. Vérifiez que la version PowerShell est de 7 ou plus.
4. Récupérez et affichez une liste de machines virtuelles pour que l'utilisateur puisse sélectionner.
5. Démarrez la machine virtuelle sélectionnée.
6. Vérifiez le statut de rythme cardiaque de la machine virtuelle.
7. Récupérez l'adresse IP de la machine virtuelle.
8. Lancer une connexion SSH à la machine virtuelle.
9. Arrêtez la machine virtuelle après la fin de la session SSH.