Loading...

Wildcards for VMware Content Rules

You can use wildcards to define content and filters for a subclient. You can use wildcards when defining a rule for a VM Name Pattern, Guest OS, Guest DNS Hostname, Host, or Datastore.

Note:

  • If a subclient's content consists of wildcard characters and no eligible virtual machines are found for backup, the backup operation completes successfully even though no VMs are backed up.
  • Letters used in wildcard expressions are matched regardless of case; for example, 'a' matches both 'a' and 'A'.

The following table describes how to use wildcards when defining the subclient content or filters.

Wildcards

Description

Examples

*

Any number of characters

This wildcard is used to match all objects where the object name contains a specific pattern.

For a VM name pattern, *test* matches any virtual machine whose name contains the string 'test' (at the beginning, end, or middle of the name).

For a datastore, DC* matches any datastore whose name begins with 'DC' (to back up or filter all virtual machines on the matching datastores).

**

Any number of folders in a full path for a virtual machine disk

When filtering virtual machine disks, /**/JunkVMs/**/*.vmdk matches any .vmdk files under a JunkVMs folder or a subfolder under JunkVMs.

?

Any one character

This wildcard is used to match any object for which a single character in the object name is variable.

DC? matches any object that starts with DC followed by a single additional character (such as DC1, DC2, DCa. or DCX).

[ ]

Set or range of characters

When used at the beginning of a name pattern for a disk filter, represents a datastore name.

Note: Not supported for host names.

[a-m]* matches any object whose name begins with the letters 'a' through 'm'.

For virtual disk filtering:

  • [DS1] Test/TempVM*.vmdk matches any virtual machine disk file on datastore DS1, in the Test folder, with a name that begins with "TempVM".
  • [DS1]*/TempVM*.vmdk matches any .vmdk file name that begins with "TempVM" on any folder in datastore DS1.
  • [DS1]Test/[a-m]*.vmdk matches any .vmdk file name that begins with the letters 'a' through 'm' on datastore DS1, in the Test folder.

[ ! ]

The negation of a set or range of characters

This wildcard matches objects for which the name does not include the specified set or range of characters.

Note: Not supported for datastores or host names.

For example, [!AEIOU]* matches all object names that start with a letter other than A, E, I, O, or U.

[!A-C]* matches all names that do not start with the letters 'A' through 'C'.

Last modified: 3/29/2019 1:12:02 PM