Skip to main content

Get-FalconBehavior

Search for behaviors associated with incidents. Required Permission: Incidents: Read

Syntax

Parameters

string[]
Behavior identifier(s). Can be provided via pipeline.Pattern: ^ind:[a-fA-F0-9]{32}:(\d|\-)+$Aliases: ids, behavior_id
string
Falcon Query Language (FQL) expression to limit results.Must be a valid FQL statement.
string
Property and direction to sort results.Valid values: timestamp.asc, timestamp.desc
int32
Maximum number of results per request.Range: 1-500
int32
Position to begin retrieving results (used for pagination).
switch
Retrieve detailed information for behaviors.
switch
Repeat requests until all available results are retrieved.
switch
Display total result count instead of results.

Examples


Get-FalconIncident

Search for incidents in the CrowdStrike Falcon platform. Required Permission: Incidents: Read

Syntax

Parameters

string[]
Incident identifier(s). Can be provided via pipeline.Pattern: ^inc:[a-fA-F0-9]{32}:[a-fA-F0-9]{32}$Aliases: ids, incident_id
string
Falcon Query Language (FQL) expression to limit results.Must be a valid FQL statement.
string
Property and direction to sort results.Valid values: assigned_to.asc, assigned_to.desc, assigned_to_name.asc, assigned_to_name.desc, end.asc, end.desc, modified_timestamp.asc, modified_timestamp.desc, name.asc, name.desc, sort_score.asc, sort_score.desc, start.asc, start.desc, state.asc, state.desc, status.asc, status.desc
int32
Maximum number of results per request.Range: 1-500
int32
Position to begin retrieving results (used for pagination).
switch
Retrieve detailed information for incidents.
switch
Repeat requests until all available results are retrieved.
switch
Display total result count instead of results.

Examples


Get-FalconScore

Search for CrowdScore values in the CrowdStrike Falcon platform. Required Permission: Incidents: Read

Syntax

Parameters

string
Falcon Query Language (FQL) expression to limit results.Must be a valid FQL statement.
string
Property and direction to sort results.Valid values: score.asc, score.desc, timestamp.asc, timestamp.desc
int32
Maximum number of results per request.Range: 1-2500
int32
Position to begin retrieving results (used for pagination).
switch
Repeat requests until all available results are retrieved.
switch
Display total result count instead of results.

Examples


Invoke-FalconIncidentAction

Perform actions on incidents in the CrowdStrike Falcon platform. Required Permission: Incidents: Write

Syntax

Parameters

string
required
Action to perform on the incident(s).Valid values:
  • add_tag - Add a tag to the incident
  • delete_tag - Remove a tag from the incident
  • unassign - Unassign the incident
  • update_description - Update the incident description
  • update_name - Update the incident name
  • update_status - Update the incident status
  • update_assigned_to_v2 - Assign incident to a user
string
Value for the chosen action (e.g., tag name, description text, user ID, status value).
hashtable[]
One or more hashtables defining multiple name/value pairs for batch operations.Aliases: action_parametersExample: @(@{name='add_tag'; value='investigated'}, @{name='update_status'; value='closed'})
boolean
Update status of related ‘new’ detections when updating incident status.Aliases: update_detects
boolean
Replace existing status for related detections when updating incident status.Aliases: overwrite_detects
string[]
required
Incident identifier(s). Can be provided via pipeline.Pattern: ^inc:[a-fA-F0-9]{32}:[a-fA-F0-9]{32}$Aliases: ids, incident_id

Examples

Notes

  • Maximum of 1000 incident IDs can be processed per request
  • When using -Action, multiple operations can be performed in a single API call
  • The -UpdateDetects parameter automatically updates related detections when changing incident status
  • Use -OverwriteDetects to replace existing detection statuses instead of only updating ‘new’ detections