PSProxmox/release-notes.md

PSProxmox v2025.05.10.1000 Release Notes

New Features

Automatic Connection Handling

• Added automatic connection handling so cmdlets use the default connection without explicitly passing it
• Added a global DefaultProxmoxConnection variable that stores the most recent connection
• Created a base ProxmoxCmdlet class that all cmdlets can inherit from
• Updated all cmdlets to use the base class and make the Connection parameter optional

Test-ProxmoxConnection Cmdlet

• Added a new cmdlet to test if a connection is valid and active
• Added a -Detailed parameter to get comprehensive connection information
• The cmdlet can test either a specified connection or the default connection

Connection Object Improvements

• Added a custom ToString() method to the ProxmoxConnection class
• The connection now displays as "Proxmox Connection: username@realm on server:port (Authenticated)"
• This makes it easier to see connection details in the console

Documentation Updates

• Updated all documentation and examples to use the new automatic connection handling
• Added documentation for the new Test-ProxmoxConnection cmdlet
• Updated the README.md examples to use the default connection

Usage Examples

Old way (explicit connection):

$connection = Connect-ProxmoxServer -Server "proxmox.example.com" -Credential (Get-Credential)
$vms = Get-ProxmoxVM -Connection $connection
Disconnect-ProxmoxServer -Connection $connection

New way (automatic connection):

Connect-ProxmoxServer -Server "proxmox.example.com" -Credential (Get-Credential)
$vms = Get-ProxmoxVM
$connection = Test-ProxmoxConnection -Detailed
Disconnect-ProxmoxServer -Connection $connection

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