Repository/HyperV-Invoke-CommandFromHost/readme.md

Hyper-V Guest Script Runner (GUI)

A PowerShell WinForms GUI to run .ps1 scripts inside selected Hyper-V VMs using PowerShell Direct.
It fetches scripts from a remote repository and executes them in guest OSes with provided credentials.

✨ Features

• List all running Hyper-V VMs
• Fetch .ps1 scripts dynamically from a remote URL
  (default: https://nas.wuibaille.fr/WS/postype/)
• Prompt for guest credentials
• Run the selected script in one or multiple VMs
• Option to run gpupdate /force after script execution
• Logs output for each VM in a GUI textbox with timestamps

📌 Requirements

• Windows 10/11 with Hyper-V role enabled
• PowerShell 5.1 or 7+
• PowerShell Direct enabled (run on the Hyper-V host)
• Access to the remote URL hosting .ps1 scripts
• Run script as Administrator

🚀 Usage

1. Launch the script on the Hyper-V host:

   powershell -ExecutionPolicy Bypass -File .\HyperV-GuestScriptRunner.ps1
   

• Enter guest username and password.
• Refresh and select scripts from the remote repository.
• Select one or multiple running VMs.
• (Optional) Check Run gpupdate /force.
• Click Run on Selected VMs.

The log panel will display progress and results per VM.

⚠️ Notes

• Requires network access to the script repository.
• Guest VMs must allow login with the specified credentials.
• If a VM is not accessible via PowerShell Direct, execution will fail for that VM.
• Script errors and exit codes are logged in the GUI.