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
- 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).
- Konto na hoście nie należy do administratorów Hyper-V, więc nazwa maszyny nie jest rozpoznawana.
- 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.
- Host działa pod starszym systemem niż Windows 10 lub Windows Server 2016, albo używasz zbyt starej wersji PowerShella.
- Parametr RunAsAdministrator działa tylko dla kontenerów Windows; maszyna wirtualna wymaga jawnych poświadczeń.
Rozwiązanie krok po kroku
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.PSVersionUpewnij 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, UptimeOtwó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 $credPrzy 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 vmicvmsessionWykonaj 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 }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.