Skip to content

Commit 4a52fe9

Browse files
[Jan 28] Adds new runscript Crowdstrike response action (#6435)
* Adds new runscript Crowdstrike response action * Add missing information * Updates example * Address feedback * Update example
1 parent 285d9d3 commit 4a52fe9

File tree

4 files changed

+64
-0
lines changed

4 files changed

+64
-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
@@ -33,6 +33,10 @@ These response actions are supported for CrowdStrike-enrolled hosts:
3333
+
3434
Refer to the instructions on <<isolate-a-host,isolating>> and <<release-a-host,releasing>> hosts for more details.
3535

36+
* **Run a script on a host** with the <<runscript,`runscript` response action>>.
37+
38+
* **View past response action activity** in the <<response-actions-history,response actions history>> log.
39+
3640
[discrete]
3741
[[defender-response-actions]]
3842
== Microsoft Defender for Endpoint response actions

docs/serverless/endpoint-response-actions/response-actions.asciidoc

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -241,6 +241,35 @@ Example: `scan --path "/Users/username/Downloads" --comment "Scan Downloads fold
241241
Scanning can take longer for directories containing a lot of files.
242242
====
243243

244+
[discrete]
245+
[[runscript]]
246+
=== `runscript`
247+
248+
NOTE: This response action is supported only for <<security-third-party-actions-supported-systems-and-response-actions, CrowdStrike-enrolled hosts>>.
249+
250+
Run a script on a host. You must include one of the following parameters to identify the script you want to run:
251+
252+
* `--Raw`: The full script content provided directly as a string.
253+
* `--CloudFile`: The name of the script stored in a cloud storage location.
254+
* `--HostPath`: The absolute or relative file path of the script located on the host machine.
255+
256+
You can also use these optional parameters:
257+
258+
* `--CommandLine`: Additional command-line arguments passed to the script to customize its execution.
259+
* `--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.
260+
261+
Predefined role: **SOC manager** or **Endpoint operations analyst**
262+
263+
Custom role privilege: **Execute Operations**
264+
265+
Examples:
266+
267+
`runscript --CloudFile="CloudScript1.ps1" --CommandLine="-Verbose true" --Timeout=180`
268+
269+
`runscript --Raw=```Get-ChildItem.````
270+
271+
`runscript --HostPath="C:\temp\LocalScript.ps1" --CommandLine="-Verbose true"`
272+
244273
[discrete]
245274
[[supporting-commands-parameters]]
246275
== Supporting commands and parameters

docs/serverless/endpoint-response-actions/third-party-actions.asciidoc

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

48+
* **Run a script on a host** with the <<runscript,`runscript` response action>>.
49+
50+
* **View past response action activity** in the <<security-response-actions-history,response actions history>> log.
51+
4852
++++
4953
</div>
5054
<div tabindex="0" role="tabpanel" id="endpoint-response-actions-third-party-actions-defender-panel" aria-labelledby="endpoint-response-actions-third-party-actions-defender-button" hidden="">

0 commit comments

Comments
 (0)