Create Update-ServiceNowRequestItem.ps1

Author: joseluislucio

ServiceNow/Public/Update-ServiceNowRequestItem.ps1

@@ -0,0 +1,49 @@
+function Update-ServiceNowRequestItem {
+    Param
+    (   # sys_id of the caller of the Request Item (use Get-ServiceNowUser to retrieve this)
+        [parameter(mandatory=$true)]        
+        [parameter(ParameterSetName='SpecifyConnectionFields', mandatory=$true)]
+        [parameter(ParameterSetName='UseConnectionObject', mandatory=$true)]
+        [parameter(ParameterSetName='SetGlobalAuth', mandatory=$true)]       
+        [string]$SysId,
+
+         # Hashtable of values to use as the record's properties        
+        [parameter(mandatory=$true)]        
+        [hashtable]$Values,
+
+         # Credential used to authenticate to ServiceNow  
+        [Parameter(ParameterSetName='SpecifyConnectionFields', Mandatory=$True)]
+        [ValidateNotNullOrEmpty()]
+        [PSCredential]$ServiceNowCredential, 
+
+        # The URL for the ServiceNow instance being used (eg: instancename.service-now.com)
+        [Parameter(ParameterSetName='SpecifyConnectionFields', Mandatory=$True)]
+        [ValidateNotNullOrEmpty()]
+        [string]$ServiceNowURL, 
+
+        #Azure Automation Connection object containing username, password, and URL for the ServiceNow instance
+        [Parameter(ParameterSetName='UseConnectionObject', Mandatory=$True)] 
+        [ValidateNotNullOrEmpty()]
+        [Hashtable]$Connection
+    )                      
+
+    $updateServiceNowTableEntrySplat = @{
+        SysId = $SysId
+        Table = 'sc_req_item'
+        Values = $Values
+    }
+    
+    # Update the splat if the parameters have values
+    if ($null -ne $PSBoundParameters.Connection)
+    {     
+        $updateServiceNowTableEntrySplat.Add('Connection',$Connection)
+    }
+    elseif ($null -ne $PSBoundParameters.ServiceNowCredential -and $null -ne $PSBoundParameters.ServiceNowURL) 
+    {
+         $updateServiceNowTableEntrySplat.Add('ServiceNowCredential',$ServiceNowCredential)
+         $updateServiceNowTableEntrySplat.Add('ServiceNowURL',$ServiceNowURL)
+    }
+       
+    Update-ServiceNowTableEntry @updateServiceNowTableEntrySplat
+}
+