Views:

Execute a PowerShell or Bash script on a target endpoint during an investigation.

Remote custom scripts allows Master Administrator and Security Analyst roles to directly access target endpoints to run a previously uploaded PowerShell and Bash script files.
The following services this task:
  • Trend Vision One
    • Linux agent
    • macOS agent
    • Windows agent
  • Trend Cloud One - Endpoint & Workload Security
    • Linux agent
    • macOS agent
    • Windows agent
Important
Important
The following recommendations apply only to PowerShell scripts executed on Windows endpoints:
  • The target endpoint's PowerShell execution policy must be set to RemoteSigned, otherwise the script may be blocked. RemoteSigned is the default execution policy.
  • Trend Micro recommends you configure the PowerShell session language mode to FullLanguage, otherwise the script may be blocked. FullLanguage is the default language mode for default sessions on all versions of Windows except for Windows RT.
  • The script file must not include interactive functions. Because scripts run in silent mode, interactive functions will cause scripts to time out.
    For an example of a signed script, see Sample signed PowerShell script.
  • Running processes that involve graphical user interfaces (GUIs) is prohibited. This is because the script operates in the service's logon session making it impossible to display windows in the user session due to security concerns.
To learn more about the above settings, please consult the Microsoft PowerShell official documentation.

Procedure

  1. After identifying the endpoint to investigate, select Run Remote Custom Script from the context or response menu. You can execute only one custom script file per session. The target endpoint must be online to connect successfully.
    The Run Remote Custom Script Task screen appears and Trend Vision One attempts to connect to the endpoint.
  2. Select a custom script file.
    To add a new custom script, go to Custom Scripts on the Response Scripts tab of Response Management. Click Add script to upload a new script file.
  3. Specify the arguments to added to the script during script execution. You can specify a maximum of 8,000 characters.
  4. Specify a Description for the response or event.
  5. Click Create.
    Trend Vision One creates the task and displays the current task status in Response Management.
  6. Monitor the task status.
    1. Go to Workflow and Automation → Response Management .
    2. Locate the task.
    • Use the Search to find the task.
    • Select Run Remote Custom Script → Action.
    1. View the task status.
      • In progress (in_progress=GUID-A55897DB-3DEA-4F5C-B7F9-70B3D7FB9EDE=1=en-us=Low.jpg): Trend Vision One sent the command and is waiting for a response.
      • Successful (successful=GUID-1E31AD86-DE2E-48B5-85F7-7C78A3E8BB11=1=en-us=Low.jpg): The command was successfully executed.
      • Unsuccessful (error=5cc21722-7ceb-480c-b9c2-a47d420cf1cc.jpg): An error or time-out occurred when attempting to send the command to the managing server, the Security Agent is offline for more than 12 hours, or the command execution timed out.
    2. Click the Task ID to display Details and Download the session history. Use an external decompression program (for example, 7-zip) to extract the file contents.
Related information