Ivanti Neurons for ITSM - Update Computer

Ivanti Neurons for ITSM - Update Computer updates an existing Configuration Item in your Ivanti Neurons for ITSM instance for:

  • Assets returned by the selected query or assets selected on the relevant asset page.

Use this action to sync enriched or corrected asset data back into Ivanti, such as updating ownership, device attributes, compliance status, or network information.

📘

Note

The Configuration Item must exist in Ivanti (identified by RecId, the unique asset identifier).

See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.

📘

Note


General Settings

  • Action name - The name of this Enforcement Action. The system sets a default name. You can change the name.
  • Configure Dynamic Values (optional) - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.

Required Fields

These fields must be configured to run the Enforcement Action.

  • Use stored credentials from the Ivanti Neurons for ITSM adapter - Select this option to use credentials from the adapter connection. By default, the first connection is selected.

    • When you select this option, the Select Adapter Connection drop-down becomes available. Select the adapter connection to use for this Enforcement Action.

      📘

      Note

      To use this option, you must successfully configure an Ivanti Neurons for ITSM adapter connection.

  • Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Working with Axonius Compute Nodes.

Additional Fields

These fields are optional. Include any attributes you want to update on the Configuration Item:

  • Name - The hostname or device name.
  • Asset Tag - Asset tag identifier.
  • CI Type - The Configuration Item type (for example, Laptop, Desktop, Server, Mobile Device).
  • Status - The asset status (for example, In Use, Retired, Planned).
  • Manufacturer - Device manufacturer name.
  • Model - Device model name.
  • Serial Number - Device serial number.
  • Operating System - Operating system name and version.
  • IP Address - IPv4 or IPv6 address of the device.
  • MAC Address - Hardware MAC address.
  • Domain - Domain name the device belongs to.
  • Location - Physical location or site of the device.
  • Compliance Status - Compliance status (for example, Compliant, Non-Compliant).
  • Encryption Status - Encryption status (for example, Encrypted, Not Encrypted).
  • Patch Status - Patch compliance status (for example, Patched, Unpatched).

Connection Settings

⚠️

Connection and Credentials

When Use stored credentials from the adapter is toggled off, some of the connection fields below are required to create the connection, while other fields are optional.

  • Host Name or IP Address - The base URL of your Ivanti Neurons for ITSM tenant. Must include the protocol prefix (https://). Example: https://yourtenant.ivanti.com

  • REST API Key - The REST API Key created in Ivanti ITSM.

  • Verify SSL (optional) - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

  • HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

  • HTTPS Proxy User Name (optional) - The user name to use when connecting to the server using the HTTPS Proxy.

  • HTTPS Proxy Password (optional) - The password to use when connecting to the server using the HTTPS Proxy.

  • Gateway Name - Select the Gateway through which to connect to perform the action.

APIs

Axonius uses the Ivanti Neurons for ITSM REST API - PATCH /api/odata/businessobject/ConfigurationItems('{RecId}')

Required Ports

Axonius must be able to communicate via the following ports:

  • TCP port 443 (HTTPS)

Required Permissions

The stored credentials, or those provided in Connection and Credentials, must have the following permission(s) to perform this Enforcement Action:

  • REST API Key must have write permissions to the /api/odata/businessobject/ConfigurationItems endpoint.
  • The API Key user role must have permission to update Configuration Items in Ivanti.

Version Matrix

This Enforcement Action was tested only with the versions marked as supported, but may work with other versions. Contact Axonius Support if you have a version that is not listed and it is not functioning as expected.

VersionSupportedNotes
Ivanti Neurons for ITSM 2022+Current versions

To learn more about Enforcement Actions, see Enforcement Actions.