feat: add firewall, backup, and SDN IPAM/DNS/controller cmdlets

Add 35 new cmdlets bringing the total to 118:
- Firewall (21): rules, groups, aliases, IP sets, options at
  cluster/node/VM/container levels
- Backup (5): ad-hoc vzdump and scheduled backup job CRUD
- SDN IPAM/DNS/Controller (9): plugin management for SDN subsystem

Also includes:
- Fix: Remove-PveRole now has ConfirmImpact.High
- Fix: URL-encode snapshot names in API paths
- Refactor: extract auth header strings to constants in PveHttpClient
- Add PSGallery version badge to README
- Full test coverage: 11 JSON fixtures, xUnit model tests, Pester
  unit tests, and integration tests for firewall/backup/OVA import
- Updated manifest, format file, CHANGELOG, README, API coverage docs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Clint Branham
2026-03-21 07:51:49 -05:00
parent 8d5f33f592
commit a72642d203
81 changed files with 7636 additions and 564 deletions
@@ -142,5 +142,125 @@ namespace PSProxmoxVE.Core.Tests.Models
// Comments not present in fixture entries
Assert.Null(vnets[0].Comments);
}
// ── PveSdnIpam ─────────────────────────────────────────────────
[Fact]
public void PveSdnIpam_Deserialize_Pve9_ReturnsCorrectCount()
{
var json = TestHelper.LoadFixture("pve9_sdn_ipams.json");
var data = JObject.Parse(json)["data"];
Assert.NotNull(data);
var ipams = data.ToObject<PveSdnIpam[]>();
Assert.NotNull(ipams);
Assert.Equal(2, ipams.Length);
}
[Fact]
public void PveSdnIpam_Deserialize_Pve9_FirstIpam_IsPveType()
{
var json = TestHelper.LoadFixture("pve9_sdn_ipams.json");
var data = JObject.Parse(json)["data"];
Assert.NotNull(data);
var ipams = data.ToObject<PveSdnIpam[]>();
Assert.NotNull(ipams);
Assert.Equal("pve", ipams[0].Ipam);
Assert.Equal("pve", ipams[0].Type);
}
[Fact]
public void PveSdnIpam_Deserialize_Pve9_FirstIpam_OptionalFieldsAreNull()
{
var json = TestHelper.LoadFixture("pve9_sdn_ipams.json");
var data = JObject.Parse(json)["data"];
Assert.NotNull(data);
var ipams = data.ToObject<PveSdnIpam[]>();
Assert.NotNull(ipams);
Assert.Null(ipams[0].Url);
Assert.Null(ipams[0].Token);
Assert.Null(ipams[0].Section);
}
[Fact]
public void PveSdnIpam_Deserialize_Pve9_SecondIpam_HasNetboxProperties()
{
var json = TestHelper.LoadFixture("pve9_sdn_ipams.json");
var data = JObject.Parse(json)["data"];
Assert.NotNull(data);
var ipams = data.ToObject<PveSdnIpam[]>();
Assert.NotNull(ipams);
Assert.Equal("netbox1", ipams[1].Ipam);
Assert.Equal("netbox", ipams[1].Type);
Assert.Equal("https://netbox.example.com", ipams[1].Url);
Assert.Equal("abc123", ipams[1].Token);
Assert.Equal(1, ipams[1].Section);
}
// ── PveSdnDns ──────────────────────────────────────────────────
[Fact]
public void PveSdnDns_Deserialize_Pve9_ReturnsCorrectCount()
{
var json = TestHelper.LoadFixture("pve9_sdn_dns.json");
var data = JObject.Parse(json)["data"];
Assert.NotNull(data);
var dnsEntries = data.ToObject<PveSdnDns[]>();
Assert.NotNull(dnsEntries);
Assert.Single(dnsEntries);
}
[Fact]
public void PveSdnDns_Deserialize_Pve9_FirstEntry_HasCorrectProperties()
{
var json = TestHelper.LoadFixture("pve9_sdn_dns.json");
var data = JObject.Parse(json)["data"];
Assert.NotNull(data);
var dnsEntries = data.ToObject<PveSdnDns[]>();
Assert.NotNull(dnsEntries);
Assert.Equal("powerdns1", dnsEntries[0].Dns);
Assert.Equal("powerdns", dnsEntries[0].Type);
Assert.Equal("http://dns.example.com:8081", dnsEntries[0].Url);
Assert.Equal("secret123", dnsEntries[0].Key);
Assert.Equal(3600, dnsEntries[0].Ttl);
}
[Fact]
public void PveSdnDns_Deserialize_Pve9_FirstEntry_OptionalFieldsAreNull()
{
var json = TestHelper.LoadFixture("pve9_sdn_dns.json");
var data = JObject.Parse(json)["data"];
Assert.NotNull(data);
var dnsEntries = data.ToObject<PveSdnDns[]>();
Assert.NotNull(dnsEntries);
Assert.Null(dnsEntries[0].ReverseMaskV6);
}
// ── PveSdnController ───────────────────────────────────────────
[Fact]
public void PveSdnController_Deserialize_Pve9_ReturnsCorrectCount()
{
var json = TestHelper.LoadFixture("pve9_sdn_controllers.json");
var data = JObject.Parse(json)["data"];
Assert.NotNull(data);
var controllers = data.ToObject<PveSdnController[]>();
Assert.NotNull(controllers);
Assert.Single(controllers);
}
[Fact]
public void PveSdnController_Deserialize_Pve9_FirstController_HasCorrectProperties()
{
var json = TestHelper.LoadFixture("pve9_sdn_controllers.json");
var data = JObject.Parse(json)["data"];
Assert.NotNull(data);
var controllers = data.ToObject<PveSdnController[]>();
Assert.NotNull(controllers);
Assert.Equal("evpn1", controllers[0].Controller);
Assert.Equal("evpn", controllers[0].Type);
Assert.Equal(65000, controllers[0].Asn);
Assert.Equal("10.0.0.1,10.0.0.2", controllers[0].Peers);
Assert.Equal("pve1", controllers[0].Node);
}
}
}