PSProxmox/release-notes.md

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

# 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

# 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