Get-AutomateTicket

NAME Get-AutomateTicket



SYNOPSIS

Get Ticket information out of the Automate API





SYNTAX

Get-AutomateTicket [[-TicketID] <Int32[]>] [<CommonParameters>]



Get-AutomateTicket [-ComputerID <Int32[]>] [<CommonParameters>]



Get-AutomateTicket [-AllTickets] [-IncludeFields <String>] [-ExcludeFields <String>] [-OrderBy <String>]

[<CommonParameters>]



Get-AutomateTicket [-Condition <String>] [-IncludeFields <String>] [-ExcludeFields <String>] [-OrderBy <String>]

[<CommonParameters>]



Get-AutomateTicket [-IncludeFields <String>] [-ExcludeFields <String>] [-OrderBy <String>] [-StatusID <Int32>]

[-StatusName <String>] [-Subject <String>] [-PriorityID <Int32>] [-PriorityName <String>] [-From <String>] [-CC

<String>] [-SupportLevel <Int32>] [-ExternalID <Int32>] [-UnsyncedTickets] [<CommonParameters>]





DESCRIPTION

Connects to the Automate API and returns one or more full ticket objects





PARAMETERS

-TicketID <Int32[]>



Required? false

Position? 1

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ComputerID <Int32[]>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-AllTickets [<SwitchParameter>]

Returns all tickets in Automate, regardless of amount



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-Condition <String>

A custom condition to build searches that can be used to search for specific things. Supported operators are

'=', 'eq', '>', '>=', '<', '<=', 'and', 'or', '()', 'like', 'contains', 'in', 'not'.

The 'not' operator is only used with 'in', 'like', or 'contains'. The '=' and 'eq' operator are the same.

String values can be surrounded with either single or double quotes. IE (RemoteAgentLastContact <=

2019-12-18T00:50:19.575Z)

Boolean values are specified as 'true' or 'false'. Parenthesis can be used to control the order of operations

and group conditions.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-IncludeFields <String>

A comma separated list of fields that you want including in the returned ticket object.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ExcludeFields <String>

A comma separated list of fields that you want excluding in the returned ticket object.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-OrderBy <String>

A comma separated list of fields that you want to order by finishing with either an asc or desc.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-StatusID <Int32>



Required? false

Position? named

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-StatusName <String>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Subject <String>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-PriorityID <Int32>



Required? false

Position? named

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-PriorityName <String>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-From <String>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-CC <String>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-SupportLevel <Int32>



Required? false

Position? named

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-ExternalID <Int32>



Required? false

Position? named

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-UnsyncedTickets [<SwitchParameter>]



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



NOTES





Version: 1.0

Author: Gavin Stone

Creation Date: 2019-02-25

Purpose/Change: Initial script development



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Get-AutomateTicket -AllTickets















RELATED LINKS