PowerShell Direct: zarządzanie maszyną wirtualną bez sieci i błąd „A remote session might have ended”

PowerShell Direct łączy host Hyper-V z maszyną wirtualną bez sieci. Zobacz wymagania, polecenia -VMName i naprawę błędu A remote session might have ended.

  • Windows Server · Bezpieczny dostęp (JEA, SSH, Direct)
  • Poziom: średni
  • Czas: 15–30 minut
  • PowerShell Direct
  • -VMName
  • A remote session might have ended
  • The credential is invalid
  • vmicvmsession
  • Hyper-V Administrators

Na czym polega problem

PowerShell Direct pozwala uruchamiać polecenia wewnątrz maszyny wirtualnej Hyper-V prosto z hosta, bez konfiguracji sieci, zapory i WinRM w gościu. To wygodne, gdy maszyna straciła adres IP, ma uszkodzoną konfigurację sieci albo dopiero ją instalujesz. Wystarczą uprawnienia administratora Hyper-V na hoście i poświadczenia konta w maszynie wirtualnej.

Funkcja ma jasne wymagania i niewielki zestaw komunikatów o błędach. Poniżej zbieramy je razem z przyczynami podanymi przez Microsoft oraz z poleceniami do kopiowania plików przez sesję.

Objawy

  • Enter-PSSession -VMName kończy się komunikatem An error occurred that Windows PowerShell can't handle. A remote session might have ended.
  • Komunikat The credential is invalid pojawia się, mimo że wydaje się, że hasło jest poprawne.
  • Komunikat The input VMName parameter does not resolve to any virtual machine, chociaż maszyna jest widoczna w Menedżerze Hyper-V.
  • Polecenia Enter-PSSession, Invoke-Command i New-PSSession nie mają parametrów -VMName lub -VMId.
  • Parameter set cannot be resolved przy użyciu parametru RunAsAdministrator.

Najczęstsze przyczyny

  1. Maszyna wirtualna nie jest uruchomiona, nie skończyła startu systemu, albo system gościa nie obsługuje PowerShell Direct (wymagany Windows 10 lub Windows Server 2016 i nowsze).
  2. Konto na hoście nie należy do administratorów Hyper-V, więc nazwa maszyny nie jest rozpoznawana.
  3. Poświadczenia gościa są nieprawidłowe, w gościu nie ma jeszcze żadnych kont użytkowników albo wbudowane konto Administrator nie jest aktywne.
  4. Host działa pod starszym systemem niż Windows 10 lub Windows Server 2016, albo używasz zbyt starej wersji PowerShella.
  5. Parametr RunAsAdministrator działa tylko dla kontenerów Windows; maszyna wirtualna wymaga jawnych poświadczeń.

Rozwiązanie krok po kroku

  1. Sprawdź wymagania hosta i wersję PowerShella

    Host musi działać pod Windows 10, Windows Server 2016 lub nowszym i mieć rolę Hyper-V. Dla PowerShell Direct oraz JEA główna wersja PowerShella musi wynosić co najmniej 5. Maszyna wirtualna działa lokalnie na tym hoście.

    [System.Environment]::OSVersion.Version
    $PSVersionTable.PSVersion
  2. Upewnij się, że maszyna jest uruchomiona i widoczna

    Uruchom Get-VM w sesji administratora Hyper-V. Jeśli polecenie nie pokazuje maszyny, konto nie ma roli administratora Hyper-V lub maszyna nie istnieje na tym hoście.

    Get-VM | Format-Table Name, State, Uptime
  3. Otwórz sesję interaktywną z jawnymi poświadczeniami

    Podaj nazwę lub identyfikator maszyny i poświadczenia konta z wnętrza maszyny. Prefiks w znaku zachęty pokaże nazwę maszyny, gdy połączenie się powiedzie.

    $cred = Get-Credential
    Enter-PSSession -VMName SRV-APP01 -Credential $cred
  4. Przy błędzie o zakończonej sesji zrestartuj usługę w gościu

    Błąd bywa skutkiem zawieszenia usługi po nieudanej próbie bez podanych poświadczeń. Zaloguj się do maszyny przez konsolę (VMConnect), uruchom PowerShell i zrestartuj usługę vmicvmsession.

    Restart-Service -Name vmicvmsession
  5. Wykonaj pojedyncze polecenie lub skrypt

    Invoke-Command otwiera i zamyka połączenie automatycznie. Nadaje się do jednorazowych zadań, na przykład odczytu konfiguracji sieci w maszynie bez sieci.

    Invoke-Command -VMName SRV-APP01 -Credential $cred -ScriptBlock { Get-NetIPConfiguration }
  6. Kopiuj pliki przez trwałą sesję

    Trwała sesja pozwala na Copy-Item w obie strony bez udziałów sieciowych. Użyj New-PSSession i na końcu usuń sesję.

    $s = New-PSSession -VMName SRV-APP01 -Credential $cred
    Copy-Item -ToSession $s -Path C:\Instalki\program.msi -Destination C:\Temp\
    Remove-PSSession $s

Jak zapobiegać

  • W każdej maszynie wirtualnej zachowuj konto lokalne z udokumentowanym hasłem na wypadek awarii sieci.
  • Dopilnuj, aby wbudowane konto Administrator było aktywne tylko tam, gdzie jest to zamierzone.
  • Hostom Hyper-V nadawaj uprawnienia administratorów Hyper-V tylko osobom, które ich potrzebują.
  • Aktualizuj komponenty integracji i system gościa, aby usługa vmicvmsession działała poprawnie.

W firmie

PowerShell Direct bywa ratunkiem, gdy maszyna wirtualna z serwerem aplikacji nie ma sieci, a jedyny dostęp prowadzi przez konsolę. Dobrze mieć przygotowane i przetestowane konto lokalne w każdej maszynie, bo bez żadnego użytkownika w gościu połączenie się nie uda. Jeśli utrzymujesz serwery na Hyper-V i potrzebujesz zdalnego wsparcia, możemy pomóc przez TeamViewer, a administracja serwerami w Warszawie jest u nas standardem.

Pytania i odpowiedzi

Czy PowerShell Direct działa przez sieć?

Nie. Maszyna musi działać lokalnie na hoście, z którego łączysz się, i musisz być zalogowany na tym hoście jako administrator Hyper-V. Nie zależy to od konfiguracji sieci ani zdalnego zarządzania w gościu.

Czy zadziała dla maszyn z Windows Server 2012 R2?

Nie. Wymagany jest system gościa Windows 10 lub Windows Server 2016 i nowszy. Dla starszych maszyn użyj Virtual Machine Connection albo połączenia sieciowego.

Czy PowerShell Direct współpracuje z JEA?

Tak, dokumentacja potwierdza obsługę Just Enough Administration. Wymagany jest PowerShell w wersji 5 lub nowszej.

Źródła

Opracowanie: zespół REDBAX – serwis komputerowy i obsługa informatyczna firm, Warszawa-Wawer. Stan na 02.11.2026. Kroki wykonujesz na własną odpowiedzialność – przed zmianami w systemie zrób kopię ważnych danych.

Serwer stoi, a firma czeka?

Administrujemy serwerami Windows w firmach z Warszawy i okolic. Zdiagnozujemy problem zdalnie, a gdy trzeba – przyjedziemy.