Skip to content

PowerNetbox v4.5.8.0

Released 2026-04-17 - View on GitHub

Netbox 4.5.8 compatibility

No new ValidateSet values required — 4.5.8 is a pure maintenance release (10 bug fixes + 2 UI enhancements, zero API schema changes). NetBox bug #21542 (interface speed 32-bit → 64-bit for LAG >2.1 Tbps) is server-side only; PowerNetbox already sends uint64 for the Speed parameter added in #398. CI matrix updated to v4.5.8-4.0.2 across 4 workflows; zulu-how test instance upgraded v4.5.7 → v4.5.8.

Breaking: Brief/Fields/Omit mutual exclusion on Get functions (#397, PR-1)

Scripts that combined any two of -Brief, -Fields, or -Omit previously got the result of one and silently ignored the others. This release introduces an internal helper that throws ParameterBindingException with a message naming the conflicting parameters. Applied to 3 pilot Get functions (Get-NBDCIMDevice, Get-NBIPAMAddress, Get-NBVPNTunnel).

Migration: pick one filter strategy per call — -Brief (minimal), -Fields id,name,status (specific), or -Omit comments,description (default minus fields).

PR-1 of a two-phase rollout; PR-2 (separate, upcoming) will apply the pattern to the remaining 121 Get functions with an AST-based CI auditor.

New: 22 interface parameters on New-NBDCIMInterface, 21 on Set-NBDCIMInterface (#394, PR #398)

Proposed and initial implementation by @mkarel (original PR #396, closed and reimplemented with credit per the project's external-PR flow).

Full NetBox Interface API coverage: label, parent, bridge, speed, duplex, mark_connected, wwn, vdcs, poe_mode, poe_type, vlan_group, qinq_svlan, vrf, rf_role, rf_channel, rf_channel_frequency, rf_channel_width, tx_power, primary_mac_address, owner, changelog_message, tags (New only — already on Set).

  • q-in-q Mode value added with full backward-compat: existing 'Access'/'Tagged'/'Tagged All'/'100'/'200'/'300' translations preserved; new 'Q-in-Q' title-case and legacy '400' numeric code translate to canonical 'q-in-q'.
  • Nine numeric parameters on Set-* use [Nullable[T]] for null-clearing via PATCH: Parent, Bridge, Speed, QinQ_SVLAN, Primary_MAC_Address, Owner, RF_Channel_Frequency, RF_Channel_Width, TX_Power.

Bundled: Get-NBDCIMInterface -Type drift fix (#392 item 2)

Synchronized with New-/Set-NBDCIMInterface — 104 previously-missing interface types now filterable (all 100/200/400/800GBASE variants, 1.6TbE, InfiniBand NDR/XDR, IEEE802.11be, etc.). Drift introduced by PR #369 (v4.5.4.0) and PR #381 (v4.5.6.0) which expanded the ValidateSet on New/Set but left Get behind. Strictly expansive — every previously-accepted value still validates.

Stats

  • 69 new unit + integration tests
  • Full unit regression: 2261 passed / 0 failed
  • Integration test matrix green on Netbox 4.3.7, 4.4.10, 4.5.8
  • Parity tool drift count: 18 → 17 findings

Published to the PowerShell Gallery automatically by the release workflow.