From a43311cd11063460deb4c549accf177801aa8d47 Mon Sep 17 00:00:00 2001
From: SamRisingTide <sam@risingtidegroup.net>
Date: Fri, 13 Sep 2024 14:52:10 -0600
Subject: [PATCH] Create Get-HuduUsers.ps1

Added the function to get user data.
---
 HuduAPI/Public/Get-HuduUsers.ps1 | 61 ++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 HuduAPI/Public/Get-HuduUsers.ps1

diff --git a/HuduAPI/Public/Get-HuduUsers.ps1 b/HuduAPI/Public/Get-HuduUsers.ps1
new file mode 100644
index 0000000..859f61f
--- /dev/null
+++ b/HuduAPI/Public/Get-HuduUsers.ps1
@@ -0,0 +1,61 @@
+function Get-HuduUsers {
+    <#
+    .SYNOPSIS
+    Get a list of Users
+
+    .DESCRIPTION
+    Call Hudu API to retrieve Users
+
+    .PARAMETER Id
+    Id of requested users
+
+    .PARAMETER Users
+    Name of the requested user
+
+    .PARAMETER CompanyId
+    Id of the requested company
+
+    .PARAMETER Name
+    Filter by name
+
+    .PARAMETER Archived
+    Show archived results
+
+    .PARAMETER Slug
+    Filter by slug of user
+
+    .EXAMPLE
+    Get-HuduUsers -Name 'Jim'
+#>
+
+[CmdletBinding()]
+    Param (
+        [ValidateRange(1, [int]::MaxValue)]
+        [Int]$Id = '',
+        [string]$Email = '',
+        [string]$First_name = '',
+        [string]$Last_name = '',
+	      [ValidateRange(1, [int]::MaxValue)]
+        [Int]$Portal_member_company_id = '',
+	      [String]$Securitylevel = '',
+        [string]$Slug = ''
+    )
+
+    if ($Id) {
+        Invoke-HuduRequest -Method get -Resource "/api/v1/users/$Id"
+    } else {
+        $Params = @{}
+
+        if ($First_name) { $Params.first_name = $First_name}
+        if ($Last_name) { $Params.last_name = $Last_name}
+        if ($Email) { $Params.email = $Email}
+
+        $HuduRequest = @{
+            Method   = 'GET'
+            Resource = '/api/v1/users'
+            Params   = $Params
+    }
+
+        Invoke-HuduRequestPaginated -HuduRequest $HuduRequest -Property Users
+    }
+}