44 lines
1.6 KiB
Markdown
44 lines
1.6 KiB
Markdown
# 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
|
|
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**. |