Refactor IPAM model classes to use records for Address, Subnetwork, Vlan, Vrf, Section, Tag, Domain, Nameserver, and Session; enhance documentation and implement value equality for records.

classlib/Cmdlets/GetSectionCmdlet.cs

@@ -1,19 +1,23 @@
 namespace PS.IPAM.Cmdlets;
+
 using System;
 using System.Collections.Generic;
 using System.Management.Automation;
-using PS.IPAM;
 using PS.IPAM.Helpers;
 
+/// <summary>
+/// Retrieves section information from phpIPAM.
+/// </summary>
 [Cmdlet(VerbsCommon.Get, "Section", DefaultParameterSetName = "NoParams")]
 [OutputType(typeof(Section))]
-public class GetSectionCmdlet : PSCmdlet
+public class GetSectionCmdlet : BaseCmdlet
 {
     [Parameter(
         Mandatory = false,
         ValueFromPipeline = true,
         Position = 0,
-        ParameterSetName = "ByID")]
+        ParameterSetName = "ByID",
+        HelpMessage = "The section ID.")]
     [ValidateNotNullOrEmpty]
     public int? Id { get; set; }
 
@@ -21,7 +25,8 @@ public class GetSectionCmdlet : PSCmdlet
         Mandatory = true,
         ValueFromPipeline = true,
         Position = 0,
-        ParameterSetName = "ByName")]
+        ParameterSetName = "ByName",
+        HelpMessage = "The section name.")]
     [ValidateNotNullOrEmpty]
     public string? Name { get; set; }
 
@@ -30,6 +35,7 @@ public class GetSectionCmdlet : PSCmdlet
         try
         {
             var identifiers = new List<string>();
+
             if (ParameterSetName == "ByID" && Id.HasValue)
             {
                 identifiers.Add(Id.Value.ToString());
@@ -39,23 +45,12 @@ public class GetSectionCmdlet : PSCmdlet
                 identifiers.Add(Name!);
             }
 
-            var result = RequestHelper.InvokeRequest("GET", controllers.sections, types.Section, null, null, identifiers.Count > 0 ? identifiers.ToArray() : null)
-                .GetAwaiter().GetResult();
+            var result = RequestHelper.InvokeRequest(
+                "GET", ApiController.Sections, ModelType.Section, null, null,
+                identifiers.Count > 0 ? identifiers.ToArray() : null
+            ).GetAwaiter().GetResult();
 
-            if (result != null)
-            {
-                if (result is System.Collections.IEnumerable enumerable && !(result is string))
-                {
-                    foreach (var item in enumerable)
-                    {
-                        WriteObject(item);
-                    }
-                }
-                else
-                {
-                    WriteObject(result);
-                }
-            }
+            WriteResult(result);
         }
         catch (Exception ex)
         {