Restart team agents

You need to restart a team agent in the following cases:

• You closed the agent window on the machine.

• You rebooted the agent machine and don't have your agent configured for auto-startup.

• You want to change agent configurations. For example, add characteristics or change agent settings.

To restart an agent, open the Command Prompt window and run the following command:

launcher agent --shared --tenant <your_tenant_name> --agentId <name_of_your_shared_agent> --characteristics <name1>:<value1> <name2>:<value2>

Keep in mind that this command starts the agent with these specifications. It's not an update. This means: 

• You need to enter the agent ID if you defined a specific name during the original setup. Otherwise, the agent name changes to the default ID.

• You need to enter all custom characteristics that the agent should have. To add new characteristics, enter the existing characteristics and the new ones. You don't have to enter any of the default characteristics.

• You need to define which settings you want to keep. To restart the agent with the respective setting active, add --keepdisplayon and/or --liveview.