17.44 prepagt.bat (generalizing an agent)
This section describes the prepagt.bat command that is used to generalize an agent by deleting program-specific information from it.
Functionality
When you install an agent on a computer, program-specific information regarding the agent is retained in a temporary file or other similar location inside the agent.
In the case of a shared VDI, virtual computers are created from the master image. When you install an agent on a virtual computer to create a master image, you have to first generalize the agent by deleting program-specific information from it. You can generalize the agent by executing the prepagt.bat command on the virtual computer that is used for creating the master image.
- Important
-
-
This command works only with Windows agents. It does not work with UNIX agents or Mac agents.
-
This command does not work with agents on the relay system or the management relay server.
-
Execute this command on a computer on which the agent is already installed.
Format
prepagt.bat∆/prep[∆/password:password]
Argument
- /prep
-
Always specify this argument. If this argument is omitted, the command cannot be executed.
- /password:password
-
If you have set a password in Settings to Protect Agents, specify the set password. If you have not set a password in Settings to Protect Agents, do not specify this argument.
Storage location
agent-installation-folder\bin\
Notes
This command cannot be simultaneously executed by multiple users.
Return value
The following table shows the return values of the prepagt.bat command.
Return value |
Description |
---|---|
0 |
The command finished normally. |
11 |
The specified format for the argument is incorrect. |
31 |
Another command is being executed. |
51 |
You do not have the permissions to execute this command. |
101 |
An attempt to generalize the agent failed. |
Example
The following example shows use of this command to generalize the agent for which Password1234 is set as a password in Settings to Protect Agents.
prepagt.bat /prep /password:Password1234
Related Topics: