HaloAPI

1.12.0-Beta2

Public/Restore/Restore-HaloTicket.ps1

function Restore-HaloTicket {
    <#
        .SYNOPSIS
            Restores a ticket using the Halo API.
        .DESCRIPTION
            Restores a specific ticket or array of tickets from Halo.
        .OUTPUTS
            A powershell object containing the response.
    #>
    [cmdletbinding( SupportsShouldProcess = $True, ConfirmImpact = 'High' )]
    [OutputType([Object])]
    Param(
        # The Ticket id or array of ticket ids.
        [Parameter( Mandatory = $True )]
        [Alias('Ticket')]
        [int64[]]$TicketId
    )
    Invoke-HaloPreFlightCheck
    try {
        $Tickets = [System.Collections.Generic.List[Object]]
        $TicketId | ForEach-Object {
            $Tickets.Add(
                @{
                    id = $_.id
                    _recover = $True
                    _validate_updates = $True
                }
            )
        }
        if ($PSCmdlet.ShouldProcess($Tickets -is [Array] ? 'Tickets' : 'Ticket', 'Update')) {
            Set-HaloTicket -Object $Tickets
        }
    } catch {
        New-HaloError -ErrorRecord $_
    }
}