Public/Update-ServiceNowRequestedItem.ps1

function Update-ServiceNowRequestItem {
    <#
    .SYNOPSIS
    Update an existing request item (RITM)
 
    .DESCRIPTION
    Update an existing request item (RITM)
 
    .EXAMPLE
    Update-ServiceNowRequestItem -SysId $SysId -Values @{property='value'}
 
    Updates a ticket number with a value providing no return output.
 
    .EXAMPLE
    Update-ServiceNowRequestItem -SysId $SysId -Values @{property='value'} -PassThru
 
    Updates a ticket number with a value providing return output.
 
    .NOTES
 
    #>


    [OutputType([void], [System.Management.Automation.PSCustomObject])]
    [CmdletBinding(SupportsShouldProcess)]

    Param (
        # sys_id of the ticket to update
        [parameter(Mandatory, ValueFromPipelineByPropertyName)]
        [Alias('sys_id')]
        [string] $SysId,

        # Hashtable of values to use as the record's properties
        [Parameter(Mandatory)]
        [hashtable] $Values,

        [Parameter()]
        [Hashtable] $Connection,

        [Parameter()]
        [hashtable] $ServiceNowSession = $script:ServiceNowSession,

        [Parameter()]
        [switch] $PassThru
    )

    begin {}

    process {

        $params = @{
            Method            = 'Patch'
            Table             = 'sc_req_item'
            SysId             = $SysId
            Values            = $Values
            Connection        = $Connection
            ServiceNowSession = $ServiceNowSession
        }

        If ($PSCmdlet.ShouldProcess("Requested Item $SysID", 'Update values')) {
            $response = Invoke-ServiceNowRestMethod @params
            if ( $PassThru.IsPresent ) {
                $response
            }
        }

    }

    end {}
}