--- title: "Adding an Endpoint agent for Host Remediation Host Remediation module" slug: "adding-an-endpoint-agent-for-host-remediation-host-remediation-module" updated: 2026-09-11T11:11:59Z published: 2026-09-11T11:11:59Z canonical: "docs.trellix.com/adding-an-endpoint-agent-for-host-remediation-host-remediation-module" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Adding an Endpoint agent for Host Remediation Host Remediation module 1. In the Host Remediation home page, in the Search field, enter one of the following parameters for the endpoint that you want to add: - Agent ID - IP Address - Hostname ![HR_Search.jpeg](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-b4277a27-8941-4e08-2a04-4a8ea7205d33.jpg?sv=2026-02-06&spr=https&st=2026-11-21T00%3A08%3A38Z&se=2026-11-21T01%3A08%3A38Z&sr=c&sp=r&sig=mmGyBhqnnOCqv2Tph2aPgdxjKzSzJmQEYOPn%2FW%2Bpe2o%3D) 2. Click **Search**. The host details are displayed. 3. Click **Initiate** to add the endpoint for remediation. When the endpoint is connected, a PowerShell terminal window opens in the Endpoint Security (HX) Web UI. ### Note The remote connection time depends on the Fast Poll setting for the agent in the policy. ![HR_HostDetails.jpeg](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-0dc85c33-6516-aec0-3212-6c69e8216f9a.png?sv=2026-02-06&spr=https&st=2026-11-21T00%3A08%3A38Z&se=2026-11-21T01%3A08%3A38Z&sr=c&sp=r&sig=mmGyBhqnnOCqv2Tph2aPgdxjKzSzJmQEYOPn%2FW%2Bpe2o%3D) 4. Use the terminal window to execute native operating system commands or execute batch scripts on the endpoint. Or use the "Drag file here or browse" option to upload a custom batch script or PowerShell format. ![HR_PowerShellWindow.jpeg](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-ef500021-0618-a667-7dba-164328e19f7e.png?sv=2026-02-06&spr=https&st=2026-11-21T00%3A08%3A38Z&se=2026-11-21T01%3A08%3A38Z&sr=c&sp=r&sig=mmGyBhqnnOCqv2Tph2aPgdxjKzSzJmQEYOPn%2FW%2Bpe2o%3D) ### Note Interactive commands and scripts that require user input for execution are not supported, for example, `vi/vim` and `edit`. 5. When the Host Remediation module session is complete, click the Transcript icon to download the transcript logs. The transcript includes executed commands, their output, session initiation, the end time, and the user who initiated the remote session. ![HR_AvailableTranscripts.jpeg](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-1937c7a2-3287-4a76-e0a1-e2b4a2eb633b.png?sv=2026-02-06&spr=https&st=2026-11-21T00%3A08%3A38Z&se=2026-11-21T01%3A08%3A38Z&sr=c&sp=r&sig=mmGyBhqnnOCqv2Tph2aPgdxjKzSzJmQEYOPn%2FW%2Bpe2o%3D) ### Note You can only remediate one host at a time and a maximum of 10 hosts can be added to the Host Remediation list. From the time the host is added for remediation, there is a maximum timeout of 24 hours. When this timeout is reached, the host state changes to "Time to initiate remediation expired". For more information, see [Viewing the Host Remediation status](/docs/viewing-the-host-remediation-host-remediation-status). :