hyper v direct ssh

Hyper-V-Direkt-SSH

Projektübersicht

hyper-v-direct-ssh ist ein PowerShell-Modul, mit dem Hyper-V Virtual Machines (VMs) verwaltet und direkte SSH-Verbindungen zu ihnen hergestellt werden. Dieses Modul bietet Funktionen zum Starten und Stoppen von VMs, zum Abrufen von VM -Informationen und zum sicheren Sicherstellen, dass das Skript mit Administratorberechtigungen ausgeführt wird.

Merkmale

• Stellen Sie sicher, dass das Skript mit Administratorberechtigungen ausgeführt wird.
• Überprüfen und aktivieren Sie Hyper-V im System.
• Überprüfen Sie, ob die PowerShell -Version 7 oder höher ist.
• Abrufen und Verwalten von VM -Namen.
• Starten Sie und stoppen Sie VMs.
• Abrufen von VM IP -Adressen.
• SSH -Verbindungen zu VMs einleiten.
• Überprüfen Sie den Status des VM -Herzschlags.

Verwendung

Voraussetzungen

Überprüfen Sie die Verwaltungsrechte

Stellen Sie sicher, dass Sie über administrative Berechtigungen in Ihrem System verfügen. Das Skript erfordert erhöhte Berechtigungen, um Hyper-V zu verwalten und bestimmte Befehle auszuführen.

Aktivieren Sie Hyper-V

Stellen Sie sicher, dass Hyper-V in Ihrem System aktiviert ist. Sie können Hyper-V in den folgenden Schritten aktivieren:

1. Open PowerShell als Administrator.
2. Führen Sie den folgenden Befehl aus, um Hyper-V zu aktivieren:

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

3. Starten Sie Ihr System neu, um die Änderungen anzuwenden.

Installieren Sie PowerShell 7 oder mehr

Das Skript erfordert PowerShell Version 7 oder höher. Befolgen Sie diese Schritte, um PowerShell zu installieren oder zu aktualisieren:

1. Gehen Sie zur Seite von PowerShell Github Releases.
2. Laden Sie die neueste Version für Ihr Betriebssystem herunter.
3. Befolgen Sie die auf der Release -Seite angegebenen Installationsanweisungen.

SSH -Client installieren

Stellen Sie sicher, dass der SSH -Client auf Ihrem System installiert ist. Sie können den OpenSSH -Client installieren, indem Sie folgende Schritte befolgen:

Unter Windows:

1. Open PowerShell als Administrator.
2. Führen Sie den folgenden Befehl aus:

    Add-WindowsCapability - Online - Name OpenSSH.Client * 

Auf macos:

1. Offenes Terminal.
2. Führen Sie den folgenden Befehl aus, um zu überprüfen, ob SSH bereits installiert ist:

   ssh -V

3. Wenn SSH nicht installiert ist, verwenden Sie Homebrew, um es zu installieren:

   brew install openssh

Unter Linux:

1. Offenes Terminal.

2. Führen Sie den folgenden Befehl aus:

   sudo apt-get install openssh-client

   oder für RPM-basierte Verteilungen:

   sudo yum install openssh-clients

Konfigurieren Sie das Netzwerk für VMs

Stellen Sie sicher, dass Ihre VMs so konfiguriert sind, dass sie eine IP -Adresse erhalten und über SSH zugänglich sind. Überprüfen Sie die Netzwerkeinstellungen und die Konnektivität, bevor Sie das Skript ausführen.

Laden Sie das Skript herunter

Speichern Sie das Skript als VMManagement.ps1 auf Ihrer lokalen Maschine. Stellen Sie sicher, dass der Dateipfad zugänglich ist, und notieren Sie den Pfad zum Ausführen des Skripts.

Führen Sie das Skript aus

1. Open PowerShell als Administrator.
2. Navigieren Sie zum Verzeichnis, in dem das Skript VMManagement.ps1 gespeichert wird.
3. Führen Sie das Skript mit dem folgenden Befehl aus:

   .VMManagement.ps1

Ausführen des Skripts

Um das Modul zu verwenden, speichern Sie das Skript als VMManagement.ps1 und führen Sie es mit PowerShell aus. Stellen Sie sicher, dass Sie über die erforderlichen Verwaltungsberechtigungen verfügen und dass Hyper-V in Ihrem System aktiviert ist.

.VMManagement.ps1

Funktionen

Get-Run-AsAdministrator

Stellt sicher, dass das Skript mit Administratorrechten ausgeführt wird.

Parameter:

• ScriptPath : Der Pfad zum Skript, der als Administrator ausgeführt werden muss.

Beispiel:

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

Enable-HyperV

Überprüft, ob Hyper-V im System aktiviert ist, und es ermöglicht, wenn nicht.

Beispiel:

 Enable-HyperV 

Test-PwshVersion

Überprüft, ob die aktuelle PowerShell -Version 7 oder höher ist.

Beispiel:

 Test-PwshVersion 

Get-VMList

Ruft eine Liste von VM -Namen ab.

Beispiel:

 $vms = Get-VMList 

Get-VMName

Fordert den Benutzer auf, eine VM aus einer Liste auszuwählen.

Beispiel:

 $vmName = Get-VMName 

Get-UserName

Fordert den Benutzer auf, einen Benutzernamen für SSH einzugeben.

Beispiel:

 $username = Get-UserName 

Start-VMInstance

Startet eine bestimmte VM.

Parameter:

• vmName : Der Name des VM zu beginnen.

Beispiel:

 $vm = Start-VMInstance - vmName " MyVM " 

Add-Dash

Fügt Striche zu einer Zeichenfolge alle zwei Zeichen hinzu.

Parameter:

• str : Die Zeichenfolge, zu der Striche hinzugefügt werden.

Beispiel:

 $dashedString = Add-Dash - str " A1B2C3D4 " 

Get-VMIP

Ruft die IP -Adresse einer angegebenen VM ab.

Parameter:

• vmObject : Das VM -Objekt, für das die IP -Adresse abgerufen werden soll.

Beispiel:

 $ipAddress = Get-VMIP - vmObject $vm 

Stop-VMInstance

Stoppt eine bestimmte VM.

Parameter:

• vmName : Der Name der VM zum Stoppen.

Beispiel:

 Stop-VMInstance - vmName " MyVM " 

Invoke-SSHConnection

Initiiert eine SSH -Verbindung zu einer bestimmten VM.

Parameter:

• user : Der Benutzername für die SSH -Verbindung.
• vmIP : Die IP -Adresse der VM.

Beispiel:

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

Get-VMHeartbeat

Überprüft den Herzschlagstatus einer angegebenen VM.

Parameter:

• vmObject : Das VM -Objekt, auf das der Herzschlagstatus überprüft werden soll.

Beispiel:

 $heartbeat = Get-VMHeartbeat - vmObject $vm 

Beispiel Workflow

1. Stellen Sie sicher, dass das Skript mit Administratorrechten ausgeführt wird.
2. Aktivieren Sie Hyper-V, wenn es noch nicht aktiviert ist.
3. Überprüfen Sie, ob die PowerShell -Version 7 oder höher ist.
4. Abrufen und zeigen Sie eine Liste von VMs an, aus denen der Benutzer ausgewählt werden kann.
5. Starten Sie die ausgewählte VM.
6. Überprüfen Sie den Herzschlagstatus des VM.
7. Abrufen Sie die IP -Adresse des VM ab.
8. Initiieren Sie eine SSH -Verbindung zum VM.
9. Stoppen Sie die VM nach Ende der SSH -Sitzung.