--- title: "Discovery Extensions" slug: "discovery-extensions-1" status: "update" updated: 2026-11-17T15:50:11Z published: 2026-11-17T15:50:11Z canonical: "help.symphonysummitai.com/discovery-extensions-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.symphonysummitai.com/llms.txt > Use this file to discover all available pages before exploring further. # Discovery Extensions Discovery Extensions enable administrators to customize how Discovery collects and stores device information. Use this feature when the standard discovery library does not collect a required attribute, returns an unsuitable value, or returns output that requires other processing. A Discovery extension groups one or more commands into a Command set for a specific Protocol and optionally, a discovered operating system. During a Discovery scan, the system runs enabled commands from the applicable command set and stores the returned values according to the selected Trigger. Discovery Extensions support the following protocols: - SSH - WMI - SNMP ### Key Benefits - Collect device attributes that the standard discovery library does not provide. - Replace incorrect or unsuitable standard inventory values. - Populate standard fields when the default discovery command returns an empty value. - Parse command output before storing the discovered value. - Apply the same collection logic to devices that use the same protocol or report the same operating system. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/discovery-extensions-image-413sz94c.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A53Z&se=2026-11-20T22%3A41%3A53Z&sr=b&sp=r&sig=4UTBg3yzyy5FKEuSLt56GmLMjcOj14%2FccOCJN4TCKxY%3D) | Use Case User Persona: Admin | Solution | | --- | --- | | NovaTech Technologies manages network and server assets whose standard discovery results do not include every attribute needed for operations. Its administrator needs to collect extra values consistently without changing the standard discovery library. | NovaTech uses Discovery Extensions to add protocol-specific commands that collect or update the required device information. **How NovaTech extends discovery?** 1. **Create a command set:** Choose SSH, WMI, or SNMP and, when needed, limit the set to a discovered operating system. 2. **Configure collection:** Add commands to retrieve the required value, select a parser for the command output, and choose whether to store it as a new custom attribute or override a standard field. 3. **Apply the set:** Enable the command set so matching discovery scans run its commands and store the results.This lets NovaTech adapt discovery output to its inventory needs while keeping the commands organized by protocol. | ### Configure Discovery Extensions To access Discovery Extensions, perform the following: 1. Log in as an administrator. 2. Navigate to **ITAM** > **Asset** > **Discovery** > **Discovery Extensions**. The application displays **Discovery Extensions** list page. For more information, refer [**Discovery Extension List Page**](/apex/docs/discovery-extensions-1#discovery-extensions-list-page)**.** ![Figure: Discovery Extension List Page](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/discovery-extensions-image-16f7db7u.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A53Z&se=2026-11-20T22%3A41%3A53Z&sr=b&sp=r&sig=kuRYpRViCymLTU9jkIV17LrO3UR7TmpYuE9sVx35NS8%3D) Figure: Discovery Extension List Page 3. Click **+ Add Command Set** to create a new command set for the protocol. ### Discovery Extensions list page Use the list page to review, filter, enable, edit, or remove command sets. You can also expand a command set to review its commands. #### Protocol filters Use the protocol tabs above the list to filter command sets: - **All Protocols** displays all command sets. - **SSH** displays command sets that run shell commands through SSH. - **WMI** displays command sets that use WMI. - **SNMP** displays command sets that retrieve values through SNMP OIDs. The number beside each protocol indicates the number of command sets available for that protocol. #### List page columns | Column | Description | | --- | --- | | **Set Name** | Displays the name assigned to the command set. Select the expand arrow to view the commands in the set. | | **Protocol** | Displays the protocol used by the command set: **SSH**, **WMI**, or **SNMP**. | | **OS Filter** | Displays the discovered operating system values to which the command set applies. A blank OS filter means that the command set applies to all targets that use the selected protocol. | | **Commands** | Displays the total number of commands and a summary of their trigger types. For example, New ×1 indicates one command that creates a custom attribute. | | **Enabled** | Enables or disables the complete command set. Disabled command sets do not run during discovery. | #### Expanded command details Expand a command set to see each configured command and how Discovery handles its result. For example, the rows below show a WMI command that collects a system name, an SNMP command that reads an operating system value, and an SSH command that collects an FQDN. ![Figure: List Page Protocol Expansion](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/discovery-extensions-image-gsjiezvx.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A53Z&se=2026-11-20T22%3A41%3A53Z&sr=b&sp=r&sig=PqLtdNSNgxwpQ8RO7tPXW0QjucEPGotBol%2Fky%2BgyfTc%3D) Figure: List Page Protocol Expansion | WMI column | Description | | --- | --- | | **Name** | Identifies the command’s purpose. For example, System Name or FQDN. | | **Trigger** | Indicates how Discovery stores the result. For example, **New** adds a custom attribute, while **Override** replaces a standard field value. | | **Target / Field Key** | Names the destination for the result. A **New** command can use system_name as its custom field key; an **Override** command can target FQDN. | | **WQL** | Contains the WMI query Discovery runs. For example, SELECT Name FROM Win32_ComputerSystem retrieves the system name. | | **Parser** | Determines how Discovery extracts the value from the query result. For example, **First Line** keeps the first line. | | **Enabled** | **Yes** means Discovery runs the command during a matching scan; disable it to keep the configuration without running it. | | SNMP column | Description | | --- | --- | | **Name** | Identifies the command’s purpose, such as Custom new field, Override OS, or FQDN Override. | | **Trigger** | Indicates how Discovery stores the result. For example, **New** adds a custom attribute and **Override** replaces a standard field value. | | **Target / Field Key** | Names the destination for the result. Examples include System Name for a custom attribute or OS Name for an overridden standard field. | | **OID** | Contains the numeric SNMP object identifier Discovery queries. For example, 1.3.6.1.2.1.1.5.0 returns the system name on devices that support it. | | **Parser** | Determines how Discovery extracts the value from the SNMP response. Examples include **First Line** and **Regex**. | | **Enabled** | **Yes** means Discovery runs the command during a matching scan; disable it to keep the configuration without running it. | | SSH column | Description | | --- | --- | | **Name** | Identifies the command’s purpose, such as Custom New Field or FQDN. | | **Trigger** | Indicates how Discovery stores the result. For example, **New** adds a custom attribute, while **Override** replaces a standard field value. | | **Target / Field Key** | Names the destination for the result. For example, System Name can be a custom field, while FQDN can be a standard field. | | **Command** | Contains the shell command Discovery runs on the target. For example, hostname returns the host name and hostname -f requests its fully qualified domain name. | | **Parser** | Determines how Discovery extracts the value from the command output. For example, **First Line** keeps the first line. | | **Enabled** | **Yes** means Discovery runs the command during a matching scan; disable it to keep the configuration without running it. | #### List page actions | Action | Description | | --- | --- | | **Expand** | Expands the command set to display its commands. | | **Edit** | Opens the command set so that you can update its details or commands. | | **Delete** | Removes the command set. | | **Items per page** | Controls the number of command sets displayed on the page. | | **Add Command Set** | Opens the **New Command Set** dialog. | **Caution:** Deleting a command set removes its configuration. Disabling a command set retains the configuration without applying it during discovery. ### Add a command set A command set defines the protocol, target operating systems, and commands that Discovery uses to collect or update values. ![Figure: Add Command Set](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/discovery-extensions-image-641x9dq5.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A53Z&se=2026-11-20T22%3A41%3A53Z&sr=b&sp=r&sig=LLdD%2FDpNFdXQZG6v7MBVC2uxSRM2I2gEDpjas4ICmIc%3D) Figure: Add Command Set To add a command set, perform the following steps: 1. Click **Add Command Set** on the **Discovery Extensions** page. 2. In **Set Name**, enter a descriptive name for the command set. 3. In **Protocol**, select **SSH**, **WMI**, or **SNMP**. The **+ Add Command** button becomes enabled only after you select a protocol. 4. In **OS Filter**, select one or more discovered OS values, if required. 5. Click **Add Command** to define the extension. For more information, refer [Add Command Set](/apex/docs/discovery-extensions-1#add-a-command-set). 6. Configure the command fields displayed for the selected protocol. 7. Add more commands if the command set must collect or update many values. 8. Enable each command that must run. 9. Click **Save**. > [!NOTE] > Note > > Select the appropriate **OS Filter** for each command set, and create only one command set for each protocol and OS flavor. Do not create duplicate templates for the same protocol and OS. #### Command set fields | Field | Description | | --- | --- | | **Set Name** | Enter a unique, recognizable name. Include the protocol, vendor, device family, OS, or purpose where appropriate. For example, SSH Extension or Cisco SNMP Catalog. | | **Protocol** | Select the protocol that Discovery uses to run the commands. The protocol determines which command fields appear. The available protocols are WMI, SSH and SMTP | | **OS Filter** | Select one or more OS values reported by discovered devices. Based on the selected Protocol OS versions display in this field. Leave the field blank to apply the command set to all targets that use the selected protocol. | | **Commands** | Displays the number of commands in the command set. Click **Add Command** to define a command. | **Note:** Select the protocol before selecting an OS filter. Discovery suggests OS names that it found during earlier device scans. ### Add a command Click **Add Command** in the **New Command Set** dialog to add a command panel. New commands run by default and initially populates with the **New Field** value in the **Trigger** field, change this value if required. #### Common command controls | Control | Description | | --- | --- | | **Expand or collapse** | Shows or hides the command configuration. | | **Enabled** | Controls whether the individual command runs during discovery. | | **Remove** | Removes the command from the command set. | #### Common command fields | Field | Description | | --- | --- | | **Command Name** | Enter a short, descriptive label that identifies the value or purpose of the command. | | **Trigger** | Select **New Field**, **Override**, or Fallback. The selection determines the target field configuration. For more information, refer T[rigger Types](/apex/docs/discovery-extensions-1#trigger-types). | | **Output Parser** | Select how Discovery processes the command output before storing the value. For example, **First Line** stores only the first line of the output. For more information, refer [Parser Output](/apex/docs/discovery-extensions-1#parse-command-output) | The remaining fields depend on the selected Protocol and Trigger. #### Trigger types Each command uses a trigger that determines how Discovery stores the returned value. | Trigger | Description | Result | | --- | --- | --- | | **New Field** | Collects an attribute that is not mapped to a standard inventory field. | The value appears under **Custom Attributes** on the discovered device details page. | | **Override** | Always replaces the value of the selected standard inventory field. | The custom value appears in the selected standard field. | | **Fallback** | Populates the selected standard inventory field only when the default discovery command returns an empty value. | The standard value remains unchanged when available. | > [!NOTE] > Note > > A command that uses **New Field** does not add a field to the standard device details layout. The collected value appears under **Custom Attributes**. In the following example Custom Attribute is set as “System Name”. When you view this on the discovered devices, you can see this under the Custom Attributes. ### Configure a WMI command Use a WMI command to query information from a Windows device. Enter a WQL SELECT statement that is valid in the remote WMI namespace. #### Create a custom attribute with WMI When you select **New Field - add as custom attribute** in **Trigger**, configure the following fields: | Field | Description | | --- | --- | | **Command Name** | Enter a short label for the command, such as BIOS Serial Number. | | **Trigger** | Select **New Field - add as custom attribute**. | | **Custom Attribute Key** | Enter the key used to store the value under **Custom Attributes**, such as custom_machine_id. | | **WQL Query** | Enter a WQL SELECT statement. For example, SELECT SerialNumber FROM Win32_BIOS requests the BIOS serial number. | | **WQL Result Column** | Enter the column whose value Discovery should store, such as SerialNumber. Leave this field blank to use the first column returned by the query. | | **Output Parser** | Select how Discovery processes the selected result before storing it. For example, **First Line** keeps the first line. | ![Figure: New Field - WMI](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/discovery-extensions-image-g8vylgr8.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A53Z&se=2026-11-20T22%3A41%3A53Z&sr=b&sp=r&sig=ywSYibXqYu%2FB0jmkShP%2FLsmHPj7haZRo5Lq0ftrXutU%3D) Figure: New Field - WMI #### Set a WMI standard field For **Override** and **Fallback**, configure the same WMI query fields. The only difference is the trigger behavior: **Override** always replaces the selected standard field, while **Fallback** populates it only when the default value is empty. ![Figure: WMI Fallback/Override](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/discovery-extensions-image-75il2rhe.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A53Z&se=2026-11-20T22%3A41%3A53Z&sr=b&sp=r&sig=Atackthb7ggceiGcAkWU67O7tOxbmaUEIIQJF05zIc4%3D) Figure: WMI Fallback/Override 1. Enter a **Command Name** and select **Override** or **Fallback** in **Trigger**. 2. Select the destination in **Standard Field to Set**. 3. Enter a WQL SELECT statement in **WQL Query**, such as SELECT SerialNumber FROM Win32_BIOS. 4. Enter the result column in **WQL Result Column**, or leave it blank to use the first column returned. 5. Select an **Output Parser**, if required, and enable the command. 6. Save the command set. ### Configure an SSH command Use an SSH command to run a shell command or pipeline supported by the remote operating system. #### Create a custom attribute with SSH When you select **New Field - add as custom attribute** in **Trigger**, configure the following fields: | Field | Description | | --- | --- | | **Command Name** | Enter a short label for the command. | | **Trigger** | Select **New Field - add as custom attribute**. | | **Custom Attribute Key** | Enter the key used to store the value under **Custom Attributes**. Use a clear key such as custom_machine_id. | | **Shell Command** | Enter a shell command or pipeline supported by the remote OS. For example, cat /etc/os-release \| grep PRETTY_NAME. | | **Output Parser** | Select the parser that extracts the required part of the command output. | ![Figure: New Field - SSH](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/discovery-extensions-image-yvrncnr6.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A53Z&se=2026-11-20T22%3A41%3A53Z&sr=b&sp=r&sig=pxl8RBlGSyCihIXHj2cbEOCVl39j7sDGUjmPgLhZOmw%3D) Figure: New Field - SSH #### Set an SSH standard field For **Override** and **Fallback**, configure the same SSH command fields. The only difference is the trigger behavior: **Override** always replaces the selected standard field, while **Fallback** populates it only when the default value is empty. | Field | Description | | --- | --- | | **Command Name** | Enter a short label for the command, such as FQDN. | | **Trigger** | Select **Override** or **Fallback**. | | **Standard Field to Set** | Select the standard inventory field to update, such as node.fqdn. | | **Shell Command** | Enter a shell command supported by the remote OS. For example, hostname -f returns the fully qualified domain name on systems that support this option. | | **Output Parser** | Select how Discovery processes the command output before storing the value. For example, **First Line** keeps the first line. | ![Figure: Overvide/Fallback - SSH](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/discovery-extensions-image-ek5loi6p.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A53Z&se=2026-11-20T22%3A41%3A53Z&sr=b&sp=r&sig=wS6gyWM2gCKdK6CkN3ZCEpXIQV4UAA3yW4uGZ4NWs%2FQ%3D) Figure: Overvide/Fallback - SSH ### Configure Override and Fallback commands Use **Override** or **Fallback** when you need to save the returned value to an existing standard inventory field. 1. Add or open a command. 2. Enter a **Command Name**. 3. Select one of the following triggers: - **Override** to always replace the standard field value. - **Fallback** to set the standard field only when the default value is empty. 4. Select the target in **Standard Field to Set**. 5. Enter the protocol-specific command, query, or OID. 6. Select an **Output Parser**, if required. 7. Enable the command. 8. Save the command set. For example, select node.fqdn as the standard field when a custom command must replace or populate the device FQDN. ### Configure an SNMP command SNMP command sets retrieve values from an SNMP agent by querying numeric OIDs. Unlike SSH and WMI commands, SNMP commands do not use shell commands or WQL queries. #### Create a custom attribute with SNMP When you select **New Field - add as custom attribute** in **Trigger**, configure the following fields: | Field | Description | | --- | --- | | **Command Name** | Enter a short label for the command, such as System Description. | | **Trigger** | Select **New Field - add as custom attribute**. | | **Custom Attribute Key** | Enter the key used to store the value under **Custom Attributes**, such as system_description. | | **SNMP OID** | Enter the numeric OID that Discovery sends in an SNMP GET request. For example, 1.3.6.1.2.1.1.1.0 requests the system description from devices that support it. | | **Output Parser** | Select how Discovery processes the returned value before storing it. For example, **First Line** keeps the first line. | ![Figure: New Field - SNMP](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/discovery-extensions-image-2gm3svit.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A53Z&se=2026-11-20T22%3A41%3A53Z&sr=b&sp=r&sig=IU%2Fqr3ewItaCCkq1J0O2yusCQxEhdU8juNfLSx04uuU%3D) Figure: New Field - SNMP #### Set an SNMP standard field For **Override** and **Fallback**, configure the same SNMP fields. The only difference is the trigger behavior: **Override** always replaces the selected standard field, while **Fallback** populates it only when the default value is empty. | Field | Description | | --- | --- | | **Command Name** | Enter a short label for the command, such as System Description. | | **Trigger** | Select **Override** or **Fallback**. | | **Standard Field to Set** | Select the standard inventory field that matches the value returned by the OID. | | **SNMP OID** | Enter the numeric OID that Discovery sends in an SNMP GET request. For example, 1.3.6.1.2.1.1.1.0 requests the system description from devices that support it. | | **Output Parser** | Select how Discovery processes the returned value before storing it. For example, **First Line** keeps the first line. | ![Figure: Override/Fallback - SNMP](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/discovery-extensions-image-k5tq6i52.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A53Z&se=2026-11-20T22%3A41%3A53Z&sr=b&sp=r&sig=Y66e9PNVQvihk%2BdJQZ%2Bn2ZFVbmrvai1EDcNS%2BZEI9k0%3D) Figure: Override/Fallback - SNMP Before using an OID in production, confirm that the OID returns the required value on each applicable device model and OS version. ### Parse command output The **Output Parser** applies to results returned by SSH commands, WMI queries, and SNMP OIDs. For WMI, Discovery first reads the selected **WQL Result Column**; if that field is blank, it reads the first column returned by the query. Discovery then applies the selected parser to the result before storing it. Choose from these parser options: | Parser | What it does | | --- | --- | | **First Line** | Keeps the first line of the result. | | **Last Line** | Keeps the last line of the result. | | **Full Output** | Keeps the complete result. | | **Regex** | Extracts text that matches a regular expression. | | **JSON Path** | Selects a value from a JSON result using a path expression. | For example, if a command, query, or OID returns more than one line and the required value is on the last line, select **Last Line**. This option works with results from any of the three protocols. ### Save a command set The **Save** button becomes available after all required command set and command fields contain valid values. Before saving, verify that: - **Set Name** is descriptive and unique. - **Protocol** matches the target devices. - **OS Filter** is correct or intentionally blank. - No other command set targets the same protocol and OS flavor. - Every command has a name and a trigger. - Each protocol-specific command, query, or OID is valid. - Each **New Field** command has a custom attribute key. - Each **Override** or **Fallback** command has a standard target field. - Enable required commands. Click **Cancel** to close the dialog without saving the configuration. ### Verify a discovery extension After creating or updating a command set: 1. Run a discovery job that includes a device matching the command set protocol and OS filter. 2. Navigate to the discovered device details page. 3. Confirm that the latest data collection completed successfully. 4. Verify the result based on the trigger: - For **New Field**, review **Custom Attributes**. - For **Override**, review the selected standard field and confirm that the custom value replaced the previous value. - For **Fallback**, verify the selected standard field on a device where the default value is empty. 5. Compare the stored value with the expected command, query, or OID output. Run discovery again after modifying a command set. Existing inventory values do not reflect the updated configuration until an applicable discovery scan processes the device. ### Manage command sets From the Discovery Extensions list page, you can: - Filter command sets by protocol. - Expand a command set to review its commands. - Enable or disable a complete command set. - Edit the OS filter or command configuration. - Add commands to an existing command set. - Disable an individual command without removing its configuration. - Delete commands or command sets that are no longer required. ### Best practices - Name command sets by protocol, vendor, device family, OS, or purpose. - Use the narrowest applicable OS filter to prevent commands from running on unintended devices. - Leave **OS Filter** blank only when the command set must apply to every target using the selected protocol. - Use stable, unique custom attribute keys and consistent naming conventions. - Check shell commands, WMI queries, and SNMP OIDs on representative devices before broad deployment. - Use **Override** only when the custom result must replace the standard value. - Use **Fallback** when the standard discovery value must remain authoritative whenever available. - Review raw output before selecting a parser. - Disable a command set when you need to stop processing but keep the configuration. - Rerun discovery and verify the result after every configuration change. ### A customization that adds commands to collect, parse, or update device information beyond the standard discovery library. A group of commands configured to run with a selected protocol and, optionally, for selected operating systems. The communication method Discovery uses to retrieve information, such as SSH, WMI, or SNMP A run that collects information from target devices using a discovery job and its enabled command sets. An event or action that initiates the execution of a workflow. Secure Shell (SSH) is a Unix Shell program for logging into, and executing commands on, a remote computer. The protocol provides secure encrypted communications between two untrusted hosts over an insecure network. SSH is used in case of other than windows OS. Windows Management Interface (WMI) is a set of extensions to the Windows Driver Model that provides an operating system interface through which instrumented components provide information and notification. Simple Network Management Protocol (SNMP) is a set of protocols for managing and monitoring complex networks. A trigger that writes a custom result to a standard inventory field only when the default discovery result is empty.