Configuring Categorization Using Grouping Expressions

In this article

    Grouping expressions are used to find objects that share common properties. When you configure categorization with grouping expression, Veeam ONE creates a set of groups, and includes objects with matching attributes into these groups.

    Groups created with grouping expressions have dynamic membership. If the property value changes, the object can be moved into another group or excluded from categorization after the next data collection.

    For example, you can create an expression that will divide VMs into groups by the guest OS name. Veeam ONE will create groups with the names of guest OSes that VMs in your infrastructure run. Each group will include VMs with the same guest OS.

    To create groups using expressions:

    1. Open Veeam ONE Client.

    For details, see Accessing Veeam ONE Client.

    1. In the inventory pane, navigate to the Business View node.
    1. Launch the Categorization Wizard:
      1. In the information pane, switch to the Categories tab.
      2. In the Actions pane, click Add Category.

    Alternatively, in the Business View tree, right-click the main node and select Add Category.

    Launching Categorization Wizard

    1. At the Name and Object Type step, enter category name, select object type and click Next.

    You can select the following types of objects: Virtual Machine, Host, Cluster, Storage, Computer.

    If you select the Computer object type, continue with step 6 of this procedure.

    Configuring Categorization Using Grouping Expressions 

    1. At the Platform step of the wizard, select the platform for which you want to categorize objects.

    Configuring Categorization Using Grouping Expressions 

    1. At the Categorization Method step of the wizard, select Grouping expression.

    Configuring Categorization Using Grouping Expressions 

    1. At the Grouping Criteria step of the wizard, specify an expression that Veeam ONE must use to create groups and distribute infrastructure objects in these groups:
    1. Click the Editor button to open the Grouping Expression Editor.
    2. In the menu on the left, double click an item to add it to the Expression field.
    3. Click Save to save the expression and exit the editor.

    Grouping Expression Editor

    To check the created script, click the Verify button.

    Create Grouping Expression

    For more information on the syntax of grouping expressions, see Appendix B. Grouping Expressions Syntax.

    If you selected the Computer object type, click Save to finish working with the wizard.

    1. At the Export step of the wizard, choose whether you want to export Business View categorization data:
    • [For VMware vSphere objects] Select Create vSphere tags if you want to display Business View categories and groups in vCenter Server.

    Veeam ONE will export categories as tag categories and groups as tags.

    • [For Microsoft Hyper-V objects] Select Create Hyper-V custom properties if you want to display Business View categories and groups in System Center Virtual Machine Manager.

    Veeam ONE will export categories as custom properties and groups as property values.


    This step is not available if you enable import of categorization data from vCenter Server, System Center Virtual Machine Manager or a 3rd party application. For more information on importing categorization model, see Selecting Categorization Model.

    Configuring Categorization Using Grouping Expressions 

    1. Click Save.
    I want to report a typo

    There is a misspelling right here:


    I want to let the Veeam Documentation Team know about that.