Initial commit of PSProxmox module

docs/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to the PSProxmox module will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2023.04.28.1324] - 2023-04-28
+
+### Added
+- Initial project structure
+- Project scaffolding (directories, project files)
+- Module manifest (PSProxmox.psd1)
+- README.md and CHANGELOG.md
+
+### Changed
+- N/A
+
+### Removed
+- N/A

docs/README.md

@@ -0,0 +1,63 @@
+# 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
+
+```powershell
+# Install from PSGallery (when published)
+Install-Module -Name PSProxmox
+
+# Import the module
+Import-Module PSProxmox
+```
+
+## Quick Start
+
+```powershell
+# 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:
+
+```powershell
+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.