PSProxmox

PSProxmox is a C#-based PowerShell module for managing Proxmox VE clusters. It provides a comprehensive set of cmdlets for interacting with Proxmox VE API, featuring structured return objects, mass deployment tools, automatic IP management, and more.

Features

Session Management: Authenticate and persist sessions with Proxmox VE clusters
Core CRUD Operations: Manage VMs, Storage, Network, Users, Roles, SDN, and Clusters
Templates: Create and use VM deployment templates
Mass Creation: Bulk create VMs with prefix/counter
IP Management: CIDR parsing, subnetting, FIFO IP queue assignment
Structured Objects: All outputs are typed C# classes (PowerShell-native)
Pipeline Support: Cmdlets support pipeline input where appropriate

Requirements

PowerShell 5.1 or PowerShell 7+
.NET Framework 4.7.2 or .NET Core 2.0+

Installation

# Install from PSGallery (when published)
Install-Module -Name PSProxmox

# Import the module
Import-Module PSProxmox

Quick Start

# Connect to a Proxmox server
$connection = Connect-ProxmoxServer -Server "proxmox.example.com" -Credential (Get-Credential)

# Get all VMs
$vms = Get-ProxmoxVM -Connection $connection

# Create a new VM
$newVM = New-ProxmoxVM -Connection $connection -Name "test-vm" -Memory 2048 -Cores 2 -DiskSize 32

# Start a VM
Start-ProxmoxVM -Connection $connection -VMID $newVM.VMID

# Disconnect from the server
Disconnect-ProxmoxServer -Connection $connection

Documentation

For detailed documentation on each cmdlet, use the built-in PowerShell help:

Get-Help Connect-ProxmoxServer -Full

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.