diff --git a/docs/management/admin/response-actions.asciidoc b/docs/management/admin/response-actions.asciidoc index 277cb9e680..56428764cb 100644 --- a/docs/management/admin/response-actions.asciidoc +++ b/docs/management/admin/response-actions.asciidoc @@ -192,6 +192,33 @@ Example: `scan --path "/Users/username/Downloads" --comment "Scan Downloads fold NOTE: Scanning can take longer for directories containing a lot of files. +[discrete] +[[runscript]] +=== `runscript` + +NOTE: This response action is supported only for <>. + +Run a script on a host. You must include one of the following parameters to identify the script you want to run: + +* `--Raw`: The full script content provided directly as a string. +* `--CloudFile`: The name of the script stored in a cloud storage location. +* `--HostPath`: The absolute or relative file path of the script located on the host machine. + +You can also use these optional parameters: + +* `--CommandLine`: Additional command-line arguments passed to the script to customize its execution. +* `--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. + +Required privilege: **Execute Operations** + +Examples: + +`runscript --CloudFile="CloudScript1.ps1" --CommandLine="-Verbose true" --Timeout=180` + +`runscript --Raw=```Get-ChildItem.```` + +`runscript --HostPath="C:\temp\LocalScript.ps1" --CommandLine="-Verbose true"` + [discrete] [[supporting-commands-parameters]] == Supporting commands and parameters diff --git a/docs/management/admin/third-party-actions.asciidoc b/docs/management/admin/third-party-actions.asciidoc index 14f3d6eb03..912d932d28 100644 --- a/docs/management/admin/third-party-actions.asciidoc +++ b/docs/management/admin/third-party-actions.asciidoc @@ -33,6 +33,10 @@ These response actions are supported for CrowdStrike-enrolled hosts: + Refer to the instructions on <> and <> hosts for more details. +* **Run a script on a host** with the <>. + +* **View past response action activity** in the <> log. + [discrete] [[defender-response-actions]] == Microsoft Defender for Endpoint response actions diff --git a/docs/serverless/endpoint-response-actions/response-actions.asciidoc b/docs/serverless/endpoint-response-actions/response-actions.asciidoc index 82012f892a..5194588b20 100644 --- a/docs/serverless/endpoint-response-actions/response-actions.asciidoc +++ b/docs/serverless/endpoint-response-actions/response-actions.asciidoc @@ -241,6 +241,35 @@ Example: `scan --path "/Users/username/Downloads" --comment "Scan Downloads fold Scanning can take longer for directories containing a lot of files. ==== +[discrete] +[[runscript]] +=== `runscript` + +NOTE: This response action is supported only for <>. + +Run a script on a host. You must include one of the following parameters to identify the script you want to run: + +* `--Raw`: The full script content provided directly as a string. +* `--CloudFile`: The name of the script stored in a cloud storage location. +* `--HostPath`: The absolute or relative file path of the script located on the host machine. + +You can also use these optional parameters: + +* `--CommandLine`: Additional command-line arguments passed to the script to customize its execution. +* `--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. + +Predefined role: **SOC manager** or **Endpoint operations analyst** + +Custom role privilege: **Execute Operations** + +Examples: + +`runscript --CloudFile="CloudScript1.ps1" --CommandLine="-Verbose true" --Timeout=180` + +`runscript --Raw=```Get-ChildItem.```` + +`runscript --HostPath="C:\temp\LocalScript.ps1" --CommandLine="-Verbose true"` + [discrete] [[supporting-commands-parameters]] == Supporting commands and parameters diff --git a/docs/serverless/endpoint-response-actions/third-party-actions.asciidoc b/docs/serverless/endpoint-response-actions/third-party-actions.asciidoc index 11982faaec..767f4dda99 100644 --- a/docs/serverless/endpoint-response-actions/third-party-actions.asciidoc +++ b/docs/serverless/endpoint-response-actions/third-party-actions.asciidoc @@ -45,6 +45,10 @@ These response actions are supported for CrowdStrike-enrolled hosts: + Refer to the instructions on <> and <> hosts for more details. +* **Run a script on a host** with the <>. + +* **View past response action activity** in the <> log. + ++++