Public/Get-ServiceNowRequestedItem.ps1
|
function Get-ServiceNowRequestedItem { <# .SYNOPSIS Query for Requested Item (RITM) tickets. .DESCRIPTION Query for Requested Item (RITM) tickets from the sc_req_item table. .EXAMPLE Get-ServiceNowRequestedItem -MatchExact @{number='RITM0000001'} Return the details for RITM0000001 .OUTPUTS System.Management.Automation.PSCustomObject #> [OutputType([System.Management.Automation.PSCustomObject])] [CmdletBinding(DefaultParameterSetName = 'Session', SupportsPaging)] param( # Machine name of the field to order by [parameter()] [string]$OrderBy = 'opened_at', # Direction of ordering (Desc/Asc) [parameter()] [ValidateSet('Desc', 'Asc')] [string]$OrderDirection = 'Desc', # Fields to return [Parameter()] [Alias('Fields')] [string[]]$Properties, # Hashtable containing machine field names and values returned must match exactly (will be combined with AND) [parameter()] [hashtable]$MatchExact = @{}, # Hashtable containing machine field names and values returned rows must contain (will be combined with AND) [parameter()] [hashtable]$MatchContains = @{}, # Whether or not to show human readable display values instead of machine values [parameter()] [ValidateSet('true', 'false', 'all')] [string]$DisplayValues = 'true', [Parameter(ParameterSetName = 'SpecifyConnectionFields', Mandatory)] [ValidateNotNullOrEmpty()] [Alias('ServiceNowCredential')] [PSCredential]$Credential, [Parameter(ParameterSetName = 'SpecifyConnectionFields', Mandatory)] [ValidateNotNullOrEmpty()] [string]$ServiceNowURL, [Parameter(ParameterSetName = 'UseConnectionObject', Mandatory)] [ValidateNotNullOrEmpty()] [hashtable]$Connection, [Parameter(ParameterSetName = 'Session')] [ValidateNotNullOrEmpty()] [hashtable] $ServiceNowSession = $script:ServiceNowSession ) $result = Get-ServiceNowTableEntry @PSBoundParameters -Table 'sc_req_item' If ( $result -and -not $Properties) { $result | ForEach-Object { $_.PSObject.TypeNames.Insert(0, "ServiceNow.RequestItem") } } $result } |