Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  2. NetBackup™ for VMware Administrator's Guide
  3. Configure a VMware Intelligent Policy
  4. The basics of a NetBackup query rule
NetBackup™ for VMware Administrator's Guide

The basics of a NetBackup query rule

For automatic virtual machine selection, NetBackup uses query rules to determine which VMware virtual machines to select for backup. You create the rules in the Query Builder, on the Clients tab of the policy.

Note:

VMware policies can also be configured from the NetBackup web UI. To do so, on the left navigation pane, click Protection > Policies, and then select a listed VMware policy to change it. Or click +Add, enter a Policy name, and select VMware from the Policy type drop-down list.

In the NetBackup web UI, you must use OData keywords and OData operators in query rules:

See Query Builder field reference.

A query rule consists of the following:

  • A keyword, such as Displayname or Datacenter (many keywords are available).

    For example: For automatic selection of the virtual machines with the display names that contain certain characters, you need the Displayname keyword in the rule.

  • An operator, such as Contains, StartsWith, or Equal.

    The operator describes how NetBackup analyzes the keyword. For example: Displayname StartsWith tells NetBackup to look for the display names that start with particular characters.

  • Values for the keyword.

    For the Displayname keyword, a value might be "prod". In that case, NetBackup looks for the virtual machines that have the display names that include the characters prod.

  • An optional joining element (AND, AND NOT, OR, OR NOT) to refine or expand the query.

The policy uses these elements to discover and select virtual machines for backup.

Table: Examples of rules contains the examples of rules.

Table: Examples of rules

Rule

OData rule *

Description

Displayname Contains "vm"

contains(displayName, 'vm')

NetBackup selects the virtual machines that have the characters vm anywhere in their display names.

Displayname EndsWith "vm"

endswith(displayName, 'vm')

NetBackup selects the virtual machines that have the characters vm at the end of their display names.

Datacenter AnyOf "datacenter1","datacenter2"

datacenter in ('datacenter1','datacenter2')

NetBackup selects the virtual machines that use datacenter1 or datacenter2.

Powerstate Equal poweredOn

powerState eq 'poweredOn'

NetBackup selects only the virtual machines that are currently turned on.

Powerstate Equal poweredOn AND Tag Equal "Production"

powerState eq 'poweredOn' and tagName eq 'Production'

NetBackup selects only virtual machines that are currently powered on with the "Production" tag.

* Use OData keywords only when you build queries with the NetBackup web UI.

Feedback

Was this page helpful?
Previous

Support and use of VMware tag associations

Next

Important notes on automatic virtual machine selection

Feedback

Was this page helpful?