Veeam Agent Configurator

Version 2.2
Reference
July, 2018
© 2018 Veeam Software.

All rights reserved. All trademarks are the property of their respective owners.

No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or
translated into any language in any form by any means, without written permission from Veeam Software
(Veeam). The information contained in this document represents the current view of Veeam on the issue
discussed as of the date of publication and is subject to change without notice. Veeam shall not be liable for
technical or editorial errors or omissions contained herein. Veeam makes no warranties, express or implied, in
this document. Veeam may have patents, patent applications, trademark, copyright, or other intellectual property
rights covering the subject matter of this document. All other trademarks mentioned herein are the property of
their respective owners. Except as expressly provided in any written license agreement from Veeam, the
furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other
intellectual property.

NOTE:

Please read the End User Software License Agreement before using the accompanying software program(s).
Using any part of the software indicates that you accept the terms of the End User Software License
Agreement.

2 | Veeam Agent Configurator | Reference | REV 2

Contents
CONTENTS .................................................................................................................................................................3
CONTACTING VEEAM SOFTWARE .............................................................................................................................4
ABOUT THIS DOCUMENT ...........................................................................................................................................5
OVERVIEW .................................................................................................................................................................6
BASIC COMMAND SYNTAX .......................................................................................................................................... 7
INPUT AND OUTPUT XML FILES ................................................................................................................................... 8
OPERATION STATUSES AND ALERTS ............................................................................................................................ 10
ENCRYPTION OF USER CREDENTIALS ........................................................................................................................... 12
Supported Encryption Methods ................................................................................................................ 14
REQUIRED LICENSE ................................................................................................................................................15
GETTING HELP .........................................................................................................................................................16
COMMANDS .............................................................................................................................................................17
LICENSE ............................................................................................................................................................. 18
IMPORT .............................................................................................................................................................. 19
EXPORT.............................................................................................................................................................. 20
INPUT XML FILE STRUCTURE ..................................................................................................................................21
APPLICATION PARAMETERS ....................................................................................................................................... 24
JOB PARAMETERS .................................................................................................................................................. 28
General Information ................................................................................................................................ 29
Backup Scope ......................................................................................................................................... 30
Backup Target ........................................................................................................................................ 33
Storage Settings ..................................................................................................................................... 38
Retention Settings .................................................................................................................................. 40
Cache Settings ....................................................................................................................................... 41
Application-Aware Settings (Server Mode) ................................................................................................. 43
Scheduling Settings................................................................................................................................. 51
STATISTICS INFORMATION ....................................................................................................................................... 64
UNATTENDED INSTALLATION .................................................................................................................................65
HOW TO AUTOMATE VEEAM AGENT FOR MICROSOFT WINDOWS DEPLOYMENT AND CONFIGURATION ...........66

3 | Veeam Agent Configurator | Reference | REV 2

Contacting Veeam Software
At Veeam Software we value the feedback from our customers. It is important not only to help you quickly with
your technical issues, but it is our mission to listen to your input, and build products that incorporate your
suggestions.

Customer Support
Should you have a technical concern, suggestion or question, please visit our Customer Center Portal at
www.veeam.com/support.html to open a case, search our knowledge base, reference documentation, manage
your license or obtain the latest product release.

Company Contacts
For the most up to date information about company contacts and offices location, please visit
www.veeam.com/contacts.html.

Online Support
If you have any questions about Veeam products, you can use the following resources:

 Full documentation set: www.veeam.com/documentation-guides-datasheets.html

 Community forum at forums.veeam.com

4 | Veeam Agent Configurator | Reference | REV 2

About This Document
This guide is intended for IT managers, virtual infrastructure administrators, and other personnel responsible for
the product deployment and operation.

This document describes the features included in the Veeam Agent Configurator. It also provides usage examples
and gives step-by-step instructions that will help you better understand how to install the Veeam Agent
Configurator and monitor your Veeam Backup infrastructure, services and jobs.

Intended Audience
The document is intended for backup administrators and other IT professionals who plan to deploy and use
Veeam Agent Configurator. This guide assumes that you have a good understanding of Veeam Backup &
Replication and VMware vSphere.

Document Revision History

Revision # Date Description of Changes

Revision 2 7/16/2018 Document is reviewed for for Veeam Agent Configurator version 2.2.

Revision 1 9/1/2016 Initial version of the document for Veeam Agent Configurator.

5 | Veeam Agent Configurator | Reference | REV 2

Overview
Veeam Agent Configurator is a tool that provides a command-line interface for Veeam Agent for Microsoft
Windows. With Veeam Agent Configurator, you can perform data protection and administrative operations for
Veeam Agent for Microsoft Windows from the command line, create custom scripts or integrate Veeam Agent for
Microsoft Windows with third-party applications.

You can use Veeam Agent Configurator to perform the following activities:

 Install the license and set the product edition

 Customize application settings

 Change backup job configuration

 Import backup job configuration file

 Export backup job configuration file

Veeam Agent Configurator comes with Veeam Agent for Microsoft Windows. The
Veeam.Agent.Configurator.exe file is placed in the product folder on the computer protected with Veeam
Agent for Microsoft Windows, by default, C:\Program Files\Veeam\Endpoint Backup.

6 | Veeam Agent Configurator | Reference | REV 2

Basic Command Syntax
Veeam Agent Configurator uses commands to perform actions in Veeam Agent for Microsoft Windows. The basic
command syntax for Veeam Agent Configurator is the following:

Veeam.Agent.Configurator.exe -Command [Parameters]

where:

 Command is the command name.

 Parameters are input parameters that are passed to the command.

7 | Veeam Agent Configurator | Reference | REV 2

Input and Output XML Files
To export and import data from/to Veeam Agent for Microsoft Windows, Veeam Agent Configurator uses XML
files. Veeam Agent Configurator operates with two types of files:

 Output XML files contain the current application settings and backup job configuration exported from
Veeam Agent for Microsoft Windows.

 Input XML files contain application settings and backup job configuration that must be set up in Veeam
Agent for Microsoft Windows.

Application settings and backup job configuration data is always saved to a single XML file. By default, the file is
located in the C:\ProgramData\Veeam\Endpoint\!Configuration\ folder on the machine where Veeam
Agent for Microsoft Windows is installed. However, you can use a file stored in a custom location.

<?xml version="1.0"?>
<ExecutionResult ExitCode="0" Version="2.0.0.689">
<Data>
<ApplicationSettings LogoText="Veeam Agent" LastCheckForUpdates="04/12/2017 01:31:07"
ServiceProviderMode="False" LockDownMode="False"
DisableBackupOverMeteredConnection="True" ShowBackupDuration="False"
ThrottleBackupActivity="True" DisableControlPanelNotification="True"
DisableScheduledBackups="False" CheckUpdates="True" CryptId="00000000-0000-0000-0000-
000000000000" CryptType="10"/>
<JobInfo CryptId="00000000-0000-0000-0000-000000000000" CryptType="10">
<SourceInfo>
<EpDiskFilter BackupUserFolders="True" BackupSystemState="False" BackupMode="2">
<Drive FilterType="1">
<VolumeOrPartitionId MountPoint="C:\" Type="1"/>
<IncludeFolders>
<String value="C:\Users"/>
</IncludeFolders>
<ExcludeFolders/>
</Drive>
<IncludeMasks/>
<ExcludeMasks/>
</EpDiskFilter>
</SourceInfo>
<TargetInfo Type="1" RelativePath="VeeamBackup\" DriveName="C:\"/>
<StorageInfo BlockSize="3" CompressionLevel="5">
<Encryption Enabled="False"/>
</StorageInfo>
<RetentionInfo RestorePointsCount="14"/>
<CacheInfo Enabled="False"/>
<GuestInfo>
<Applications Enabled="True" ProcessTransactionLogs="True">
<Sql Mode="1">
<Credentials Password="" UserName=""/>
<Backup Enabled="False" ExpireDays="15" BackupMinutes="15" Expirable="True"/>
</Sql>
<Oracle Mode="0" AccountType="0" SizeGB="10" LifetimeHours="24">
<Credentials Password="" UserName=""/>
<Backup Enabled="False" ExpireDays="15" BackupMinutes="15" Expirable="True"/>
</Oracle>
<SharePoint>
<Credentials Password="" UserName=""/>
</SharePoint>
<Script Mode="0" PostThawPath="" PreFreezePath="">
<Credentials Password="" UserName=""/>
</Script>
</Applications>
<Indexing Type="3" Enabled="False">
<IncludedFolders/>
<ExcludedFolders>

8 | Veeam Agent Configurator | Reference | REV 2

 <String value="%windir%"/>
<String value="%ProgramFiles%"/>
<String value="%ProgramFiles(x86)%"/>
<String value="%ProgramW6432%"/>
<String value="%TEMP%"/>
</ExcludedFolders>
</Indexing>
</GuestInfo>
<ScheduleInfo Version="1" CompletionMode="0" LimitBackupsFrequency="False"
UseBackupWindow="False" AtStorageAttach="False" AtLock="False" AtLogOff="False"
EjectRemovableStorageOnceBackupIsCompleted="False" ResumeMissedBackup="False"
RunManually="True">
<SyntheticFull Enabled="False"/>
<ActiveFull Enabled="False"/>
<RetryInfo Enabled="True" TimeoutMinutes="10" Times="3"/>
</ScheduleInfo>
<StatisticsInfo LastPointSize="52686848" TotalSize="52686848"
AverageDuration="00:02:31.7130000"/>
</JobInfo>
</Data>
<Notifications>
<Notification Message="Configuration has been exported to c:\Veeam\output.xml"/>
</Notifications>
</ExecutionResult>

Special Characters in XML

Some characters have a special meaning in the XML syntax and are reserved for internal purposes. You cannot
use these characters to describe property values in the input XML file. If you use these characters in property
values, Veeam Agent Configurator will not be able to parse the input XML file and will report an error in the
results of command execution.

If you need to specify one of these characters in property values, you must replace it with the appropriate string.

Character Character Replacement

< &lt;

> &gt;

& &quot;

' &apos;

" &quot;

9 | Veeam Agent Configurator | Reference | REV 2

Operation Statuses and Alerts
Operations performed with Veeam Agent Configurator commands end up with some result. Veeam Agent
Configurator reports command results in the following way:

 If the command executes successfully, Veeam Agent Configurator reports exit code 0 (Success).

 If the command fails to execute successfully, Veeam Agent Configurator reports a corresponding error
code and problem description.

Command execution can complete with the following statuses and alerts:

Error Code Error Name Error Description Severity Level

0 Success Operation has completed Information

successfully.

1 UnexpectedError Unexpected error has occurred Error

during the operation execution.

2 UnexpectedWarning Operation has completed with an Warning

unexpected warning, for example,
wake up timers are disabled on
the computer, and Veeam Agent
for Microsoft Windows has failed
to wake up the computer from
sleep and start the backup job.

3 NotSupportedFeature Feature is not supported by the Error

operation, for example, an
unsupported command,
parameter type or value has been
specified in the command input.

4 NotLicensedFeature License applied to the protected Error

machine does not cover the
requested functionality.

5 CanceledByUser Operation has been canceled by Information

the user.

10 | Veeam Agent Configurator | Reference | REV 2

10 InvalidExecutionParams Parameters provided for the Error
command are invalid.

20 FailedToPerform Operation has not been Error

performed, for example, Veeam
Agent Configurator has failed to
complete the command
execution.

30 JobNotFound Backup job has not been Error

configured and operation cannot
be executed.

40 FailedToSaveConfig Veeam Agent Configurator has Error

failed to generate the command
output, for example, there is no
free disk space, and the output
XML file has not been saved.

45 FailedToLoadConfig Backup job configuration has not Error

been loaded (for example, the
input XML file has not been found
by the specified path).

50 InvalidJobConfiguration Backup job configuration contains Error

errors (for example, specified
parameters are invalid).

11 | Veeam Agent Configurator | Reference | REV 2

Encryption of User Credentials
When you set up the backup job, you sometimes provide user credentials in the job configuration. You may need
to provide user credentials in the following cases:

 You target the backup job at a shared folder that requires user authentication.

 You target the backup job at a Veeam backup repository that requires user authentication.

 You enable application-aware processing for the backup job and need to provide credentials for a
database administrator account (Microsoft SQL Server, Microsoft SharePoint or Oracle), or credentials for
a user account under which pre-freeze and post-thaw scripts are executed.

Veeam Agent Configurator lets you provide user credentials in two ways:

 You can provide user credentials in the input XML file. This method can be used for all credentials
records that you need to specify in the backup job configuration. For more information, see How User
Credentials are Encrypted.

 You can provide user credentials in parameters to the -import command. This method can be used
only if you plan to change the backup target to a Veeam backup repository, and the Veeam backup
repository requires user authentication. For more information, see Import.

NOTE:

User credentials for a Veeam backup repository can be provided in parameters to the -import command and
in the input XML file. Veeam Agent Configurator handles conflict situations in the following way:
 If user credentials are provided in the command parameters and in the input XML file, Veeam
Agent Configurator uses credentials from the command parameters.
 If user credentials are provided only in the input XML file, Veeam Agent Configurator uses
credentials from the input XML file.
 If user credentials are provided neither in the command parameters nor in the input XML file,
Veeam Agent Configurator uses credentials that were previously specified in the backup job
configuration.

How User Credentials are Encrypted

To protect you against data interception, Veeam Agent Configurator supports encryption mechanisms for user
credentials.

When you set up the backup job configuration, you can encrypt user credentials with one of encryption methods
that Veeam Agent Configurator supports. In the input XML file, you must provide the encrypted credentials
strings and define which method is used for data encryption. During job configuration import, Veeam Agent
Configurator decrypts the credentials with the necessary decryption method.

To encrypt user credentials, you must perform the following actions:

1. Encrypt the password. The user name is not encrypted; you must provide it as a text string encoded in
the Base64 format.
You must encrypt the user password in the following way:

a. Encode the password as a byte array in the UTF-8 format.

b. Encrypt the byte array with one of supported encryption methods.

c. Convert the encrypted byte array to the Base64 format.

12 | Veeam Agent Configurator | Reference | REV 2

 NOTE:

If the user password starts with the 'SHA256HEX:' prefix followed by a space ( ), Veeam Agent Configurator
considers the remaining part of the string to be a password hash in the hexadecimal format.

2. In the input XML file, provide the user name encoded in the Base64 format and encrypted user
password.

3. In the CryptType parameter of the input XML file, define the method that Veeam Agent Configurator
must use to decrypt the user password. For more information, see Supported Encryption Methods.

<?xml version="1.0"?>
<JobInfo CryptType="10">
<TargetInfo Type="3" RemoteRepositoryName="Default Backup Repository"
ServerPort="10001" ServerName="backupserver01.tech.local">
<ServerCredentials Password="UGFzc3dvcmQ="
UserName="c3J2MDZcQWRtaW5pc3RyYXRvcg=="/>
...
</JobInfo>

NOTE:

During configuration export, Veeam Agent for Microsoft Windows does not store password values to the
output XML file.

13 | Veeam Agent Configurator | Reference | REV 2

Supported Encryption Methods
Veeam Agent Configurator supports the following methods for data encryption and decryption:

Encryption method Method code Description

None 0 During job configuration import, Veeam Agent Configurator ignores

encrypted data.

Base64 encoding 10 Default value at Veeam Agent for Microsoft Windows configuration export.

Data is encoded in the Base64 format. If you want to change credentials

after configuration export, you can encode user name and password into
Base64 strings and insert the strings into the configuration file.

DES 20 Data is encrypted with the standard DES encryption algorithm. For more
information, see https://msdn.microsoft.com/en-
us/library/system.security.cryptography.des(v=vs.110).aspx.

ProtectedData 30 Data is encrypted with the standard ProtectedData mechanism. Data can
CurrentUser be decrypted only by the user who encrypted it. For more information,
see https://msdn.microsoft.com/en-us/library/2fh8203k(v=vs.110).aspx.

ProtectedData 31 Data is encrypted with the standard ProtectedData mechanism. Data can
LocalMachine be decrypted only on the machine where it was encrypted. For more
information, see https://msdn.microsoft.com/en-
us/library/2fh8203k(v=vs.110).aspx.

To let Veeam Agent Configurator know which method you used for data encryption, you must specify the method
type in the CryptType parameter. For example, if you have encrypted the user password using the DES
algorithm, you must define value 20 in the CryptType parameter:

<?xml version="1.0"?>
<JobInfo CryptType="20">
…
</JobInfo>

14 | Veeam Agent Configurator | Reference | REV 2

Required License
Veeam Agent Configurator is available in Workstation and Server editions of Veeam Agent for Microsoft Windows.

15 | Veeam Agent Configurator | Reference | REV 2

Getting Help
To display built-in help information about Veeam Agent Configurator in the command prompt, you can use the
/? parameter.

 To display information about all available Veeam Agent Configurator commands, use the following
syntax:

Veeam.Agent.Configurator.exe /?

 To display information about a specific command, use the following syntax:

Veeam.Agent.Configurator.exe -<command> /?

For example, the Veeam.Agent.Configurator.exe -import /? command displays information about the
-import command in the command prompt.

16 | Veeam Agent Configurator | Reference | REV 2

Commands
You can use the following Veeam Agent Configurator commands:

Command Description

License Installs the license and sets the product edition.

Import Imports agent configuration from a file.

Export Exports local agent configuration to a file.

Re

17 | Veeam Agent Configurator | Reference | REV 2

License
Installs a license on the machine where Veeam Agent for Microsoft Windows is running and sets the product
edition.

Prerequisites
You must obtain a license file and store it on the local drive of the machine where Veeam Agent for Microsoft
Windows is installed or in a network shared folder.

Syntax
Veeam.Agent.Configurator.exe -license /f: [/w] [/s]

Parameters
Parameter Optional/Required Description

/f: Required Path to the license file.

/w Optional Sets the agent edition to Workstation. If

this parameter is not specified,
Workstation edition is set automatically
for the client OS versions.

/s Optional Sets the agent edition to Server. If this

parameter is not specified, Server
edition is set automatically for the
server OS versions.

Example of Use
This example installs the veeam_license.lic license file stored in the \\Fileserver\license\ shared
folder and sets the product edition to Workstation.

Veeam.Agent.Configurator.exe -license /f:"\\Fileserver\license\veeam_license.lic" /w

18 | Veeam Agent Configurator | Reference | REV 2

Import
Imports Veeam Agent for Microsoft Windows application settings and backup job configuration from the input
XML file.

Syntax
Veeam.Agent.Configurator.exe -import [/f:] [/u:] [/p:]

Parameters
Parameter Optional/Required Description

/f: Optional Path to the configuration file. If this

parameter is not specified, the default
path is used:
C:\ProgramData\Veeam\Endpoint
\!Configuration\Config.xml.

/u: Optional This parameter is used if you want to

change the backup target to a Veeam
backup repository that requires
authentication.

User name for access to the Veeam

backup repository. If this parameter is
not specified, the computer account is
used.

/p: Optional This parameter is used if you want to

change the backup target to a Veeam
backup repository that requires
authentication.

Password for access to the Veeam

backup repository.

Example of Use
This example imports application settings and configuration of the backup job from the C:\Veeam\Config.xml
file. The backup target is changed to the Veeam backup repository that can be accessed under a user account
with the following credentials:

 Username: Veeam

 Password: 1234

Veeam.Agent.Configurator.exe -import /f:C:\Veeam\Config.xml /u:Veeam /p:1234

19 | Veeam Agent Configurator | Reference | REV 2

Export
Exports the current Veeam Agent for Microsoft Windows application settings and backup job configuration to the
output XML file.

NOTE:

For security purposes, Veeam Agent Configurator does not export password values to the output XML file.

Prerequisites
The backup job must be configured on the machine. If the backup job is not configured, Veeam Agent
Configurator reports an error in the command output XML file and does not export the application settings and
job configuration.

Syntax
Veeam.Agent.Configurator.exe -export [/f:]

Parameters
Parameter Optional/Required Description

/f: Optional Path to the exported configuration. If the target folder does not exist, Veeam Agent
Configurator will create it.

If this parameter is not specified, the default path is used:

C:\ProgramData\Veeam\Endpoint\!Configuration\Config.xml.

Example of Use
This example exports the application data and backup job configuration to the Configuration.xml file in the
C:\Veeam\ folder.

Veeam.Agent.Configurator.exe -export /f:C:\Veeam\Configuration.xml

20 | Veeam Agent Configurator | Reference | REV 2

Input XML File Structure
When you run the Import command, you must provide a path to the input XML file that contains updated
application settings and configuration of the backup job. Veeam Agent Configurator reads parameters from the
input XML file and updates the necessary settings in Veeam Agent for Microsoft Windows.

The input XML file contains two sections:

 Application settings — general Veeam Agent for Microsoft Windows settings specified at the application
level. You can use this section to disable or enable backup over metered connections, throttle backup
activities and so on.

 Backup job settings — backup job configuration. You can use this section to modify backup job settings
such as backup type, backup target, scheduling settings and so on.

 Statistics information — statistics information about the backup job performance.

The input XML file has the following structure:

21 | Veeam Agent Configurator | Reference | REV 2

22 | Veeam Agent Configurator | Reference | REV 2
 <?xml version="1.0"?>
<ApplicationSettings LogoText="Veeam Agent" LastCheckForUpdates="04/12/2017 01:31:07"
ServiceProviderMode="False" LockDownMode="False"
DisableBackupOverMeteredConnection="True" ShowBackupDuration="False"
ThrottleBackupActivity="True" DisableControlPanelNotification="True"
DisableScheduledBackups="False" CheckUpdates="True" CryptType="10"/>
<JobInfo CryptType="10">
<SourceInfo>
<EpDiskFilter BackupUserFolders="True" BackupSystemState="False"
BackupMode="2">
<Drive FilterType="1">
<VolumeOrPartitionId MountPoint="C:\" Type="1"/>-<IncludeFolders>
<String value="C:\Users"/>
</IncludeFolders><ExcludeFolders/>
</Drive><IncludeMasks/><ExcludeMasks/>
</EpDiskFilter>
</SourceInfo>-<TargetInfo Type="3" RemoteRepositoryName="Default Backup
Repository" ServerPort="10001" ServerName="srv06.tech.local">
<ServerCredentials Password="UGFzc3dvcmQ="
UserName="c3J2MDZcQWRtaW5pc3RyYXRvcg=="/>
</TargetInfo>-<StorageInfo BlockSize="3" CompressionLevel="5">
<Encryption Enabled="False"/>
</StorageInfo><RetentionInfo RestorePointsCount="14"/><CacheInfo
Enabled="False"/>-<GuestInfo>
<Applications Enabled="False" ProcessTransactionLogs="True">
<Indexing Type="3" Enabled="False">
<IncludedFolders/>-<ExcludedFolders>
<String value="%windir%"/>
<String value="%ProgramFiles%"/>
<String value="%ProgramFiles(x86)%"/>
<String value="%ProgramW6432%"/>
<String value="%TEMP%"/>
</ExcludedFolders>
</Indexing>
</GuestInfo>-<ScheduleInfo Version="1" Type="1" FrequencyTimeUnit="1"
CompletionMode="0" MaxBackupsFrequency="2" LimitBackupsFrequency="True"
UseBackupWindow="False" AtStorageAttach="False" AtLock="False" AtLogOff="False"
EjectRemovableStorageOnceBackupIsCompleted="False" ResumeMissedBackup="False"
RunManually="True">
<DailyInfo Days="Sunday, Monday, Tuesday, Wednesday, Thursday, Friday,
Saturday" Kind="0" Time="04/12/2017 00:30:00"/>
<SyntheticFull Enabled="False"/>
<ActiveFull Enabled="False"/>
<RetryInfo Enabled="True" TimeoutMinutes="10" Times="3"/>
</ScheduleInfo><StatisticsInfo LastPointSize="52686848" TotalSize="52686848"
AverageDuration="00:02:31.7130000"/>
</JobInfo>

23 | Veeam Agent Configurator | Reference | REV 2

Application Parameters
The ApplicationSettings section in the input XML file contains Veeam Agent for Microsoft Windows
application settings.

<ApplicationSettings LogoText="Veeam Agent" LastCheckForUpdates="04/12/2017 01:31:07"

ServiceProviderMode="False" LockDownMode="False"
DisableBackupOverMeteredConnection="True" ShowBackupDuration="False"
ThrottleBackupActivity="True" DisableControlPanelNotification="False"
DisableScheduledBackups="False" CheckUpdates="True" CryptType="10">
<EmailReport Notification="True"><Header To="[email protected]"
From="[email protected]" Subject="[%JobResult%] %ComputerName% -
%CompletionTime%"/><Conditions Failure="True" Warning="True" Success="True"/>
<Smtp SecureConnection="True" Port="563" Server="smtp.tech.local">
<Credentials Password="UGFzc3dvcmQ=" UserName="QWRtaW5pc3RyYXRvcg=="/>
</Smtp>
</EmailReport>
</ApplicationSettings>

For application settings configuration, the following parameters can be used:

 General settings

 Notification settings

General Settings
Parent Tag Parameter Description

ApplicationSettings Parent tag that encapsulates information about application settings of

Veeam Agent for Microsoft Windows.

LogoText Text displayed at the top left corner of the Control Panel of Veeam Agent
for Microsoft Windows. By default, the 'Veeam Agent' text is displayed.

ServiceProviderMode Parameter describing if the Managed mode must be enabled. Possible

values:

 True — Managed mode is enabled.

 False — Managed mode is not enabled.

LockDownMode Parameter describing if the LockDown mode must be enabled. Possible

values:

 True — LockDown mode is enabled.

 False — LockDown mode is not enabled.

DisableBackup Parameter specifying if backup over metered connection must be

OverMetered performed. Possible values:
Connection
 True — backup over metered connections must not be
performed.
 False — backup over metered connections must be
performed.

24 | Veeam Agent Configurator | Reference | REV 2

 ShowBackupDuration Parameter switching the mode of displaying the backup statistics in the
Control Panel of Veeam Agent for Microsoft Windows. Possible values:

 True — Veeam Agent for Microsoft Windows displays backup

duration.
 False — Veeam Agent for Microsoft Windows displays backup
size.

ThrottleBackupActivity Parameter specifying if Veeam Agent for Microsoft Windows activities

must be throttled during backup. Possible values:

 True — backup activities are throttled.

 False — backup activities are not throttled.

DisableControlPanel Parameter specifying if Veeam Agent for Microsoft Windows notifications

Notification displayed on the notification bar must be disabled. Possible values:

 True — notifications are disabled.

 False — notifications are enabled.

DisableScheduled Parameter describing if the scheduled backup job must be disabled.

Backups Possible values:

 True — scheduled backup job is disabled.

 False — scheduled backup job is enabled.

CheckUpdates Parameter describing if Veeam Agent for Microsoft Windows must

automatically check for product updates. Possible values:

 True — Veeam Agent for Microsoft Windows checks for

updates.
 False — Veeam Agent for Microsoft Windows does not check
for updates.

LastCheckForUpdates This parameter is available in the output XML file only.

Date and time of the last check for application updates.

CryptType This parameter is used if you configure email notifications settings, and
the SMTP server requires authentication.

Encryption method used to encrypt the user password. For more

information, see Encryption of User Credentials.

CryptID Required only for ProtectedDataCurrentUser and

ProtectedDataLocalMachine encryption methods.

GUID based on which a pair of asymmetric keys is generated (string of 32

characters with 4dashes, for example: 12345678-1234-1234-1234-
123456789012).

25 | Veeam Agent Configurator | Reference | REV 2

Notification Settings
Parent Tag Parameter Description

EmailReport Parent tag that encapsulates information about email notification settings
in Veeam Agent for Microsoft Windows.

Notification Parameter describing if email notifications are enabled in Veeam Agent for
Microsoft Windows. Possible values:

 True — email notifications are enabled.

 False — email notifications are disabled.

Header Parent tag that encapsulates information about the header in email
notifications.

From Email address from which Veeam Agent for Microsoft Windows sends
email notifications.

To Email address at which Veeam Agent for Microsoft Windows sends email
notifications.

Subject Subject of email notifications. You can use the following variables in the
subject:

 %ComputerName%
 %JobResult%
 %CompletionTime%

By default, Veeam Agent for Microsoft Windows sends email notifications

with the following subject: [%JobResult%] %ComputerName% -
%CompletionTime%.

Conditions Parent tag that encapsulates information about conditions in which Veeam
Agent for Microsoft Windows sends email notifications.

Failure Parameter describing if Veeam Agent for Microsoft Windows must send an
email notification in case the backup job completes with the Failed status.
Possible values:

 True — email notifications must be sent.

 False — email notifications must not be sent.

Warning Parameter describing if Veeam Agent for Microsoft Windows must send an
email notification in case the backup job completes with the Warning
status. Possible values:

 True — email notifications must be sent.

 False — email notifications must not be sent.

Success Parameter describing if Veeam Agent for Microsoft Windows must send an
email notification in case the backup job completes with the Success
status. Possible values:

 True — email notifications must be sent.

 False — email notifications must not be sent.

26 | Veeam Agent Configurator | Reference | REV 2

Smtp Parent tag that encapsulates information about the SMTP server that
Veeam Agent for Microsoft Windows uses to send email notifications.

Server Full DNS name or IP address of the SMTP server.

Port Port number for communication with the SMTP server.

SecureConnection Parameter specifying if the SMTP server requires authentication. Possible

values:

 True — SMTP server requires authentication. If you set the

SecureConnection parameter to True, you must specify
Credentials parameters.
 False — SMTP server does not require authentication.

Credentials This tag is used only if the SMTP server requires authentication.

Parent tag that encapsulates information about credentials used to

connect to the SMTP server.

Username This parameter is used only if the SMTP server requires authentication.

User name of the account used to connect to the SMTP server. The user
name is specified as a text string encoded in the Base64 format.

Password This parameter is used only if the SMTP server requires authentication.

Password of the account used to connect to the SMTP server. The

password is encrypted. For more information, see Encryption of User
Credentials.

Example
This example runs the Import command and loads the following parameters from the
C:\Veeam\Configuration.xml input XML file:

 Backup over metered connections is enabled.

 Backup activities are throttled when the system is busy.

 Veeam Agent for Microsoft Windows notifications in the Control Panel are disabled.

Veeam.Agent.Configurator.exe -import /f:C:\Veeam\Configuration.xml

The input XML file has the following parameters:

<?xml version="1.0"?>
<Data>
<ApplicationSettings DisableBackupOverMeteredConnection="False"
ThrottleBackupActivity="True" DisableControlPanelNotification="True"/>
</Data>

27 | Veeam Agent Configurator | Reference | REV 2

Job Parameters
Veeam Agent for Microsoft Windows job parameters are grouped into the following sections:

 General information

 Backup scope

 Backup target

 Storage settings

 Retention settings

 Application-aware settings

 Scheduling settings

28 | Veeam Agent Configurator | Reference | REV 2

General Information
This section describes general information of the backup job configuration.

Parent Tag Parameter Description

JobInfo Parent tag that encapsulates job settings parameters.

CryptType Encryption method used to encrypt the user password. For more
information, see Encryption of User Credentials.

CryptID Required only for ProtectedDataCurrentUser and

ProtectedDataLocalMachine encryption methods.

GUID based on which a pair of asymmetric keys is generated (string of 32

characters with 4 dashes, for example: 12345678-1234-1234-1234-
123456789012).

For example:

<?xml version="1.0"?>
<JobInfo CryptType="20">
…
</JobInfo>

29 | Veeam Agent Configurator | Reference | REV 2

Backup Scope
This section describes what data the backup job must process.

Parent Tag Parameter Description

SourceInfo Parent tag that encapsulates information about the backup scope.

EpDiskFilter Parent tag that encapsulates information about the backup mode.

BackupUserFolders This parameter is used only for file-level backup.

Parameter describing if user personal files must be backed up. Possible

values:

 False — user personal files are not backed up.

 True — user personal files are backed up.

BackupSystemState Parameter that enables system state backup. Possible values:

 False — system state data is not backed up.

 True — system state data is backed up.

BackupMode Backup mode. Possible values:

 0 — entire computer backup.

 1 — volume-level backup.
 2 — file-level backup.

Drive This tag is used only for volume-level and file-level backup modes.

Parent tag that encapsulates information about volumes or folders added

to the backup scope.

FilterType This parameter is used only for volume-level and file-level backup modes.

Backup mode. Possible values:

 0 — volume-level backup.
 1 — file-level backup.

VolumeOrPartitionId This parameter is used only for volume-level and file-level backup modes.
MountPoint
Mount point of the backed up volume or volume on which backed up
folders are located. In the value, the volume name is specified, for
example: C:\.

Path This parameter is used only for volume-level and file-level backup modes.

GUID path of the backed up volume or volume on which backed up

folders are located, for example: \\?\Volume{26a37f5a-c4a6-4ae4-
b724-4a36df814334}.

Note: The Path parameter is not available in the output XML file.
However, you can use it in the input XML file.

30 | Veeam Agent Configurator | Reference | REV 2

 Type This parameter is used only for volume-level and file-level backup modes.

Type of backed up volume or volume on which backed up folders are

located. Possible values:

 0 — UEFI system partition.

 1 — System Reserved partition or computer volume.

IncludeFolders This tag is used only for volume-level and file-level backup modes.

Parent tag that encapsulates paths to backed up volumes and folders.

String value This parameter is used only for volume-level and file-level backup modes.

Backed up disks and folders:

 For volume-level backup, a volume name is specified, for

example: C:\.
 For file-level backup, a path to the folder is specified, for
example: C:\Documents.

ExcludeFolders This tag is used only for hybrid file-level backup (backup that includes
computer volumes and folders with files).

Parent tag that encapsulates paths to folders that are excluded from the
backup.

String value This parameter is used only for hybrid file-level backup (backup that
includes computer volumes and folders with files).

Parameter describing folders that are excluded from the backup, for
example: C:\ProgramData.

IncludeMasks This tag is used only for file-level backup.

Parent tag that encapsulates masks of files that are included in the
backup.

String value This parameter is used only for file-level backup.

Mask of files that are included in the backup, for example: *.docx. To
provide several masks, use separate string value parameters.

ExcludeMasks This tag is used only for the file-level backup.

Parent tag that encapsulates masks of files that are excluded from the
backup.

String value This parameter is used only for the file-level backup.

Mask of files that are excluded from the backup, for example: *.avi. To
provide several masks, use separate string value parameters.

31 | Veeam Agent Configurator | Reference | REV 2

Example 1
You want the backup job to back up the D:\ drive. The input XML file must contain the following parameters:

<?xml version="1.0"?>
<JobInfo CryptType="10">
<SourceInfo>
<EpDiskFilter BackupUserFolders="False" BackupSystemState="False" BackupMode="1">
<Drive FilterType="0">
<VolumeOrPartitionId MountPoint="D:\" Type="1"/>
<IncludeFolders>
<String value="D:\"/>
</IncludeFolders>
<ExcludeFolders/>
</Drive>
<IncludeMasks/>
<ExcludeMasks/>
</EpDiskFilter>
</SourceInfo>
...
</JobInfo>

Example 2
You want to back up the C:\Documents folder, user personal files and exclude all TXT files from it. The input
XML file will contain the following parameters:

<?xml version="1.0"?>
<JobInfo CryptType="10">
<SourceInfo>
<EpDiskFilter BackupUserFolders="True" BackupSystemState="False" BackupMode="2">
<Drive FilterType="1">
<VolumeOrPartitionId MountPoint="C:\" Type="1"/>
<IncludeFolders>
<String value="C:\Documents"/>
<String value="C:\Users"/>
</IncludeFolders>
<ExcludeFolders/>
</Drive>
<VolumeOrPartitionId MountPoint="" Type="1" Path="\\?\Volume{422b9636-8907-11e3-
93e7-806e6f6e6963}"/>
<IncludeMasks/>
<ExcludeMasks>
<String value="*.TXT"/>
</ExcludeMasks>
</EpDiskFilter>
</SourceInfo>
...
</JobInfo>

32 | Veeam Agent Configurator | Reference | REV 2

Backup Target
This section describes where backup files must be stored.

 General settings

 Computer disk settings

 Shared folder settings

 Backup repository settings

 Cloud repository settings

General Settings
Parent Tag Parameter Description

TargetInfo Parent tag that encapsulates information about the backup target.

Type Type of backup target. Possible values:

 1 — folder on a computer disk.

 2 — shared folder.
 3 — Veeam backup repository.
 4 — Veeam cloud backup repository.
 5 — Microsoft OneDrive.

NOTE:

Due to the limitations of the Microsoft OneDrive platform you cannot set Microsoft OneDrive as a backup job
target with Veeam Agent Configurator. The Microsoft OneDrive target is available only in the output XML file.
You cannot use it in the input XML file.

Computer Disk Settings

Parent Tag Parameter Description

TargetInfo Parent tag that encapsulates information about the backup target.

DriveName Name of a volume where backup files must be stored, for example: C:\.

VolumeID GUID path of a volume where backup files must be stored, for example:
{26a37f5a-c4a6-4ae4-b724-4a36df814334}.

Note: The VolumeID parameter is not available in the output XML file.
However, you can use it in the input XML file.

RelativePath Path to a folder where backup files must be stored, for example: Backup\

33 | Veeam Agent Configurator | Reference | REV 2

Shared Folder Settings
Parent Tag Parameter Description

TargetInfo Parent tag that encapsulates information about the backup target.

Path Path to a shared folder where backups must be stored, for example:
\\172.17.25.73\Backups.

CredentialsInfo This tag is used only if you plan to store backup files in a shared folder
that requires user authentication.

Parent tag that encapsulates information about credentials for access to

the shared folder.

UserName This parameter is used only if you plan to store backup files in a shared
folder that requires user authentication.

User name for access to the shared folder. The user name is specified as a
text string encoded in the Base64 format.

Password This parameter is used only if you plan to store backup files in a shared
folder that requires user authentication.

Password for access to the shared folder. The password is encrypted. For
more information, see Encryption of User Credentials.

Backup Repository Settings

Parent Tag Parameter Description

TargetInfo Parent tag that encapsulates information about the backup target.

ServerName Name of the backup server that manages the target Veeam backup
repository.

ServerPort Port used for communication between the machine on which Veeam Agent
for Microsoft Windows is installed and Veeam backup server. By default,
port 10001 is used.

RemoteRepositoryId GUID path of the cloud backup repository where backup files are stored,
for example: {88788f9e-d8f5-4eb4-bc4f-9b3f5403bcec}.

Note: The RemoteRepositoryID parameter is not available in the

output XML file. However, you can use it in the input XML file.

RemoteRepository Name of the backup repository, for example: Backup Volume 01.
Name

ServerCredentials This tag is used only if you plan to store backup files on a Veeam backup
repository that requires user authentication.

Parent tag that encapsulates information about credentials for access to

the Veeam backup repository.

34 | Veeam Agent Configurator | Reference | REV 2

 UserName This parameter is used only if you plan to store backup files on a Veeam
backup repository that requires user authentication.

User name for access to the Veeam backup repository. The user name is
specified as a text string encoded in the Base64 format.

Password This parameter is used only if you plan to store backup files on a Veeam
backup server that requires user authentication.

Password for access to the Veeam backup repository. The password is

encrypted. For more information, see Encryption of User Credentials.

Cloud Repository Settings

Parent Tag Parameter Description

TargetInfo Parent tag that encapsulates information about the backup target.

ServerName Full DNS name or IP address of the default cloud gateway over which
backup data is transported to the cloud backup repository.

Beside the default gateway, you can specify a list of additional cloud
gateways in the GateList parameter. Veeam Agent for Microsoft
Windows uses additional cloud gateways if the default cloud gateway is
inaccessible.

ServerPort TCP/IP port over which user backup servers must communicate with the
cloud gateway. By default, port 6180 is used.

GateList List of additional cloud gateway servers and ports over which backup data
is transported to the cloud backup repository. Veeam Agent for Microsoft
Windows uses additional cloud gateways if the default cloud gateway is
inaccessible.

Information about additional cloud gateways is specified following format:

Gateway:Port. Additional cloud gateways are listed in the priority order,
entries in the list are separated with a semicolon followed by a space, for
example: GateList=" 14.137.17.51:6180;
14.137.17.52:6180".

RemoteRepository Name of a cloud backup repository on which backups are stored.

Name

RemoteRepositoryId GUID path of the cloud backup repository where backup files must be
stored, for example: {fcaaef5e-6f9d-4311-96f0-8005518df1b8}.

Note: The RemoteRepositoryID parameter is not available in the

output XML file. However, you can use it in the input XML file.

TrustedThumbprint Thumbprint of the TLS certificate used to secure communication in the

Veeam Cloud Connect infrastructure.

The TrustedThumbprint parameter is optional, and is used for TLS

certificate verification.

35 | Veeam Agent Configurator | Reference | REV 2

ServerCredentials Parent tag that encapsulates information about credentials for access to
the cloud backup repository.

UserName User name for access to the cloud backup repository. The user name is
specified as a text string encoded in the Base64 format.

Password Password for access to the cloud backup repository. The password is
encrypted. For more information, see Encryption of User Credentials.

Example 1
You want to back up data to the Backups folder on the D:\ drive on the computer. The input XML file will
contain the following parameters:

<?xml version="1.0"?>
<JobInfo CryptType="10">
<TargetInfo Type="1" RelativePath="Backups\" DriveName="D:\"/>
</JobInfo>

Example 2
You want to back up data to the \\fileserver01\Backups shared folder. The shared folder requires
authentication, and you use the following user account to access it:

 Username: TECH\Administrator

 Password: Password

The input XML file will contain the following parameters:

<?xml version="1.0"?>
<JobInfo CryptType="10">
<TargetInfo Type="2" Path="\\fileserver01\Backups">
<CredentialsInfo UserName="VEVDSFxBZG1pbmlzdHJhdG9y" Password="UGFzc3dvcmQ="/>
</TargetInfo>
</JobInfo>

Example 3
You want to back up data to the BackupVolume01 backup repository configured on the
backup01.tech.local backup server. You use the following credentials to access the backup server:

 Username: TECH\Administrator

 Password: Password

36 | Veeam Agent Configurator | Reference | REV 2

The input XML file will contain the following parameters:

<?xml version="1.0"?>
<JobInfo CryptType="10">
<TargetInfo Type="3" RemoteRepositoryName="BackupVolume01" ServerPort="10001"
ServerName="backup01.tech.local">
<ServerCredentials Password="UGFzc3dvcmQ="
UserName="VEVDSFxBZG1pbmlzdHJhdG9y"/>
</TargetInfo>
</JobInfo>

Example 4
You want to back up data to the Cloud01 backup repository accessed over the following gateway servers:

 14.137.17.50 (default gateway server)

 14.137.17.51 (additional gateway server)

 14.137.17.52 (additional gateway server)

The input XML file will contain the following parameters:

<?xml version="1.0" ?>

<JobInfo CryptType="10">
<targetinfo type="4" GateList="14.137.17.51:6180; 14.137.17.52:6180"
RemoteRepositoryName="Cloud01" ServerPort="6180" ServerName="14.137.17.50" />
<servercredentials UserName="ABC" Password="XHg2MVx4NjJceDYz" />
</JobInfo>

37 | Veeam Agent Configurator | Reference | REV 2

Storage Settings
This section describes settings for backup files stored on the backup target.

Parent Tag Parameter Description

StorageInfo Parent tag encapsulating information about storage settings.

BlockSize Size of data blocks that Veeam Agent for Microsoft Windows uses to
process data. Possible values:

 0 — Veeam Agent for Microsoft Windows uses data block size

of 256 KB. This block size is recommended if you plan to back
up data offsite over WAN.
 1 — Veeam Agent for Microsoft Windows uses data block size
of 512 KB. This block size is recommended for onsite backup
to NAS over 1 GB Ethernet.
 3 — Veeam Agent for Microsoft Windows uses data block size
of 1024 KB. This block size is recommended for backup to
SAN, DAS or local storage.
 5 — Veeam Agent for Microsoft Windows uses data block size
of 4 MB. This block size is recommended for backup files over
16 TB.

CompressionLevel Compression level for the resulting backup file. Possible values:

 0 — compression is disabled.
 4 — dedupe-friendly compression. Recommended for
deduplicating storage appliances and external WAN
accelerators.
 5 — optimal compression. Provides the best compression to
performance ratio and lowest CPU usage.
 6 — high compression. Provides additional 10% compression
ratio over optimal, at the cost of 10x higher CPU usage.
 9 — extreme compression. Provides additional 3%
compression ratio over high, at the cost of 2x higher CPU
usage.

Encryption Parent tag that encapsulates information about backup encryption

settings.

Enabled Parameter specifying if Veeam Agent for Microsoft Windows must encrypt
the resulting backup file. Possible values:

 True — backup is encrypted.

 False — backup is not encrypted.

Key This tag is used if you select to encrypt the resulting backup file.

Parent tag that encapsulates information about the encryption password

and hint.

Password This parameter is used if you select to encrypt the resulting backup file.

Password that is used to encrypt the resulting backup file. The password
must be encoded in the Base64 format.

38 | Veeam Agent Configurator | Reference | REV 2

 Hint This parameter is used if you select to encrypt the resulting backup file.

Hint for the password used to encrypt the resulting backup file. The hint
must be encoded in the Base64 format.

Important! The Hint parameter is required.

Example
You want to use dedupe-friendly compression, and encrypt the resulting backup file with the following password:

 Password: Password

 Hint: Standard password

The input XML file will contain the following parameters:

<?xml version="1.0"?>
<JobInfo CryptType="10">
<StorageInfo BlockSize="3" CompressionLevel="4">
<Encryption Enabled="True">
<Key Password="UGFzc3dvcmQ=" Hint="U3RhbmRhcmQgcGFzc3dvcmQ="/>
</Encryption>
</StorageInfo>
</JobInfo>

39 | Veeam Agent Configurator | Reference | REV 2

Retention Settings
This section describes retention settings for backup files stored on the backup target.

Parent Tag Parameter Description

RetentionInfo Parent tag that encapsulates information about retention policy settings.

RestorePointsCount Number of restore points that is maintained by the backup job.

 For Free/Workstation edition, the RestorePointsCount

parameter defines the number of days on which the
backup job is run.
 For Server edition, the RestorePointsCount parameter
defines the number of restore points maintaned in the backup
chain.

Example
You use the Server edition and want to keep 20 restore points in the backup chain on the backup target. The
input XML file will contain the following parameters:

<?xml version="1.0"?>
<JobInfo CryptType="10">
<RetentionInfo RestorePointsCount="20"/>
</JobInfo>

40 | Veeam Agent Configurator | Reference | REV 2

Cache Settings
This section describes settings for local backup cache.

Parent Tag Parameter Description

CacheInfo Parent tag that encapsulates information about local backup cache
settings.

Enabled Parameter specifying if local backup cache is used. Possible values:

 True — local backup cache is used.

 False — local backup cache is not used.

SizeGB This parameter is used only if you plan to use local backup cache.

Size of local backup cache specified in GB. If the size of local backup
cache is 1024-fold, Veeam Agent for Microsoft Windows automatically
converts the value to TB.

StopJobsIfNeeded This tag is used only if you plan to use local backup cache.

If you need to update settings for the backup job for which local backup
cache settings are already configured, you must first disable the backup
job. To do this, you can use StopJobsIfNeeded parameter. With this
parameter set to True, Veeam Agent Configurator disables the backup
job, updates the job settings and re-enables the job after that.

Possible values:

 True — backup job is disabled before backup job settings are

updated, and re-enabled after the backup job settings are
updated.

 False — backup job is not disabled before backup job settings

are updated.

Location This tag is used only if you plan to use local backup cache.

Parent tag that encapsulates information about local backup cache

location.

Type This parameter is used only if you plan to use local backup cache.

Type of storage for local backup cache. Possible values:

 1 — folder on the local computer disk.

DriveName This parameter is used only if you plan to use local backup cache.

Name of a volume where local backup cache must be stored, for example:
D:\.

41 | Veeam Agent Configurator | Reference | REV 2

 VolumeID This parameter is used only if you plan to use local backup cache.

GUID path of a volume where local backup cache must be stores, for
example: {26a37f5a-c4a6-4ae4-b724-4a36df814334}.

Note: The VolumeID parameter is not available in the output XML file.
However, you can use it in the input XML file.

RelativePath This parameter is used only if you plan to use local backup cache.

Path to a folder where local backup cache must be stored, for example:
Cache\

Example
You want store local backup cache in the D:\Cache folder, and the cache size is 10 GB.

The input XML file will contain the following parameters:

<JobInfo>
<CacheInfo Enabled="True" SizeGB="10">
<Location Type="1" RelativePath="Cache" DriveName="D:\"/>
</CacheInfo>
</JobInfo>

42 | Veeam Agent Configurator | Reference | REV 2

Application-Aware Settings (Server Mode)
This section describes application-aware settings of the backup job.

 General settings

 Microsoft SQL Server settings

 Oracle settings

 Microsoft SharePoint settings

 Custom script settings

 File indexing settings

General Settings
Parent Tag Parameter Description

Applications Parent tag that encapsulates information about application-aware

settings.

Enabled Parameter describing if application-aware processing is enabled. Possible

values:

 True — application-aware processing is enabled.

 False — application-aware processing is not enabled.

ProcessTransaction Parameter describing how transaction logs must be processed. Possible

Logs values:

 True — transaction logs are processed with the Veeam Agent

for Microsoft Windows backup job.
 False — transaction logs are processed with a third-party tool.
Veeam Agent for Microsoft Windows performs copy-only
backup.

43 | Veeam Agent Configurator | Reference | REV 2

Microsoft SQL Server Settings
Parent Tag Parameter Description

Sql Parent tag that encapsulates information about transaction logs settings
for Microsoft SQL Server.

Mode Parameter describing how Veeam Agent for Microsoft Windows processes
transaction logs for Microsoft SQL Server. Possible values:

 0 — Veeam Agent for Microsoft Windows does not truncate

transaction logs.
 1 — Veeam Agent for Microsoft Windows truncates
transaction logs.
 3 — Veeam Agent for Microsoft Windows periodically backs up
transaction logs. During the job session, Veeam Agent for
Microsoft Windows also truncates transaction logs.

Note: If you do not specify the Mode parameter but set the Enabled
parameter in the Backup tag to True, transaction log backup will be
enabled.

Backup This tag is used only if you set the Mode parameter to 3 (Veeam Agent for
Microsoft Windows periodically backs up transaction logs).

Parent tag encapsulating information about transaction logs backup

settings for Microsoft SQL Server.

Enabled This parameter is used only if you set the Mode parameter to 3 (Veeam
Agent for Microsoft Windows periodically backs up transaction logs).

Parameter specifying if Veeam Agent for Microsoft Windows must back up

transaction logs. Possible values:

 True — Veeam Agent for Microsoft Windows backs up

transaction logs.
 False — Veeam Agent for Microsoft Windows does not back
up transaction logs.

Note: If you do not specify the Enabled parameter but set the Mode
parameter to 3, transaction log backup will be enabled.

BackupMinutes This parameter is used only if you set the Mode parameter to 3 (Veeam
Agent for Microsoft Windows periodically backs up transaction logs).

Periodicity with which Veeam Agent for Microsoft Windows must back up
transaction logs (in minutes). By default, Veeam Agent for Microsoft
Windows backs up transaction logs every 15 minutes.

44 | Veeam Agent Configurator | Reference | REV 2

 Expirable This parameter is used only if you set the Mode parameter to 3 (Veeam
Agent for Microsoft Windows periodically backs up transaction logs).

Retention policy settings for backed up transaction logs. Possible values:

 True — transaction log backups are removed from the backup

target after N days. Together with this parameter, you must
specify retention policy settings in the ExpireDays
parameter.
 False — transaction log backups are removed from the
backup target together with the parent backup (when the
parent backup becomes outdated and is removed from the
primary backup chain).

ExpireDays This parameter is used only if you set the Mode parameter to 3 (Veeam
Agent for Microsoft Windows periodically backs up transaction logs) and
set the Expirable parameter to True (delete transaction log backups
after N days).

Retention policy settings for transaction log backups (in days). By default,
Veeam Agent for Microsoft Windows removes from the backup target
transaction log backups that are older than 15 days.

Credentials This tag is used only if you want to use impersonation and connect to the
Microsoft SQL Server under the database administrator account.

Parent tag that encapsulates information about credentials of a database

administrator account.

UserName This parameter is used only if you want to use impersonation and connect
to the Microsoft SQL Server under the database administrator account.

User name of the database administrator account. The user name is

specified as a text string encoded in the Base64 format.

Password This parameter is used only if you want to use impersonation and connect
to the Microsoft SQL Server under the database administrator account.

Password of the database administrator account. The password is

encrypted. For more information, see Encryption of User Credentials.

Oracle Settings
Parent Tag Parameter Description

Oracle Parent tag that encapsulates information about transaction logs settings
for Oracle.

45 | Veeam Agent Configurator | Reference | REV 2

 Mode Parameter describing how Veeam Agent for Microsoft Windows processes
transaction logs for Oracle. Possible values:

 0 — Veeam Agent for Microsoft Windows does not truncate

transaction logs.
 1 — Veeam Agent for Microsoft Windows truncates
transaction logs that are older than N hours. If you set the
Mode parameter to 1, you must specify the LifetimeHours
parameter.
 2 — Veeam Agent for Microsoft Windows truncates
transaction logs whose size is over N GB. If you set the Mode
parameter to 2, you must specify the SizeGB parameter.

AccountType This parameter is used only if you want Veeam Agent for Microsoft
Windows to connect to an Oracle database under a specific account.

Type of account you want to use. Possible values:

 0 — Oracle account
 1 — Microsoft Windows account

Together with the AccountType parameter, you must specify UserName

and Password parameters in the Credentials tag.

LifetimeHours This parameter is used if you set the Oracle parameter to 1 (Veeam
Agent for Microsoft Windows truncates transaction logs that are older
than N hour).

Age of transaction logs that must be truncated (in hours). By default,

Veeam Agent for Microsoft Windows truncates transaction logs that are
older than 24 hours.

SizeGB This parameter is used if you set the Oracle parameter to 2 (Veeam
Agent for Microsoft Windows truncates transaction logs whose size is over
N GB).

Size of transaction logs that must be truncated (in GB). By default, Veeam
Agent for Microsoft Windows truncates transaction logs whose size is over
10 GB.

Backup Parent tag that encapsulates information about transaction logs backup
settings for Oracle.

Enabled Parameter specifying if Veeam Agent for Microsoft Windows must back up
transaction logs. Possible values:

 True — Veeam Agent for Microsoft Windows backs up

transaction logs.
 False — Veeam Agent for Microsoft Windows does not back
up transaction logs.

BackupMinutes Periodicity with which Veeam Agent for Microsoft Windows must back up
transaction logs (in minutes). By default, Veeam Agent for Microsoft
Windows backs up transaction logs every 15 minutes.

46 | Veeam Agent Configurator | Reference | REV 2

 Expirable Retention policy settings for backed up transaction logs. Possible values:

 True — transaction log backups are removed from the backup

target after N days. Together with this parameter, you must
specify retention policy settings in the ExpireDays
parameter.
 False — transaction log backups are removed from the
backup target together with the parent backup (when the
parent backup becomes outdated and is removed from the
primary backup chain).

ExpireDays This parameter is used only if you set the Expirable parameter to True
(delete transaction log backups after N days).

Retention policy settings for transaction log backups (in days). By default,
Veeam Agent for Microsoft Windows removes transaction log backups that
are older than 15 days from the backup target.

Credentials This tag is used only if you want Veeam Agent for Microsoft Windows to
connect to an Oracle database under a specific account.

Parent tag that encapsulates information about credentials of the account

used to connect to the Oracle database.

UserName This parameter is used only if you want Veeam Agent for Microsoft
Windows to connect to an Oracle database under a specific account.

User name of the account under which Veeam Agent for Microsoft
Windows must connect to the Oracle database. The user name is
specified as a text string encoded in the Base64 format.

Password This parameter is used only if you want Veeam Agent for Microsoft
Windows to connect to an Oracle database under a specific account.

Password of the account under which Veeam Agent for Microsoft Windows
must connect to the Oracle database. The password is encrypted. For
more information, see Encryption of User Credentials.

Microsoft SharePoint Settings

Parent Tag Parameter Description

SharePoint Parent tag that encapsulates information about settings for Microsoft
SharePoint Server.

Credentials Parent tag that encapsulates information about credentials of the account
used to connect to Microsoft SharePoint Server.

UserName User name of the account used to connect to Microsoft SharePoint Server.
The user name is specified as a text string encoded in the Base64 format.

Password Password of the account used to connect to Microsoft SharePoint Server.

The password is encrypted. For more information, see Encryption of User
Credentials.

47 | Veeam Agent Configurator | Reference | REV 2

Custom Script Settings
Parent Tag Parameter Description

Script Parent tag that encapsulates information about custom script settings.

Mode Parameter describing if Veeam Agent for Microsoft Windows must run
custom scripts and how it must process script execution results. Possible
values:

 0 — script execution is disabled.

 1 — Veeam Agent for Microsoft Windows runs scripts and
ignores script failures.
 2 — Veeam Agent for Microsoft Windows requires that scripts
are executed successfully.

If you set the Mode parameter to 1 or 2, you must specify the

PreFreezePath and/or PostThawPath parameters.

PreFreezePath This parameter is used if you set the Mode parameter to 1 or 2 (run a
pre-freeze script).

Path to a pre-freeze script, for example: C:\scripts\pre-

freeze.cmd.

PostThawPath This parameter is used if you set the Mode parameter to 1 or 2 (run a
post-thaw script).

Path to a post-thaw script, for example: C:\scripts\pre-

freeze.cmd.

Credentials This tag is used only if you need to run custom scripts under a specific
account, for example, an account that has Administrator permissions.

Parent tag that encapsulates information about credentials of the account

used to run custom scripts.

UserName This parameter is used only if you need to run custom scripts under a
specific account.

User name of the account under which custom scripts must be run. The
user name is specified as a text string encoded in the Base64 format.

Password This parameter is used only if you need to run custom scripts under a
specific account.

Password of the account under which custom scripts must be run. The
password is encrypted. For more information, see Encryption of User
Credentials.

48 | Veeam Agent Configurator | Reference | REV 2

File Indexing
Parent Tag Parameter Description

Indexing Parent tag that encapsulates information about file indexing settings.

Type Indexing mode. Possible values:

 1 — Veeam Agent for Microsoft Windows indexes all files and

folders included in the backup scope.
 2 — Veeam Agent for Microsoft Windows indexes the content
of folders included in the indexing scope.
 3 — Veeam Agent for Microsoft Windows does not index the
content of folders excluded from the indexing scope.

Enabled Parameter specifying if Veeam Agent for Microsoft Windows must index
files and folders. Possible values:

 True — Veeam Agent for Microsoft Windows indexes files and

folders.
 False — Veeam Agent for Microsoft Windows does not index
files and folders.

IncludedFolders This tag is used only if the Indexing parameter is set to 1 (Veeam Agent
for Microsoft Windows indexes the content of folders included in the
indexing scope).

Parent tag that encapsulates information about folders included in the

indexing scope.

String value This parameter is used only if the Indexing parameter is set to 1
(Veeam Agent for Microsoft Windows indexes the content of folders
included in the indexing scope).

Paths to folders whose content must be indexed, for example,

C:\Documents.

ExcludedFolders This tag is used only if the Indexing parameter is set to 2 (Veeam Agent
for Microsoft Windows does not index the content of folders excluded
from the indexing scope).

Parent tag that encapsulates information about folders excluded from the
indexing scope.

String value This parameter is used only if the Indexing parameter is set to 2
(Veeam Agent for Microsoft Windows does not index the content of
folders excluded from the indexing scope).

Paths to folders whose content must not be indexed, for example,

%TEMP%, %ProgramFiles%. You can use system environmental variables
in this parameter.

49 | Veeam Agent Configurator | Reference | REV 2

Example 1
You want the backup job to back up Microsoft SQL Server transaction logs every 15 minutes and retain
transaction log backups in the backup target for 20 days. The input XML file will contain the following
parameters:

<?xml version="1.0"?>
<JobInfo CryptType="10">
<GuestInfo>
<Applications ProcessTransactionLogs="True">
<Sql Mode="3">
<Backup Enabled="True" ExpireDays="20" BackupMinutes="15" Expirable="True"/>
</Sql>
</GuestInfo>
</JobInfo>

Example 2
You want the backup job to index files in Documents 2015 and Documents 2016 folders. The input XML file
will contain the following parameters:

<?xml version="1.0"?>
<JobInfo CryptType="10">
<GuestInfo>
<Indexing Type="2">
<IncludedFolders>
<String value="D:\Folder1"/>
<String value="D:\Folder2"/>
</IncludedFolders>
</Indexing>
</GuestInfo>
</JobInfo>

Example 3
You want the backup job to run pre-freeze.cmd and post-thaw.cmd scripts, and want to ignore script
errors. The input XML file will contain the following parameters:

<?xml version="1.0"?>
<JobInfo CryptType="10">
<GuestInfo>
<Applications ProcessTransactionLogs="True" Enabled="True">
<Script Mode="1" PostThawPath="C:\scripts\post-thaw.cmd"
PreFreezePath="C:\scripts\pre-freeze.cmd"/>
</Applications>
</GuestInfo>
</JobInfo>

50 | Veeam Agent Configurator | Reference | REV 2

Scheduling Settings
This section describes scheduling settings of the backup job.

 Desktop scheduling settings

 Server scheduling settings

Desktop Scheduling Settings

This section describes desktop scheduling settings of the backup job.

Parent Tag Parameter Description

ScheduleInfo Parent tag that encapsulates information about scheduling settings.

CompletionMode Action that is performed when the backup job is complete. Possible
values:

 0 — computer remains running.

 1 — machine is brought to the Hibernate mode. This option
can be used if the Hibernate mode is enabled on the
machine. If the Hibernate mode is disabled, Veeam Agent
Configurator will set the CompletionMode value to 0 (Keep
running).
 2 — machine is brought to the Standby mode.
 3 — machine is shut down.

AtStorageAttach Parameter describing if the backup job must start when the backup
target is connected to the computer — external target disk is attached,
shared folder becomes accessible and so on. Possible values:

 True — backup job is started at storage attach.

 False — backup job is not started at storage attach.

ResumeMissedBackup Parameter describing what actions Veeam Agent for Microsoft Windows
must perform if the machine was powered off when backup was
scheduled, and the backup was missed. Possible values:

 True — Veeam Agent for Microsoft Windows must run the

backup job when the computer is powered on.
 False — Veeam Agent for Microsoft Windows must not run
the backup job when the computer is powered on.

AtLock Parameter describing if the backup job must start when the user locks
the computer. Possible values:

 True — backup job starts when the user locks the computer.
 False — backup job does not start when the user locks the
computer.

51 | Veeam Agent Configurator | Reference | REV 2

 AtLogOff Parameter describing if the backup job must start when the user
performs the logoff operation. Possible values:

 True — backup job starts when the user logs off the
computer.
 False — backup job does not start when the user logs off
the computer.

EjectRemovableStorage Parameter describing if Veeam Agent for Microsoft Windows must eject
OnceBackup the removable storage (backup target) when the backup job session
IsCompleted completes. Possible values:

 True — Veeam Agent for Microsoft Windows ejects the

removable storage.
 False — Veeam Agent for Microsoft Windows does not eject
the removable storage.

Important! You must explicitly define a value in the

EjectRemovableStorage
OnceBackupIsCompleted parameter. If you do not specify it
explicitly, Veeam Agent Configurator will set the parameter value to
False (even if the Eject removable storage once backup is
completed option is enabled for the job in the UI).

LimitBackupsFrequency Parameter limiting the frequency of backup job sessions in the specified
interval. Possible values:

 True — frequency of backup job sessions is limited.

 False — frequency of backup job sessions is not limited.

MaxBackupsFrequency This parameter is used only if you have selected to limit the frequency
of backup job sessions.

Time interval (in minutes, hours or days) during which a new backup job
session must not be started, for example, 30.

FrequencyTimeUnit This parameter is used only if you have selected to limit the frequency
of backup job sessions.

Units of time for the time interval limiting the frequency of backup job
sessions.

Possible values:

 0 — minutes
 1 — hours
 2 — days

DailyInfo Parent tag that encapsulates information about daily scheduling settings.

Kind Days of week on which the backup job must run. Possible values:

 0 — backup job runs every day.

 1 — backup job runs on week days (all days of the week
except Saturday and Sunday).
 2 — backup job runs on specific days. If you set the Kind
parameter to 2, you must list days on which you want to run
the backup job in the Days parameter.

52 | Veeam Agent Configurator | Reference | REV 2

 Days This parameter is used only if you set the Kind parameter to 2.

List of days on which you want to run the backup job. Possible values:

 Sunday
 Monday
 Tuesday
 Wednesday
 Thursday
 Friday
 Saturday

Entries in the list are separated with a comma followed by a space (, ),

for example: Days="Sunday, Monday, Tuesday, Wednesday,
Thursday, Friday, Saturday".

Time Time at which the backup job must start. The time is specified in the
following format: mm/dd/yyyy hh:mm:ss.

Note: Veeam Agent Configurator ignores the date part and uses the
time part only.

Example
You want to enable backup on the following events: user logout and computer lock. The input XML file will
contain the following parameters:

<?xml version="1.0"?>
<JobInfo CryptType="10">
<ScheduleInfo AtLock="True" AtLogOff="True"/>
</JobInfo>

Server Scheduling Settings

This section describes server scheduling settings of the backup job.

 General settings

 Daily scheduling settings

 Monthly scheduling settings

 Periodical scheduling settings

 Continuous scheduling settings

 Synthetic full backup settings

 Active full backup settings

 Job retry settings

 Backup window settings

53 | Veeam Agent Configurator | Reference | REV 2

General Settings
Parent Tag Parameter Description

ScheduleInfo Parent tag that encapsulates information about scheduling settings.

RunManually Parameter specifying if the backup job must be run manually or started
automatically by schedule. Possible values:

 True — backup job schedule is enabled.

 False — backup job schedule is disabled. The job must be
started manually.

Type Type of job schedule. Possible values:

 1 — backup job runs on specific days. If you set the Type

parameter value to 1, you must specify daily scheduling
settings.
 2 — backup job runs on a specific day every month. If you set
the Type parameter value to 2, you must specify monthly
scheduling settings.
 3 — backup job is started with some periodicity. If you set the
Type parameter value to 3, you must specify periodical
scheduling settings.
 4 — backup job is run continuously. If you set the Type
parameter value to 4, you must specify continuous scheduling
settings.

UseBackupWindow Parameter describing if the backup window is set for the backup job.
Possible values:

 True — backup window is enabled.

 False — backup window is disabled.

If you set this parameter to True, you must specify backup window
settings.

Daily Scheduling Settings

Parent Tag Parameter Description

DailyInfo Parent tag that encapsulates information about daily scheduling settings.

Kind Days of week on which the backup job must run. Possible values:

 0 — backup job runs every day.

 1 — backup job runs on week days (all days of the week
except Saturday and Sunday).
 2 — backup job runs on specific days. If you set the Kind
parameter value to 2, you must list days on which you want
to run the backup job in the Days parameter.

54 | Veeam Agent Configurator | Reference | REV 2

 Days This parameter is used only if you set the Kind parameter value to 2.

List of days on which you want to run the backup job. Possible values:

 Sunday
 Monday
 Tuesday
 Wednesday
 Thursday
 Friday
 Saturday

Entries in the list are separated with a comma followed by a space (, ), for
example: Days="Sunday, Monday, Tuesday, Wednesday,
Thursday, Friday, Saturday".

Time Time at which the backup job must start. The time is specified in the
following format: hh:mm.

Monthly Scheduling Settings

Parent Tag Parameter Description

MonthlyInfo Parent tag that encapsulates information about monthly scheduling

settings.

Months List of months on which the backup job must run. Possible values:

 January
 February
 March
 April
 May
 June
 July
 August
 September
 October
 November
 December

Entries in the list are separated with a comma, for example:

Months="January, February, March, April, May, June,
July, August, September, October, November, December".

55 | Veeam Agent Configurator | Reference | REV 2

 DayOfWeek This parameter is used if you want to run the backup job on the Nth day
of the Nth week in the month.

Day on which the backup job must run. Possible values:

 0 — Sunday
 1 — Monday
 2 — Tuesday
 3 — Wednesday
 4 — Thursday
 5 — Friday
 6 — Saturday

Week This parameter is used if you want to run the backup job on the Nth day
of the Nth week in the month.

Numerical order of the week on which you want to run the backup job.
Possible values:

 1 — first week of month

 2 — second week of month
 3 — third week of month
 4 — fourth week of month
 5 — last week of month
 6 — backup job runs on a specific date within a month.

If you set the Week parameter value to 6, you must also specify the
DayOfMonth parameter value.

DayOfMonth This parameter is used if you want to run the backup job on a specific
date.

Date in a month on which you want to run the backup job. Possible
values: 1-30 (or 1-31, depending on the month length). For example, if
you want to run the backup job on the 24th of every month, you must set
the DayOfMonth parameter to 24.

Time Time at which the backup job must start. The time is specified in the
following format: hh:mm.

Periodical Scheduling Settings

Parent Tag Parameter Description

PeriodicallyInfo Parent tag that encapsulates information about periodical scheduling

settings.

Time Periodicity with which the backup job must start. The time interval for
periodicity is specified in the following format: hhh:mm.

For example, if you want to run the backup job every 30 minutes, you
must set the Time parameter to 000:30. If you want to run the backup
job every 2 hours, you must set the Time parameter to 002:00. If you
want to run the backup job every 5 days, you must set the Time
parameter to 120:00.

56 | Veeam Agent Configurator | Reference | REV 2

 Schedule Parent tag that encapsulates information about periodic job schedule.

Minutes Exact time within an hour when the backup job must start.

For example, if you want to run the backup job every hour and start on
the 30th minute of the hour, for example, at 1:30 AM, 2:30 AM, 3:30 AM,
4:30 AM and so on, you must set the Time parameter to 001:00 and
Minutes parameter to 30.

Kind This parameter is used if you specify permitted or prohibited hours for the
backup job.

Method of setting permitted hours for the backup job. Possible values:

 0 — permitted hours for the backup job are specified.

 1 — prohibited hours for the backup job are specified.

Days This tag is used if you specify permitted or prohibited hours for the
backup job.

Parent tag that encapsulates information about permitted or prohibited

hours for the backup job.

<Weekday> Intervals This tag is used if you specify permitted or prohibited hours for the
backup job.

Intervals of permitted or prohibited hours for the backup job. Intervals of

hours are specified for every week day in the following format:

<<Weekday> Intervals="10-12, 22-24"/>.

You can specify several intervals separated with a comma followed by a

space (, ). For example:

<Days>

<Monday Intervals="06-08, 18-20"/>

<Tuesday Intervals="06-08, 18-20, 22-24"/>

</Days>

Note: If there are more prohibited hours intervals than permitted hours
intervals, Veeam Agent Configurator will export information about
prohibited hours when you run the SaveConfiguration command, and
vice versa.

Continuous Scheduling Settings

Parent Tag Parameter Description

ContinuouslyInfo Parent tag that encapsulates information about continuous scheduling

settings.

Schedule This tag is used if you specify permitted or prohibited hours for the
backup job.

Parent tag that encapsulates information about permitted and prohibited

hours set for the backup job.

57 | Veeam Agent Configurator | Reference | REV 2

 Kind This parameter is used if you specify permitted and prohibited hours set
for the backup job.

Method of setting permitted hours for the backup job. Possible values:

 0 — permitted hours for the backup job are specified.

 1 — prohibited hours for the backup job are specified.

Days This tag is used if you specify permitted or prohibited hours for the
backup job.

Parent tag that encapsulates information about permitted or prohibited

hours for the backup job.

<Weekday> Intervals This tag is used if you specify permitted or prohibited hours for the
backup job.

Intervals of permitted or prohibited hours for the backup job. The interval
of hours is specified for every week day in the following format:

<<Weekday> Intervals="10-12, 22-24"/>.

You can specify several intervals separated with a comma followed by a

space (, ). For example:

<Days>

<Monday Intervals="06-08, 18-20"/>

<Tuesday Intervals="06-08, 18-20, 22-24"/>

</Days>

Note: If there are more prohibited hours intervals than permitted hours
intervals, Veeam Agent Configurator will export information about
prohibited hours when you run the SaveConfiguration command, and
vice versa.

Synthetic Full Backup Settings

Parent Tag Parameter Description

SyntheticFull Parent tag that encapsulates information about synthetic full backups
created with the backup job.

Enabled Parameter specifying if the backup job must periodically create synthetic
full backups. Possible values:

 True — backup job creates synthetic full backups.

 False — backup job does not create synthetic full backups.

58 | Veeam Agent Configurator | Reference | REV 2

 Days List of days on which the backup job must create synthetic full backups.
Possible values:

 Sunday
 Monday
 Tuesday
 Wednesday
 Thursday
 Friday
 Saturday

Entries in the list are separated with a comma followed by a space (, ), for
example: Days="Sunday, Monday, Tuesday, Wednesday,
Thursday, Friday, Saturday".

Active Full Backup Settings

Parent Tag Parameter Description

ActiveFull Parent tag that encapsulates information about active full backups created
with the backup job.

Enabled Parameter specifying if the backup job must periodically create active full
backups. Possible values:

 True — backup job creates active full backups.

 False — backup job does not create active full backups.

Kind Mode in which the backup job creates active full backups. Possible values:

 0 — backup job creates active full backups on specific days of

week. If you set the Kind parameter to 0, you must specify
the Days parameter.
 1 — backup job creates active full backups on a specific day
every month. If you set the Kind parameter to 1, you must
specify Months, DayofWeek and Week parameters.

DailyInfo This parameter is used if you want to create active full backups on specific
days of week.

Parent tag that encapsulates information about daily settings for active
full backups.

59 | Veeam Agent Configurator | Reference | REV 2

 Days This parameter is used if you want to create active full backups on specific
days of week.

List of days on which the backup job must create active full backups.
Possible values:

 Sunday
 Monday
 Tuesday
 Wednesday
 Thursday
 Friday
 Saturday

Entries in the list are separated with a comma followed by a space (, ), for
example: Days="Sunday, Monday, Tuesday, Wednesday,
Thursday, Friday, Saturday".

MonthlyInfo This parameter is used if you want to create active full backups on a
specific day every month.

Parent tag that encapsulates information about monthly settings for active
full backups.

Months This parameter is used if you want to create active full backups on a
specific day every month.

List of months on which the backup job must create active full backups.
Possible values:

 January
 February
 March
 April
 May
 June
 July
 August
 September
 October
 November
 December

Entries in the list are separated with a comma followed by a space (, ), for
example: Months="January, February, March, April, May,
June, July, August, September, October, November,
December".

60 | Veeam Agent Configurator | Reference | REV 2

 DayOfWeek This parameter is used if you want to create active full backups on a
specific day every month.

Day on which the backup job must create an active full backup. Possible
values:

 0 — Sunday
 1 — Monday
 2 — Tuesday
 3 — Wednesday
 4 — Thursday
 5 — Friday
 6 — Saturday

Week This parameter is used if you want to create active full backups on a
specific day every month.

Numerical order of week on which the backup job must create an active
full backup. Possible values:

 1 — first week of month

 2 — second week of month
 3 — third week of month
 4 — fourth week of month
 5 — last week of month

Job Retry Settings

Parent Tag Parameter Description

RetryInfo Parent tag that encapsulates information about job retry settings.

Enabled Parameter specifying if Veeam Agent for Microsoft Windows must

automatically retry the backup job if the job fails. Possible values:

 True — Veeam Agent for Microsoft Windows retries the

backup job. If you set the Enabled parameter to True, you
must specify the number of times for which Veeam Agent for
Microsoft Windows must retry the job, and time interval
between job retries.
 False — Veeam Agent for Microsoft Windows does not retry
the backup job.

Times Number of times for which Veeam Agent for Microsoft Windows must
retry a backup job. By default, Veeam Agent for Microsoft Windows retries
the backup job 3 times.

TimeoutMinutes Time interval between job retries in minutes. By default, the time interval
is 10 minutes.

Note: the TimeoutMinutes parameter is not applicable if the backup job

runs continuously. In this case, Veeam Agent for Microsoft Windows will
retry the job without any time intervals.

61 | Veeam Agent Configurator | Reference | REV 2

Backup Window Settings
Parent Tag Parameter Description

BackupWindow Parent tag that encapsulates information about the backup window set for
the job.

If the backup job exceeds the specified window, the job will be
terminated.

Kind Method of setting the backup window. Possible values:

 0 — permitted hours for the backup window are specified.

 1 — prohibited hours for the backup window are specified.

Days Parent tag that encapsulates information about the backup window for
the backup job.

<Weekday> Intervals Intervals of permitted or prohibited hours for the backup job. The interval
of hours is specified for every week day in the following format:

<Monday Intervals="10-12, 22-24"/>.

You can specify several intervals separated with a comma followed by

space (, ). For example:

<Days>

<Monday Intervals="06-08, 18-20"/>

<Tuesday Intervals="06-08, 18-20, 22-24"/>

</Days>

Note: If there are more prohibited hours intervals than permitted hours
intervals, Veeam Agent Configurator will export information about
prohibited hours when you run the SaveConfiguration command, and
vice versa.

62 | Veeam Agent Configurator | Reference | REV 2

Example 1
You want to run the backup job continuously with the following schedule:

 At weekend, the backup job can start any time.

 On week days, the backup job must not start between 6:00 AM to 6:00 PM.

The input XML file will contain the following parameters:

<?xml version="1.0"?>
<JobInfo CryptType="10">
<ScheduleInfo Type="4" RunManually="False">
<ContinuouslyInfo>
<Schedule Kind="1">
<Days>
<Monday Intervals="06-18"/>
<Tuesday Intervals="06-18"/>
<Wednesday Intervals="06-18"/>
<Thursday Intervals="06-18"/>
<Friday Intervals="06-18"/>
</Days>
</Schedule>
</ContinuouslyInfo>
</ScheduleInfo>
</JobInfo>

Example 2
You want to run the backup job daily at 12:00 AM, and set up the following backup window for the job:

 At weekend, the backup job can run any time.

 On Monday through Thursday, the backup job must not run between 6:00 AM to 6:00 PM.

 On Friday, the backup job must not run between 6:00 AM and 4:00 PM.

The input XML file will contain the following parameters:

<?xml version="1.0"?>
<JobInfo CryptType="10">
<ScheduleInfo Type="1" UseBackupWindow="True" RunManually="False">
<DailyInfo Kind="0" Days="Sunday, Monday, Tuesday, Wednesday, Thursday, Friday,
Saturday" Time="00:00:00"/>
<BackupWindow Kind="1">
<Days>
<Monday Intervals="06-18"/>
<Tuesday Intervals="06-18"/>
<Wednesday Intervals="06-18"/>
<Thursday Intervals="06-18"/>
<Friday Intervals="06-16"/>
</Days>
</BackupWindow>
</ScheduleInfo>
</JobInfo>

63 | Veeam Agent Configurator | Reference | REV 2

Statistics Information
The StatisticsInfo section in the input XML file contains statistics information about the backup job
performance.

Parent Tag Parameter Description

StatisticsInfo Parent tag that encapsulates information about the job statistics.

LastPointSize Size of the latest restore point created by the backup job.

TotalSize Total size of all restore points created by the backup job.

AverageDuration Average duration of a backup job session.

For example:

<?xml version="1.0"?>
<StatisticsInfo LastPointSize="66110443520" TotalSize="66110443520"
AverageDuration="00:18:19.3320000"/>
…

64 | Veeam Agent Configurator | Reference | REV 2

Unattended Installation
To automate the process of Veeam Agent for Microsoft Windows deployment, you can install the product in the
unattended mode. For more information, see Installing Veeam Agent for Microsoft Windows in Unattended Mode.

65 | Veeam Agent Configurator | Reference | REV 2

How To Automate Veeam Agent for
Microsoft Windows Deployment and
Configuration
You can automate the process of Veeam Agent for Microsoft Windows deployment and configuration with scripts
and GPO. This scenario describes how to install Veeam Agent for Microsoft Windows in the unattended mode and
configure the backup job and application settings with a command line script.

To deploy and configure Veeam Agent for Microsoft Windows:

1. Prepare a configuration file with the backup job and application settings. To facilitate creation of the
configuration file, set up the necessary backup job and application settings on a machine protected with
Veeam Agent for Microsoft Windows, and export the configuration to a file with the Export command:

"C:\Program Files\Veeam\Endpoint Backup\Veeam.Agent.Configurator.exe" -export

/f:C:\Veeam\configuration.xml

2. For security purposes, Veeam Agent for Microsoft Windows does not export password values. If you use
credentials in the configuration, for example, to store backups on a backup repository that requires
authentication, open the configuration file and provide passwords in place of "Enter the password
here" placeholders.

<TargetInfo Type="3" ServerName="srv06.tech.local" ServerPort="10001"

RemoteRepositoryName="Default Backup Repository">
<ServerCredentials UserName="c3J2MDZcQWRtaW5pc3RyYXRvcg==" Password="Enter the
password here" />
</TargetInfo>

3. Place the configuration file to a network shared folder accessible from the machine on which you plan to
install and configure Veeam Agent for Microsoft Windows. In this example, the configuration file is placed
to the \\fileserver01\Veeam folder.

4. Place the Veeam Agent for Microsoft Windows setup file to a network shared folder accessible from the
machine on which you plan to install and configure Veeam Agent for Microsoft Windows. In this example,
the setup file is placed to the \\fileserver01\Veeam folder.

5. Run the unattended install command to install Veeam Agent for Microsoft Windows on the machine.
Veeam Agent for Microsoft Windows uses the following codes to report about the installation results:

 1000 — Veeam Agent for Microsoft Windows has been successfully installed.

 1001 — prerequisite components required for Veeam Agent for Microsoft Windows have been
installed on the machine. Veeam Agent for Microsoft Windows has not been installed. The
machine needs to be rebooted.

 1002 — Veeam Agent for Microsoft Windows installation has failed.

 1101 — Veeam Agent for Microsoft Windows has been installed. The machine needs to be
rebooted.

66 | Veeam Agent Configurator | Reference | REV 2

 You can use these codes to check if the product has been installed successfully or not:

\\fileserver01\Veeam\VeeamAgentWindows_2.0.0.700.exe /silent /accepteula

echo %ERRORLEVEL%

6. If you want Veeam Agent for Microsoft Windows to operate in the Workstation or Server mode, place a
license file to a network shared folder accessible from the machine on which you plan to install and
configure Veeam Agent for Microsoft Windows. In this example, the license file is placed to the
\\fileserver01\Veeam folder.

7. Prepare a script that will install Veeam Agent for Microsoft Windows in the unattended mode, import the
backup job configuration and application settings on the target machine. The sample script below
performs the following actions:

a. Installs a license and sets the product edition to Workstation.

b. Imports backup job configuration and application settings from the configuration file.

@echo --- Installing Product License and Setting Edition ---

"C:\Program Files\Veeam\Endpoint\veeam.agent.configurator.exe" -license

/f:"\\fileserver01\Veeam\veeam_agent_windows_license.lic" /w

@echo --- Importing Backup Job Configuration and Application Settings ---

"C:\Program Files\Veeam\Endpoint\veeam.agent.configurator.exe" -import

/f:"\\fileserver01\Veeam\configuration.xml"

If the script executes successfully, Veeam Agent Configurator will report error code 0 for each command in the
script.

67 | Veeam Agent Configurator | Reference | REV 2