Lost Update-ServiceNowTableEntry in merge. Adding it back.

Author: Rick-2CA

ServiceNow/Public/Update-ServiceNowTableEntry.ps1

@@ -0,0 +1,71 @@
+function Update-ServiceNowTableEntry{
+[CmdletBinding(ConfirmImpact='High')]
+    Param(
+        # sys_id of the entry we're deleting
+        [parameter(mandatory=$true)]
+        [parameter(ParameterSetName='SpecifyConnectionFields')]
+        [parameter(ParameterSetName='UseConnectionObject')]
+        [parameter(ParameterSetName='SetGlobalAuth')]
+        [string]$SysId,
+        
+        # Table containing the entry we're deleting
+        [parameter(mandatory=$true)]
+        [parameter(ParameterSetName='SpecifyConnectionFields')]
+        [parameter(ParameterSetName='UseConnectionObject')]
+        [parameter(ParameterSetName='SetGlobalAuth')]
+        [string]$Table,
+        
+        # Credential used to authenticate to ServiceNow  
+        [Parameter(ParameterSetName='SpecifyConnectionFields', Mandatory=$True)]
+        [ValidateNotNullOrEmpty()]
+        [PSCredential]$ServiceNowCredential, 
+
+        # The URL for the ServiceNow instance being used  
+        [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,
+
+        # Hashtable of values to use as the record's properties
+        [parameter(mandatory=$false)]
+        [parameter(ParameterSetName='SpecifyConnectionFields')]
+        [parameter(ParameterSetName='UseConnectionObject')]
+        [parameter(ParameterSetName='SetGlobalAuth')]
+        [hashtable]$Values
+    )
+
+	#Get credential and ServiceNow REST URL
+    if ($Connection -ne $null)
+    {
+        $SecurePassword = ConvertTo-SecureString $Connection.Password -AsPlainText -Force
+        $ServiceNowCredential = New-Object System.Management.Automation.PSCredential ($Connection.Username, $SecurePassword)
+        $ServiceNowURL = 'https://' + $Connection.ServiceNowUri + '/api/now/v1'
+        
+    } 
+    elseif ($ServiceNowCredential -ne $null -and $ServiceNowURL -ne $null)
+    {
+        $ServiceNowURL = 'https://' + $ServiceNowURL + '/api/now/v1'
+    }
+    elseif((Test-ServiceNowAuthIsSet))
+    {
+        $ServiceNowCredential = $Global:ServiceNowCredentials
+        $ServiceNowURL = $global:ServiceNowRESTURL
+    } 
+    else
+    {
+        throw "Exception:  You must do one of the following to authenticate: `n 1. Call the Set-ServiceNowAuth cmdlet `n 2. Pass in an Azure Automation connection object `n 3. Pass in an endpoint and credential"
+    }
+  
+    $Body = $Values | ConvertTo-Json
+    
+    #Convert to UTF8 array to support special chars such as the danish "�","�","�"
+    $utf8Bytes = [System.Text.Encoding]::UTf8.GetBytes($Body)
+
+    # Fire and return
+    $Uri = $ServiceNowURL + "/table/$Table/$SysID"
+    return (Invoke-RestMethod -Uri $uri -Method Patch -Credential $ServiceNowCredential -Body $utf8Bytes -ContentType "application/json").result
+}