Skip to content

Send FalconSample

bk-cs edited this page Apr 28, 2023 · 20 revisions

Send-FalconSample

SYNOPSIS

Upload a sample file

DESCRIPTION

A successful upload will provide a 'sha256' value that can be used in submissions to the Falcon Sandbox or Falcon QuickScan.

Maximum file size is 256MB. ZIP and 7z archives will automatically redirect to 'Send-FalconSampleArchive'.

Requires 'Sample uploads: Write'.

PARAMETERS

Name Type Description Min Max Allowed Pipeline PipelineByName
IsConfidential Boolean Prohibit sample from being displayed in MalQuery [default: True]
Comment String Audit log comment
Name String File name X
Path String Path to local file X

SYNTAX

Send-FalconSample [[-IsConfidential] <Boolean>] [[-Comment] <String>] [[-Name] <String>] [-Path] <String> [-WhatIf] [-Confirm] [<CommonParameters>]

REFERENCE

Endpoints

POST /samples/entities/samples/v3

falconpy

UploadSampleV3

USAGE

Upload a sample

Send-FalconSample -Path C:\virus.exe -Filename virus.exe -Comment 'bad file'

Upload a directory of samples

Get-ChildItem -Path C:\samples -File | Send-FalconSample

See New-FalconQuickScan.

See New-FalconSubmission.

2023-04-25: PSFalcon v2.2.5

Clone this wiki locally