Service Graph Connector for Microsoft Intune properties
Summarize
Summary of Service Graph Connector for Microsoft Intune properties
The Service Graph Connector for Microsoft Intune includes configurable properties that control how data is imported from Microsoft Intune into ServiceNow. These properties influence the behavior of connections and data retrieval, affecting performance and the level of detail imported into the Configuration Management Database (CMDB).
Show less
Connection Properties
Customers can manage these properties by navigating to All > Service Graph Connectors > Intune > Connections in ServiceNow, selecting the desired connection, and reviewing the Service Graph Connection Properties related list. Key properties include:
- includeprimaryuserdetails: Determines whether to retrieve primary user details (adds assignedto attribute to devices) or only enrolled user details. Setting this to true provides more accurate user-device associations but increases import time due to additional API calls. Default is true.
- includeipaddressdetails: Controls whether IP address details are imported and added to the IP Address [cmdbciipaddress] table. Enabling this adds valuable network information but also increases import time. Default is true.
- apiversion: Specifies the Microsoft Intune Graph API version used for data imports. The default version is v1.0.
- softwarepath: Defines the software code path to locate apps and associated devices. It can be set to "device" or "app", with "device" as the default. Setting this to null lets the logic auto-determine the path.
Advanced Data Source Settings
- devicereportchunkscount and softwarereportchunkscount: Control the chunk size for device and software reports, respectively. Values must be powers of 16 (1, 16, or 256), impacting how data is segmented during import.
- exportapismaxcallsbeforewait and exportapiswaittimeinms: Manage API call throttling by specifying how many consecutive calls are allowed before a wait period, and the duration of that wait in milliseconds. This helps avoid exceeding API limits.
- userlookupfield: Defines which Microsoft Intune source field (userprincipalname or emailaddress) is used to identify assigned users during import. The default is userprincipalname.
Practical Impact for ServiceNow Customers
By configuring these properties, customers can tailor the Service Graph Connector for Microsoft Intune to balance data completeness and import performance. Enabling primary user and IP address details enriches the CMDB but may increase import times. Advanced chunking and API call controls allow fine-tuning of import behavior to optimize reliability and efficiency.
Understanding and adjusting these settings helps ensure accurate device-user relationships, comprehensive network and software data, and efficient synchronization with Microsoft Intune data sources.
Service Graph Connector properties control the behavior of connections.
Connection properties
| 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.
|
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.
|
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).
|
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.
|
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).
|
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).
|
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.
|
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.
|
Advanced data sources (SG-Intune Device Reports and SG-Intune Software Reports) |
|
user_lookup_field |
Select the Microsoft Intune source field to be used for looking up the assigned user.
|
|