Auto-commit: 2025-10-31 08:58:35

HyperV-Invoke-CommandFromHost/readme.md

@@ -0,0 +1,44 @@
+# Hyper-V Guest Script Runner (GUI)
+
+![Hyper-V Script Runner](readme.png)
+
+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
+   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**.