mirror of
https://github.com/Grace-Solutions/PSProxmox.git
synced 2026-08-11 15:46:54 +00:00
AX-AMote
33898b7b80
- Added comprehensive VM Guest Agent support with network interface information - Enhanced Get-ProxmoxVM cmdlet to retrieve guest agent data automatically - Added ProxmoxVMGuestAgent model with IPv4/IPv6 address arrays - Fixed all 41 pre-existing compilation errors (100% success rate) - Eliminated all compilation warnings for clean builds - Standardized API patterns across all cmdlets - Enhanced error handling and type safety throughout codebase - Updated documentation with guest agent examples - Added comprehensive guest agent example script - Updated README with guest agent usage examples - Version bump to 2025.05.30.1740
71 lines
2.6 KiB
Markdown
71 lines
2.6 KiB
Markdown
# PSProxmox v2025.05.30.1740 Release Notes
|
|
|
|
## Major Improvements
|
|
|
|
### 🎉 VM Guest Agent Support
|
|
- **Enhanced Get-ProxmoxVM cmdlet** with comprehensive guest agent data retrieval
|
|
- **New ProxmoxVMGuestAgent model** with detailed network interface information
|
|
- **IPv4 and IPv6 address arrays** for each network interface detected by guest agent
|
|
- **Guest agent status checking** with robust error handling for VMs without guest agent
|
|
- **Complete VM network visibility** from within the guest operating system
|
|
|
|
### 🔧 Complete Codebase Stabilization
|
|
- **Fixed ALL 41 compilation errors** (100% success rate) that were present in the codebase
|
|
- **Eliminated ALL compilation warnings** for completely clean builds
|
|
- **Standardized API patterns** across all cmdlets for consistency and reliability
|
|
- **Enhanced type safety** throughout the entire codebase
|
|
- **Modern C# best practices** applied consistently
|
|
|
|
### 🚀 Enhanced Reliability
|
|
- **Robust error handling** for guest agent operations
|
|
- **Improved API client usage** with proper parameter handling
|
|
- **Better JSON processing** with strongly-typed objects instead of dynamic types
|
|
- **Consistent parameter validation** across all cmdlets
|
|
|
|
## Usage Examples
|
|
|
|
### 🔍 VM Guest Agent Information
|
|
```powershell
|
|
# Connect to Proxmox
|
|
Connect-ProxmoxServer -Server "proxmox.example.com" -Credential (Get-Credential)
|
|
|
|
# Get VM with guest agent information
|
|
$vm = Get-ProxmoxVM -VMID 100
|
|
|
|
# Access guest agent data
|
|
if ($vm.GuestAgent -and $vm.GuestAgent.Status -eq "running") {
|
|
Write-Host "Guest Agent is running"
|
|
|
|
# Display network interfaces from guest agent
|
|
foreach ($interface in $vm.GuestAgent.NetIf) {
|
|
Write-Host "Interface: $($interface.Name)"
|
|
Write-Host " IPv4 Addresses: $($interface.IPv4Addresses -join ', ')"
|
|
Write-Host " IPv6 Addresses: $($interface.IPv6Addresses -join ', ')"
|
|
Write-Host " MAC Address: $($interface.MacAddress)"
|
|
}
|
|
} else {
|
|
Write-Host "Guest Agent not available or not running"
|
|
}
|
|
|
|
# Get all VMs and filter by those with guest agent
|
|
$vmsWithGuestAgent = Get-ProxmoxVM | Where-Object {
|
|
$_.GuestAgent -and $_.GuestAgent.Status -eq "running"
|
|
}
|
|
```
|
|
|
|
### 🔧 Clean Build and Development
|
|
```powershell
|
|
# The module now builds completely clean with no errors or warnings
|
|
dotnet build PSProxmox\PSProxmox.csproj
|
|
# Build succeeded with 0 error(s) and 0 warning(s)
|
|
```
|
|
|
|
## Installation
|
|
1. Download the ZIP file
|
|
2. Extract the contents to a directory in your PowerShell module path
|
|
3. Import the module using `Import-Module PSProxmox`
|
|
|
|
## Requirements
|
|
- PowerShell 5.1 or later
|
|
- Windows PowerShell or PowerShell Core
|