Skip to main content

Get-HaloAttachment

Generated Cmdlet Help

This page has been generated from the HaloAPI PowerShell module source. To make changes please edit the appropriate PowerShell source file.

SYNOPSIS

Gets attachments from the Halo API.

SYNTAX

Multi (Default)

Get-HaloAttachment -TicketID <Int64> [-ActionID <Int64>] [-Type <Int64>] [-UniqueID <Int64>]
[-ProgressAction <ActionPreference>] [<CommonParameters>]

SinglePath

Get-HaloAttachment -AttachmentID <Int64> -OutPath <String> [-ProgressAction <ActionPreference>]
[<CommonParameters>]

SingleFile

Get-HaloAttachment -AttachmentID <Int64> -OutFile <String> [-ProgressAction <ActionPreference>]
[<CommonParameters>]

Single

Get-HaloAttachment -AttachmentID <Int64> [-IncludeDetails] [-AsBase64] [-GetToken]
[-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

Retrieves attachments from the Halo API - supports a variety of filtering parameters.

EXAMPLES

PARAMETERS

-AttachmentID

Attachment ID

Type: Int64
Parameter Sets: SinglePath, SingleFile, Single
Aliases:

Required: True
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-TicketID

Returns attachments from the ticket ID specified

Type: Int64
Parameter Sets: Multi
Aliases: ticket_id

Required: True
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-ActionID

Returns attachments from the action ID specified (requires ticket_id)

Type: Int64
Parameter Sets: Multi
Aliases: action_id

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-Type

Returns attachments of the specified type

Type: Int64
Parameter Sets: Multi
Aliases:

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-UniqueID

Returns an attachment with the unique ID specified

Type: Int64
Parameter Sets: Multi
Aliases: unique_id

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-IncludeDetails

Include extra objects in the result.

Type: SwitchParameter
Parameter Sets: Single
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-OutFile

Allow Writing Directly to File, using the specified path and file name eg c:\temp\myfile.txt

Type: String
Parameter Sets: SingleFile
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OutPath

Allow Writing Directly to File, using the specified path and the original file name eg c:\temp\

Type: String
Parameter Sets: SinglePath
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AsBase64

Return the attachment as a base64 encoded string

Type: SwitchParameter
Parameter Sets: Single
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-GetToken

Get the token for accessing the image using the token parameter(s).

Type: SwitchParameter
Parameter Sets: Single
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

A powershell object containing the response.

NOTES