Service Graph Connector for Microsoft Intune properties

  • Release version: Yokohama
  • Updated October 13, 2025
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Service Graph Connector for Microsoft Intune properties

    The Service Graph Connector for Microsoft Intune integrates Intune data into the ServiceNow CMDB, allowing customers to synchronize device, user, and software information. Connector properties control how data is imported and influence performance and data granularity.

    Show full answer Show less

    Connection Properties and Their Impact

    These properties are configured in the connection settings under All > Service Graph Connectors > Intune > Connections in ServiceNow. Adjusting these properties enables customization of data import behavior for different use cases and performance considerations.

    Key Properties and Their Uses

    • includeprimaryuserdetails: When set to true (default), the connector retrieves the primary user of a device and adds this user to the assignedto field in the Configuration Item (CI) table. Setting it to false retrieves enrolled user details instead. Retrieving primary user details requires additional API calls and increases import time. This distinction is important because the primary user updates when devices are reassigned, while the enrolled user does not.
    • includeipaddressdetails: Enables retrieval of IP address details and adds them to the IP Address CI table when set to true (default). This also increases import duration due to extra API requests.
    • apiversion: Specifies the Microsoft Intune Graph API version used for data retrieval, defaulting to v1.0. This ensures compatibility with the Intune API.
    • softwarepath: Defines the path for locating software and associated devices. Accepts device or app values, with device as the default. Setting this to null lets the connector auto-determine the path.
    • devicereportchunkscount and softwarereportchunkscount: Control how many chunks data reports are split into during import for device and software reports respectively. Values must be powers of 16 (1, 16, or 256). Adjusting these can optimize performance for large datasets.
    • exportapismaxcallsbeforewait: Limits the number of consecutive API calls before the connector pauses to avoid throttling. The default is 8 calls.
    • exportapiswaittimeinms: Defines the pause duration in milliseconds after reaching the max consecutive API calls. Default is 120,000 ms (2 minutes).

    Practical Benefits for ServiceNow Customers

    • Fine-tune data imports from Microsoft Intune to balance detail richness and import performance.
    • Ensure accurate assignment of devices to users, supporting asset and endpoint management.
    • Manage API call limits to prevent throttling and maintain reliable data synchronization.
    • Customize software discovery paths and reporting chunk sizes for efficient data handling.

    Service Graph Connector for Microsoft Intune properties control the behavior of the connector.

    Connection properties

    These connection properties are available for Service Graph Connector for Microsoft Intune.
    Note:
    To open the Service Graph Connection Properties [sn_cmdb_int_util_service_graph_connection_property] table for the connector, navigate to All > Service Graph Connectors > Intune > Connections and select the connection name. The connection properties are displayed in the Service Graph Connection Properties related list.
    Table 1. Connection properties for Service Graph Connector for Microsoft Intune
    Property Description Data source type

    include_primary_user_details

    		 Set the property to true to retrieve primary user details during import and add the assigned_to attribute to the Configuration item [cmdb_ci] table.

    Set the property to false to retrieve the enrolled user details.

    Retrieving primary user details increases the time for importing data because of additional API calls.

    Note:
    When a user is assigned to a device initially, the enrolled and primary users are the same. If the device is reassigned to another user, the primary user name is reassigned to the new user, but the enrolled user is still the original enrolled user name.
    • Type: true | false
    • Default value: true
    		 Regular data sources (SG-Intune Computer, SG-Intune Devices, and SG-Intune Software)

    include_ip_address_details

    		 Set the property to true to retrieve IP address details during import and add the records to the IP Address [cmdb_ci_ip_address] table.

    Set the property to false to skip retrieving IP addresses.

    Retrieving IP addresses increases the time for importing data because of additional API calls.

    • Type: true | false
    • Default value: true
    		 Regular data sources (SG-Intune Computer, SG-Intune Devices, and SG-Intune Software)

    api_version

    		 Enter the version of the Microsoft Intune Graph API.
    Note:
    This property is specific to the regular data sources (SG-Intune Computer, SG-Intune Devices, and SG-Intune Software).
    • Type: string
    • Default value: v1.0
    		 Regular data sources (SG-Intune Computer, SG-Intune Devices, and SG-Intune Software)

    software_path

    		 Set the path of the software code for finding apps and associated devices for regular data sources (SG-Intune Computer, SG-Intune Devices, and SG-Intune Software).

    Set the property to null value to enable the logic to determine the path of the software code.

    • Type: device | app
    • Default value: device
    		 Regular data sources (SG-Intune Computer, SG-Intune Devices, and SG-Intune Software)

    device_report_chunks_count

    		 Set the number of device report chunks. The value must be a power of 16 (1, 16, or 256).
    • Type: integer
    • Default value: 1
    		 Advanced data sources (SG-Intune Device Reports and SG-Intune Software Reports)

    software_report_chunks_count

    		 Set the number of software report chunks. The value must be a power of 16 (1, 16, or 256).
    • Type: integer
    • Default value: 16
    		 Advanced data sources (SG-Intune Device Reports and SG-Intune Software Reports)

    export_apis_max_calls_before_wait

    		 Set the maximum number of API calls that can be made consecutively before a waiting period is enforced.
    • Type: integer
    • Default value: 8
    		 Advanced data sources (SG-Intune Device Reports and SG-Intune Software Reports)

    export_apis_wait_time_in_ms

    		 Set the duration (in milliseconds) for the waiting period after the specified number of consecutive API calls is reached.
    • Type: integer
    • Default value: 120000
    		 Advanced data sources (SG-Intune Device Reports and SG-Intune Software Reports)