Directly access an endpoint and execute CLI commands or a custom script file during an investigation.
This task is supported by the following services:
-
Trend Vision One
-
Windows agent
-
Mac agent
-
Linux agent
-
-
Trend Cloud One - Endpoint & Workload Security
-
Windows agent
-
Mac agent
-
Linux agent
-
Only users with the Master Administrator or Security Analyst roles can access the
Remote Shell response.
Procedure
- After identifying the endpoint to investigate, access the context or response
menu and click Start Remote Shell Session.The Remote Shell screen appears and Trend Vision One attempts to connect to the endpoint.
Note
Trend Vision One only permits 10 concurrent remote shell sessions per company and does not permit multiple users from accessing the same endpoint concurrently. The target endpoint must be online in order to connect successfully.If Trend Vision One cannot establish a Remote Shell session within 5 minutes, the connection times out. - Use the CLI to manually type commands or run an existing custom script
file.
-
Use the Remote Shell console to execute the necessary commands for your investigation.Type help at any time to view all the commands available.
Note
The remote shell session automatically ends after 2 hours and automatically times out after 10 minutes of inactivity. -
Click Use Custom Script to open the details panel and click Run next to the script file that you want to execute.
Note
Trend Vision One only permits you to execute 1 custom script file per session. The target endpoint must be online in order to connect successfully.
-
- After you have completed your investigation, click End Session to terminate the connection to the endpoint.
- (Optional) Provide a description for the remote shell session and click
End Session.
Note
Terminating the connection may take a minute to complete. If you close the browser window before clicking End Session, the connection to the endpoint times out after 10 minutes. - Monitor the task status.
- Open Response Management.
- (Optional) Locate the task using the Search field or by selecting Remote Shell from the Action drop-down list.
- View the task status.
-
In progress (): Trend Vision One sent the command and is waiting for a response.
-
Successful (): The command was successfully executed.
-
Unsuccessful (): An error or time-out occurred when attempting to send the command to the managing server, the Security Agent is offline, or the command execution timed out
-
- Click the Task ID to open the Details panel and Download the session history as a TXT file.