Skip to content

Commit 355221d

Browse files
mergify[bot]natasha-moore-elasticgithub-actions[bot]
authored
[8.x] [Jan 28] Adds new runscript Crowdstrike response action (backport #6435) (#6490)
* [Jan 28] Adds new runscript Crowdstrike response action (#6435) * Adds new runscript Crowdstrike response action * Add missing information * Updates example * Address feedback * Update example (cherry picked from commit 4a52fe9) # Conflicts: # docs/serverless/endpoint-response-actions/response-actions.asciidoc # docs/serverless/endpoint-response-actions/third-party-actions.asciidoc * Delete docs/serverless directory and its contents --------- Co-authored-by: natasha-moore-elastic <137783811+natasha-moore-elastic@users.noreply.github.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent a5ba424 commit 355221d

File tree

2 files changed

+31
-0
lines changed

2 files changed

+31
-0
lines changed

docs/management/admin/response-actions.asciidoc

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -192,6 +192,33 @@ Example: `scan --path "/Users/username/Downloads" --comment "Scan Downloads fold
192192

193193
NOTE: Scanning can take longer for directories containing a lot of files.
194194

195+
[discrete]
196+
[[runscript]]
197+
=== `runscript`
198+
199+
NOTE: This response action is supported only for <<crowdstrike-response-actions, CrowdStrike-enrolled hosts>>.
200+
201+
Run a script on a host. You must include one of the following parameters to identify the script you want to run:
202+
203+
* `--Raw`: The full script content provided directly as a string.
204+
* `--CloudFile`: The name of the script stored in a cloud storage location.
205+
* `--HostPath`: The absolute or relative file path of the script located on the host machine.
206+
207+
You can also use these optional parameters:
208+
209+
* `--CommandLine`: Additional command-line arguments passed to the script to customize its execution.
210+
* `--Timeout`: The maximum duration, in seconds, that the script can run before it's forcibly stopped. If no timeout is specified, it defaults to 60 seconds.
211+
212+
Required privilege: **Execute Operations**
213+
214+
Examples:
215+
216+
`runscript --CloudFile="CloudScript1.ps1" --CommandLine="-Verbose true" --Timeout=180`
217+
218+
`runscript --Raw=```Get-ChildItem.````
219+
220+
`runscript --HostPath="C:\temp\LocalScript.ps1" --CommandLine="-Verbose true"`
221+
195222
[discrete]
196223
[[supporting-commands-parameters]]
197224
== Supporting commands and parameters

docs/management/admin/third-party-actions.asciidoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,10 @@ These response actions are supported for CrowdStrike-enrolled hosts:
3535
+
3636
Refer to the instructions on <<isolate-a-host,isolating>> and <<release-a-host,releasing>> hosts for more details.
3737

38+
* **Run a script on a host** with the <<runscript,`runscript` response action>>.
39+
40+
* **View past response action activity** in the <<response-actions-history,response actions history>> log.
41+
3842
[discrete]
3943
[[sentinelone-response-actions]]
4044
== SentinelOne response actions

0 commit comments

Comments
 (0)