Merge pull request #67 from replicaJunction/feature-fields

Feature: specify fields to return

Author: Rick-2CA

ServiceNow/Public/Get-ServiceNowChangeRequest.ps1

@@ -15,6 +15,10 @@ function Get-ServiceNowChangeRequest {
         [Parameter(Mandatory = $false)]
         [int]$Limit = 10,
 
+        # Fields to return
+        [parameter(mandatory = $false)]
+        [string[]]$Fields,
+
         # Hashtable containing machine field names and values returned must match exactly (will be combined with AND)
         [Parameter(Mandatory = $false)]
         [hashtable]$MatchExact = @{},
@@ -56,7 +60,8 @@ function Get-ServiceNowChangeRequest {
     $getServiceNowTableSplat = @{
         Table           = 'change_request'
         Query           = $Query
-        Limit           = $Limit
+        Limit           = $
+        Fields          = $Fields
         DisplayValues   = $DisplayValues
     }
 

ServiceNow/Public/Get-ServiceNowConfigurationItem.ps1

@@ -15,6 +15,10 @@ function Get-ServiceNowConfigurationItem {
         [Parameter(Mandatory = $false)]
         [int]$Limit = 10,
 
+        # Fields to return
+        [parameter(mandatory = $false)]
+        [string[]]$Fields,
+
         # Hashtable containing machine field names and values returned must match exactly (will be combined with AND)
         [Parameter(Mandatory = $false)]
         [hashtable]$MatchExact = @{},
@@ -57,6 +61,7 @@ function Get-ServiceNowConfigurationItem {
         Table           = 'cmdb_ci'
         Query           = $Query
         Limit           = $Limit
+        Fields          = $Fields
         DisplayValues   = $DisplayValues
     }
 

ServiceNow/Public/Get-ServiceNowIncident.ps1

@@ -15,6 +15,10 @@ function Get-ServiceNowIncident{
         [Parameter(Mandatory = $false)]
         [int]$Limit = 10,
 
+        # Fields to return
+        [parameter(mandatory = $false)]
+        [string[]]$Fields,
+
         # Hashtable containing machine field names and values returned must match exactly (will be combined with AND)
         [Parameter(Mandatory = $false)]
         [hashtable]$MatchExact = @{},
@@ -57,6 +61,7 @@ function Get-ServiceNowIncident{
         Table = 'incident'
         Query = $Query
         Limit = $Limit
+        Fields        = $Fields
         DisplayValues = $DisplayValues
     }
 

ServiceNow/Public/Get-ServiceNowRequest.ps1

@@ -15,6 +15,10 @@ function Get-ServiceNowRequest {
         [Parameter(Mandatory = $false)]
         [int]$Limit = 10,
 
+        # Fields to return
+        [parameter(mandatory = $false)]
+        [string[]]$Fields,
+
         # Hashtable containing machine field names and values returned must match exactly (will be combined with AND)
         [Parameter(Mandatory = $false)]
         [hashtable]$MatchExact = @{},
@@ -57,6 +61,7 @@ function Get-ServiceNowRequest {
         Table         = 'sc_request'
         Query         = $Query
         Limit         = $Limit
+        Fields        = $Fields
         DisplayValues = $DisplayValues
     }
 

ServiceNow/Public/Get-ServiceNowRequestItem.ps1

@@ -31,6 +31,10 @@ function Get-ServiceNowRequestItem {
         [parameter(Mandatory = $false)]
         [int]$Limit = 10,
 
+        # Fields to return
+        [parameter(mandatory = $false)]
+        [string[]]$Fields,
+
         # Hashtable containing machine field names and values returned must match exactly (will be combined with AND)
         [parameter(Mandatory = $false)]
         [hashtable]$MatchExact = @{},
@@ -72,6 +76,7 @@ function Get-ServiceNowRequestItem {
         Table         = 'sc_req_item'
         Query         = $Query
         Limit         = $Limit
+        Fields        = $Fields
         DisplayValues = $DisplayValues
     }
 

ServiceNow/Public/Get-ServiceNowTable.ps1

@@ -29,6 +29,10 @@ function Get-ServiceNowTable {
         [Parameter(Mandatory = $false)]
         [int]$Limit = 10,
 
+        # Fields to return
+        [parameter(mandatory = $false)]
+        [string[]]$Fields,
+
         # Whether or not to show human readable display values instead of machine values
         [Parameter(Mandatory = $false)]
         [ValidateSet('true', 'false', 'all')]
@@ -73,6 +77,10 @@ function Get-ServiceNowTable {
         $Body.sysparm_query = $Query
     }
 
+    if ($Fields) {
+        $Body.sysparm_fields = $Fields -join ','
+    }
+
     # Perform table query and capture results
     $Uri = $ServiceNowURL + "/table/$Table"
     $Result = (Invoke-RestMethod -Uri $Uri -Credential $ServiceNowCredential -Body $Body -ContentType "application/json").Result

ServiceNow/Public/Get-ServiceNowTableEntry.ps1

@@ -38,6 +38,10 @@ function Get-ServiceNowTableEntry {
         [parameter(Mandatory = $false)]
         [int]$Limit = 10,
 
+        # Fields to return
+        [parameter(mandatory = $false)]
+        [string[]]$Fields,
+
         # Hashtable containing machine field names and values returned must match exactly (will be combined with AND)
         [parameter(Mandatory = $false)]
         [hashtable]$MatchExact = @{},
@@ -82,6 +86,7 @@ function Get-ServiceNowTableEntry {
             Table         = $Table
             Query         = $Query
             Limit         = $Limit
+            Fields        = $Fields
             DisplayValues = $DisplayValues
             ErrorAction   = 'Stop'
         }

ServiceNow/Public/Get-ServiceNowUser.ps1

@@ -15,6 +15,10 @@ function Get-ServiceNowUser{
         [Parameter(Mandatory = $false)]
         [int]$Limit = 10,
 
+        # Fields to return
+        [parameter(mandatory = $false)]
+        [string[]]$Fields,
+
         # Hashtable containing machine field names and values returned must match exactly (will be combined with AND)
         [Parameter(Mandatory = $false)]
         [hashtable]$MatchExact = @{},
@@ -57,6 +61,7 @@ function Get-ServiceNowUser{
         Table = 'sys_user'
         Query = $Query
         Limit = $Limit
+        Fields = $Fields
         DisplayValues = $DisplayValues
     }
 

ServiceNow/Public/Get-ServiceNowUserGroup.ps1

@@ -15,6 +15,10 @@ function Get-ServiceNowUserGroup{
         [Parameter(Mandatory = $false)]
         [int]$Limit = 10,
 
+        # Fields to return
+        [parameter(mandatory = $false)]
+        [string[]]$Fields,
+
         # Hashtable containing machine field names and values returned must match exactly (will be combined with AND)
         [Parameter(Mandatory = $false)]
         [hashtable]$MatchExact = @{},
@@ -57,6 +61,7 @@ function Get-ServiceNowUserGroup{
         Table = 'sys_user_group'
         Query = $Query
         Limit = $Limit
+        Fields = $Fields
         DisplayValues = $DisplayValues
     }