Creating a dynamic group

  1. Click Devices, and then select the group which contains the devices for which you want to create a dynamic group.
  2. Search for devices by using the search field. You can use multiple search criteria and operators described below.
  3. Click Save as next to the search field.
  4. Specify the group name, and then click OK.

Search criteria

The following table summarizes the available search criteria.

Criterion

Meaning

Search query examples

name
  • Host name for physical machines
  • Name for virtual machines
  • Database name
  • Email address for mailboxes

name = 'ru-00'

comment

Comment for a device.

Default value:

  • For physical machines running Windows, the computer description taken from the computer properties in Windows.
  • Empty for other devices.

To view the comment, under Devices, select the device, click Details, and then locate the Comment section.

To add or change the comment, click Add or Edit.

comment = 'important machine'

comment = '' (all machines without a comment)

ip

IP address (only for physical machines)

ip RANGE ('10.250.176.1','10.250.176.50')

memorySize

RAM size in megabytes (MiB)

memorySize < 1024

insideVm

Virtual machine with an agent inside.

Possible values:

  • true
  • false

insideVm = true

osName

Operating system name.

osName LIKE '%Windows XP%'

osType

Operating system type.

Possible values:

  • 'windows'
  • 'linux'
  • 'macosx'

osType IN ('linux', 'macosx')

osProductType

The operating system product type.

Possible values:

  • 'dc'

    Stands for Domain Controller.

  • 'server'
  • 'workstation'

osProductType = 'server'

tenant

The name of the unit to which the device belongs.

tenant = 'Unit 1'

tenantId

The identifier of the unit to which device belongs.

To get the unit ID, under Devices, select the device, click Details > All properties. The ID is shown in the ownerId field.

tenantId = '3bfe6ca9-9c6a-4953-9cb2-a1323f454fc9'

 

state

Device state.

Possible values:

  • 'idle'
  • 'interactionRequired'
  • 'canceling'
  • 'backup'
  • 'recover'
  • 'install'
  • 'reboot'
  • 'failback'
  • 'testReplica'
  • 'run_from_image'
  • 'finalize'
  • 'failover'
  • 'replication'
  • 'createAsz'
  • 'deleteAsz'
  • 'resizeAsz'

state = 'backup'

protectedByPlan

Devices that are protected by a backup plan with a given ID.

To get the plan ID, click Plans > Backup, select the plan, click on the diagram in the Status column, and then click on a status. A new search with the plan ID will be created.

protectedByPlan = '4B2A7A93-A44F-4155-BDE3-A023C57C9431'

okByPlan

Devices that are protected by a backup plan with a given ID and have an OK status.

okByPlan = '4B2A7A93-A44F-4155-BDE3-A023C57C9431'

errorByPlan

Devices that are protected by a backup plan with a given ID and have an Error status.

errorByPlan = '4B2A7A93-A44F-4155-BDE3-A023C57C9431'

warningByPlan

Devices that are protected by a backup plan with a given ID and have a Warning status.

warningByPlan = '4B2A7A93-A44F-4155-BDE3-A023C57C9431'

runningByPlan

Devices that are protected by a backup plan with a given ID and have a Running status.

runningByPlan = '4B2A7A93-A44F-4155-BDE3-A023C57C9431'

interactionByPlan

Devices that are protected by a backup plan with a given ID and have an Interaction Required status.

interactionByPlan = '4B2A7A93-A44F-4155-BDE3-A023C57C9431'

ou

Machines that belong to the specified Active Directory organizational unit.

ou IN ('RnD', 'Computers')

id

Device ID.

To get the device ID, under Devices, select the device, click Details > All properties. The ID is shown in the id field.

id != '4B2A7A93-A44F-4155-BDE3-A023C57C9431'

lastBackupTime

The date and time of the last successful backup.

The format is 'YYYY-MM-DD HH:MM'.

lastBackupTime > '2016-03-11'

lastBackupTime <= '2016-03-11 00:15'

lastBackupTime is null

lastBackupTryTime

The time of the last backup attempt.

The format is 'YYYY-MM-DD HH:MM'.

lastBackupTryTime >= '2016-03-11'

nextBackupTime

The time of the next backup.

The format is 'YYYY-MM-DD HH:MM'.

nextBackupTime >= '2016-03-11'

agentVersion

Version of the installed backup agent.

agentVersion LIKE '12.0.*'

hostId

Internal ID of the backup agent.

To get the backup agent ID, under Devices, select the machine, click Details > All properties. Use the "id" value of the agent property.

hostId = '4B2A7A93-A44F-4155-BDE3-A023C57C9431'

Operators

The following table summarizes the available operators.

Operator

Meaning

Examples

AND

Logical conjunction operator.

name like 'ru-00' AND tenant = 'Unit 1'

OR

Logical disjunction operator.

state = 'backup' OR state = 'interactionRequired'

NOT

Logical negation operator.

NOT(osProductType = 'workstation')

LIKE 'wildcard pattern'

This operator is used to test if an expression matches the wildcard pattern. This operator is case-insensitive.

The following wildcard operators can be used:

  • * or % The asterisk and the percent sign represent zero, one, or multiple characters
  • _ The underscore represents a single character

name LIKE 'ru-00'

name LIKE '*ru-00'

name LIKE '*ru-00*'

name LIKE 'ru-00_'

IN (<value1>,... <valueN>)

This operator is used to test if an expression matches any value in a list of values. This operator is case-sensitive.

osType IN ('windows', 'linux')

RANGE(<starting_value>, <ending_value>)

This operator is used to test if an expression is within a range of values (inclusive).

ip RANGE('10.250.176.1','10.250.176.50')