Automatisierung und Verwaltung virtueller Computer mithilfe von PowerShell

Sie können PowerShell Direct verwenden, um beliebige PowerShell in einem Windows 10 oder höher oder Windows Server 2016 oder neueren virtuellen Computer von Ihrem Hyper-V-Host aus auszuführen. Verwenden Sie PowerShell Direct unabhängig von den Netzwerkkonfigurations- oder Remoteverwaltungseinstellungen.

Es folgen einige Möglichkeiten, wie Sie PowerShell Direct ausführen können:

• Als interaktive Sitzung mit dem Cmdlet Enter-PSSession
• Als Einzelverwendungsabschnitt zum Ausführen eines einzelnen Befehls oder Skripts mit dem Cmdlet Invoke-Command
• Als dauerhafte Sitzung (Build 14280 und höher) mit den Cmdlets New-PSSession, Copy-Item und Remove-PSSession

Requirements (Anforderungen)

Betriebssystemanforderungen:

• Host: Windows 10, Windows Server 2016 oder höher mit Hyper-V.
• Gast- bzw. virtueller Computer: Windows 10, Windows Server 2016 oder höher.

Wenn Sie ältere virtuelle Computer verwalten, verwenden Sie die Verbindung mit virtuellen Computern (VMConnect) oder Konfigurieren Sie ein virtuelles Netzwerk für den virtuellen Computer.

Konfigurationsanforderungen:

• Der virtuelle Computer muss lokal auf dem Host ausgeführt werden.
• Der virtuelle Computer muss gestartet sein und mit mindestens einem konfigurierten Benutzerprofil ausgeführt werden.
• Sie müssen in dem Hostcomputer als Hyper-V-Administrator angemeldet sein.
• Sie müssen gültige Anmeldeinformationen für den virtuellen Computer angeben.

Erstellen und Beenden einer interaktiven PowerShell-Sitzung

Die einfachste Möglichkeit, PowerShell auf einem virtuellen Computer auszuführen, ist der Start einer interaktiven Sitzung.

Wenn die Sitzung gestartet wird, werden die eingegebenen Befehle auf dem virtuellen Computer ausgeführt – genau so, als würden Sie die Befehle direkt in eine PowerShell-Sitzung auf dem virtuellen Computer selbst eingeben.

So starten Sie eine interaktive Sitzung:

1. Öffnen Sie PowerShell auf dem Hyper-V-Host als Administrator.

2. Führen Sie einen der folgenden Befehle aus, um eine interaktive Sitzung mit dem Namen oder der GUID des virtuellen Computers zu erstellen:

   Enter-PSSession -VMName <VMName>
   Enter-PSSession -VMId <VMId>
   

   Geben Sie Anmeldeinformationen für den virtuellen Computer ein, wenn Sie dazu aufgefordert werden.

3. Führen Sie Befehle auf dem virtuellen Computer aus. Der Name des virtuellen Computers wird als Präfix (VMName) für Ihre PowerShell-Eingabeaufforderung wie folgt angezeigt:

   [VMName]: PS C:\>
   

   Jeder Befehl wird auf dem virtuellen Computer ausgeführt. Um dies zu testen, können Sie ipconfig oder hostname ausführen, um sicherzustellen, dass diese Befehle tatsächlich auf dem virtuellen Computer ausgeführt werden.

4. Wenn Sie fertig sind, führen Sie den folgenden Befehl aus, um die Sitzung zu schließen:

    Exit-PSSession 
   

Weitere Informationen zu diesen Cmdlets finden Sie unter Enter-PSSession und Exit-PSSession.

Ausführen eines Skripts oder Befehls mit „Invoke-Command“

PowerShell Direct mit Invoke-Command eignet sich ideal für Situationen, in denen Sie nur einen Befehl oder ein Skript auf einem virtuellen Computer ausführen, danach aber nicht weiter mit dem virtuellen Computer interagieren möchten.

So führen Sie einen einzelnen Befehl aus:

1. Öffnen Sie PowerShell auf dem Hyper-V-Host als Administrator.

2. Führen Sie einen der folgenden Befehle aus, um eine Sitzung mit dem Namen oder der GUID des virtuellen Computers zu erstellen:

   Invoke-Command -VMName <VMName> -ScriptBlock { command } 
   Invoke-Command -VMId <VMId> -ScriptBlock { command }
   

   Geben Sie Anmeldeinformationen für den virtuellen Computer ein, wenn Sie dazu aufgefordert werden.

   Der Befehl wird auf dem virtuellen Computer ausgeführt. Wenn der Befehl eine Konsolenausgabe umfasst, erfolgt diese auf Ihrer Konsole. Die Verbindung wird automatisch geschlossen, nachdem der Befehl ausgeführt wurde.

So führen Sie ein Skript aus:

1. Öffnen Sie PowerShell auf dem Hyper-V-Host als Administrator.

2. Führen Sie einen der folgenden Befehle aus, um eine Sitzung mit dem Namen oder der GUID des virtuellen Computers zu erstellen:

   Invoke-Command -VMName <VMName> -FilePath C:\host\script_path\script.ps1 
   Invoke-Command -VMId <VMId> -FilePath C:\host\script_path\script.ps1 
   

   Geben Sie Anmeldeinformationen für den virtuellen Computer ein, wenn Sie dazu aufgefordert werden.

   Das Skript wird auf dem virtuellen Computer ausgeführt. Die Verbindung wird automatisch geschlossen, nachdem der Befehl ausgeführt wurde.

Weitere Informationen zu diesem Cmdlet finden Sie unter Invoke-Command.

Kopieren von Dateien mit New-PSSession und Copy-Item

Permanente PowerShell-Sitzungen sind unglaublich nützlich, wenn Sie Skripts schreiben, die Aktionen über einen oder mehrere Remotecomputer hinweg koordinieren. Nach dem Erstellen sind permanente Sitzungen im Hintergrund vorhanden, bis Sie sich dafür entscheiden, sie zu löschen. Das bedeutet, dass Sie mit Invoke-Command und Enter-PSSession immer wieder auf die gleiche Sitzung verweisen können, ohne Anmeldeinformationen übergeben zu müssen.

Ebenso behalten Sitzungen ihren Zustand bei. Da permanente Sitzungen – wie der Name schon sagt – dauerhaft sind, werden jegliche Variablen, die in einer Sitzung erstellt oder an eine Sitzung übergeben wurden, über mehrere Aufrufe hinweg beibehalten. Für die Arbeit mit permanenten Sitzungen sind verschiedene Tools verfügbar. In diesem Beispiel werden New-PSSession und Copy-Item verwendet, um Daten vom Host auf einen virtuellen Computer und von einem virtuellen Computer auf den Host zu verschieben.

So erstellen Sie eine Sitzung und kopieren anschließend Dateien:

1. Öffnen Sie PowerShell auf dem Hyper-V-Host als Administrator.

2. Führen Sie einen der folgenden Befehle aus, um mit New-PSSession eine permanente PowerShell-Sitzung auf dem virtuellen Computer zu erstellen.

   $s = New-PSSession -VMName <VMName> -Credential (Get-Credential)
   $s = New-PSSession -VMId <VMId> -Credential (Get-Credential)
   

   Geben Sie Anmeldeinformationen für den virtuellen Computer ein, wenn Sie dazu aufgefordert werden.

   Warnung

   Builds vor Buildnummer 14500 weisen einen Fehler auf. Wenn Anmeldeinformationen nicht explizit mit dem Flag -Credential angegeben werden, stürzt der Dienst im Gastsystem ab und muss neu gestartet werden. Wenn Sie dieses Problem erreicht haben, sind Problemumgehungsanweisungen im Abschnitt Fehler: Möglicherweise wurde eine Remotesitzung beendet verfügbar.

3. Kopieren Sie eine Datei auf den virtuellen Computer.

   Um C:\host_path\data.txt vom Host auf den virtuellen Computer zu kopieren, führen Sie folgenden Befehl aus:

   Copy-Item -ToSession $s -Path C:\host_path\data.txt -Destination C:\guest_path\
   

4. Kopieren Sie eine Datei vom virtuellen Computer auf den Host.

   Um C:\guest_path\data.txt vom virtuellen Computer auf den Host zu kopieren, führen Sie folgenden Befehl aus:

   Copy-Item -FromSession $s -Path C:\guest_path\data.txt -Destination C:\host_path\
   

5. Beenden Sie die permanente Sitzung mit Remove-PSSession.

   Remove-PSSession $s
   

Problembehandlung

PowerShell Direct zeigt eine kleine Menge von Fehlermeldungen an. In den folgenden Abschnitten werden die häufigsten Fehlermeldungen, einige Ursachen und Tools zur Diagnose von Problemen beschrieben.

Parameter „-VMName“ oder „-VMID“ nicht vorhanden

Problem:

Enter-PSSession, Invoke-Command oder New-PSSession weisen keinen Parameter -VMName oder -VMId auf.

Mögliche Ursachen:

Der wahrscheinlichste Grund ist, dass PowerShell Direct von Ihrem Hostbetriebssystem nicht unterstützt wird.

Sie können Ihren Windows-Build mithilfe des folgenden Befehls überprüfen:

[System.Environment]::OSVersion.Version

Wenn Sie einen unterstützten Build ausführen, ist es auch möglich, dass Ihre PowerShell-Version PowerShell Direct nicht unterstützt. Um PowerShell Direct und JEA verwenden zu können, müssen Sie über Hauptversion 5 oder höher verfügen.

Sie können Ihren PowerShell-Versionsbuild mithilfe des folgenden Befehls überprüfen:

$PSVersionTable.PSVersion

Fehler: Eine Remotesitzung wurde möglicherweise getrennt.

Fehlermeldung:

Enter-PSSession: Es ist ein Fehler aufgetreten, den Windows PowerShell nicht verarbeiten kann. Eine Remotesitzung wurde möglicherweise getrennt.

Mögliche Ursachen:

• Der virtuelle Computer ist vorhanden, wird aber nicht ausgeführt.
• Das Gastbetriebssystem unterstützt PowerShell Direct nicht. Weitere Informationen finden Sie unter Anforderungen.
• PowerShell ist noch nicht auf dem Gast verfügbar.
  • Der Startvorgang des Betriebssystems ist noch nicht abgeschlossen.
  • Das Betriebssystem kann nicht ordnungsgemäß starten.
  • Bei einigen Ereignissen zur Startzeit sind Benutzereingaben erforderlich.

Sie können das Cmdlet Get-VM verwenden, um zu überprüfen, welche virtuellen Computer auf dem Host ausgeführt werden.

Fehlermeldung:

New-PSSession: Es ist ein Fehler aufgetreten, den Windows PowerShell nicht verarbeiten kann. Eine Remotesitzung wurde möglicherweise getrennt.

Mögliche Ursachen:

• Einer der oben genannten Gründe – alle sind gleichermaßen anwendbar für New-PSSession
• Ein Fehler in aktuellen Builds. Anmeldeinformationen müssen explizit mithilfe von -Credential übergeben werden. Wenn dies passiert, reagiert der gesamte Dienst im Gastbetriebssystem nicht mehr und muss neu gestartet werden. Sie können mit Enter-PSSession überprüfen, ob die Sitzung noch verfügbar ist.

Um das Problem mit den Anmeldeinformationen zu umgehen, melden Sie sich mithilfe von VMConnect am virtuellen Computer an, öffnen Sie PowerShell, und starten Sie den vmicvmsession-Dienst mithilfe des folgenden PowerShell-Befehls neu:

Restart-Service -Name vmicvmsession

Fehler: Parametersatz kann nicht aufgelöst werden.

Fehlermeldung:

Enter-PSSession: Der Parametersatz kann mit den angegebenen benannten Parametern nicht aufgelöst werden.

Mögliche Ursachen:

• -RunAsAdministrator wird beim Herstellen von Verbindungen mit virtuellen Computern nicht unterstützt.

  Beim Verbinden mit einem Windows-Container erlaubt das Flag -RunAsAdministrator Administratorverbindungen ohne explizite Anmeldeinformationen. Da virtuelle Computer dem Host keinen impliziten Administratorzugriff gewähren, müssen Sie die Anmeldeinformationen explizit eingeben.

Administratoranmeldeinformationen können dem virtuellen Computer über den Parameter -Credential übergeben oder auf Aufforderung manuell eingegeben werden.

Fehler: Die Anmeldeinformationen sind ungültig.

Fehlermeldung:

Enter-PSSession: Die Anmeldeinformationen sind ungültig.

Mögliche Ursachen:

• Die Gastanmeldeinformationen konnten nicht überprüft werden.
  • Die angegebenen Anmeldeinformationen sind falsch.
  • Es gibt keine Benutzerkonten auf dem Gast (das Betriebssystem wurde noch nicht gestartet)
  • Wenn Sie die Verbindung als Administrator herstellen: Der Administrator wurde nicht als aktiver Benutzer festgelegt. Erfahren Sie mehr unter Aktivieren und Deaktivieren des integrierten Administratorkontos

Fehler: Der Parameter „VMName“ kann nicht in einen virtuellen Computer aufgelöst werden.

Fehlermeldung:

Enter-PSSession: Der Eingabeparameter VMName kann nicht in einen virtuellen Computer aufgelöst werden.

Mögliche Ursachen:

• Sie sind kein Hyper-V-Administrator.
• Der virtuelle Computer ist nicht vorhanden.

Mit dem Cmdlet Get-VM können Sie überprüfen, ob die von Ihnen verwendeten Anmeldeinformationen die Rolle „Hyper-V-Administrator“ enthalten und welche VMs lokal auf dem Host ausgeführt werden und gestartet wurden.

Beispiele und Benutzerleitfäden

PowerShell Direct unterstützt Just Enough Administration (JEA).

Sehen Sie sich die Beispiele auf GitHub an.