Update function params and helpers

[arudell]

Description

Summary of changes:
This pull request includes several changes to the src/modules/SdnDiag.NetworkController.psm1 and src/modules/SdnDiag.Server.psm1 files to enhance functionality and improve error handling. The key changes include adding a new parameter to convert output to JSON, modifying parameter attributes, and improving error handling in various functions.

Enhancements to functionality:

• src/modules/SdnDiag.NetworkController.psm1: Added a new ConvertToJson parameter to the Get-SdnResource function to allow conversion of output to JSON format. [1] [2] [3]

Modifications to parameter attributes:

• src/modules/SdnDiag.NetworkController.psm1: Changed the NcUri and ResourceRef parameters to be mandatory in the Get-SdnResource function.

Improvements to error handling:

• src/modules/SdnDiag.Server.psm1: Updated multiple functions (Get-VfpPortGroup, Get-VfpPortLayer, Get-VfpPortRule, Get-VfpPortState, Get-VfpVMSwitchPort, Get-SdnOvsdbPhysicalPort) to improve error handling by throwing exceptions with detailed messages when errors occur. [1] [2] [3] [4] [5] [6] [7] [8]

Parameter name standardization:

• src/modules/SdnDiag.Server.psm1: Standardized the parameter name from PortId to PortName across multiple functions to maintain consistency. [1] [2] [3] [4] [5] [6]

Change in function behavior:

• src/modules/SdnDiag.NetworkController.psm1: Modified the Get-SdnResource function to handle multiple returned objects by updating the $result variable instead of returning it directly.

Change type

• Bug fix (non-breaking change)
• Code style update (formatting, local variables)
• New Feature (non-breaking change that adds new functionality without impacting existing)
• Breaking change (fix or feature that may cause functionality impact)
• Other

Checklist:

• My code follows the style and contribution guidelines of this project.
• I have tested and validated my code changes.

[sbgms]

    Get-SdnVMNetworkAdapterPortProfile -AllVMs

-All ?

---

Refers to: src/modules/SdnDiag.Server.psm1:2547 in 15ab29c. [](commit_id = 15ab29c, deletion_comment = False)

[sbgms]

[sbgms]