getRelativePathFile()

Uploads a file from a managed machine to an approved path on the Kaseya Server. The approved path is relative to the <KaseyaInstallationDirectory>\UserProfiles\<agent guid>\GetFiles directory. The file is stored on the Kaseya Server in a private directory for each managed machine. View or run the uploaded file using Agent Procedures > Get File.

Optionally, existing copies of uploaded files are renamed with a .bak extension prior to the next upload of the file. This allows you to examine both the latest version of the file and the previous version.
Optionally create a Get File alert if the uploaded file differs or is the same from the file that was uploaded previously. You must create a Get File alert for a machine ID using the Monitor > Alerts - Get File page to enable the sending of an alert using the getRelativePathFile() command. Once defined for a machine ID, the same Get File alert is active for any agent procedure that uses a getFile() or getRelativePathFile() command and is run on that machine ID. Turn off alerts for specific files in the agent procedure editor by selecting one of the no-alert options.

The list of approved relative paths is specified using one or more XML files located at <KaseyaInstallationDirectory>\xml\Procedures\AgentProcPaths\<partitionId>\getRelativePathFile.

Filenames can be any name with an .xml extension so long as they are formatted correctly internally. Multiple statements specified using one or more XML files display as a single combined combo box list in the user interface. Each approved path statement in the XML file has a unique label, and only the labels are shown in the combo box. If no approved path statements are defined, then *No Approved Paths* displays in the combo box.

Partition-Specific Statements

Partition-specific folders can contain partition-specific approved path statements. For example: <KaseyaInstallationDirectory>\xml\Procedures\AgentProcPaths\1234567890\getRelativePathFile. Users can select and run all 0 folder approved path statements and all approved path statements located in the partition path that matches the partition they are using.

Example Format

</pathList>