Microsoft Intune
On this page
The Microsoft Intune integration creates and updates Computer and Hardware Inventory Item records from the devices in your Intune tenant. It imports the devices through Microsoft Graph and authenticates as a registered Microsoft Graph application. For the Inventory Item records themselves, see Configuration Items.
The integration is supplied configuration, not product code. A new 2026.1 database created with the Default Workflow contains it as the scheduled task Microsoft Intune Integration, with the parameters described on this page. An upgraded database need not contain them, and an administrator may have changed them. See Default Workflow Configuration.
The integration connects to graph.microsoft.com and login.microsoftonline.com.
Prerequisites
- An active Microsoft Intune license for the tenant. The Microsoft Graph API for Intune requires it; see Microsoft's List managedDevices.
- An application registered for Microsoft Graph, with the application permission
DeviceManagementManagedDevices.Read.Alland admin consent granted to it. See Prepare Microsoft Entra ID. - The tenant ID, client ID, and client secret of that application.
Prepare Microsoft Entra ID
The integration authenticates as an application that you register in Microsoft Entra ID, in the tenant whose Intune devices you import. You do these steps in the Microsoft Entra admin center; Microsoft's articles linked in each step describe its screens.
- Register an application in the tenant. See Register an application in Microsoft Entra ID.
- On the application's Overview page, copy the Application (client) ID. You enter it in Client ID.
- Under API permissions, add the Microsoft Graph permission
DeviceManagementManagedDevices.Read.Allas an application permission, not a delegated one. See Configure an application to access Microsoft Graph. - Grant admin consent for your tenant to this permission. Microsoft Graph application permissions always require administrator consent, and only an administrator who may consent to them, such as a Privileged Role Administrator, can grant it. See Get access without a user and Grant tenant-wide admin consent to an application.
- Under Certificates & secrets, create a client secret, and copy its Value before you leave the page: Microsoft does not display it again. You enter it in Client Secret. The secret expires at the end of the lifetime you select; then create a new one and enter its value in Client Secret. See Add and manage app credentials.
- Copy the tenant ID of your Microsoft Entra tenant. You enter it in Tenant ID. See How to find your tenant ID.
Integration settings
The integration has these parameters:
| Parameter | What it sets |
|---|---|
| Tenant ID, Client ID, Client Secret | The registered Microsoft Graph application the integration authenticates as. |
| Computer Device Types to Import | The device types imported as Computer items. |
| Hardware Device Types to Import | The device types imported as Hardware items. The offered types are holoLens, iPod, iSocConsumer, surfaceHub, unknown, and winEmbedded. |
| Handling Unknown Device Types | How devices of an unknown type are handled: Import Unknown deviceType and chassisType as Hardware or Do not Import Unknown deviceType and chassisType. |
| Matching Owners to Existing Persons | How a device's owner is matched to a Person: Use Display Name and Primary E-mail, Use Display Name/Primary E-mail, then Primary E-mail, or Use Primary E-mail Only. |
| Create Owner when no matches exist | Whether an owner is created when no Person matches: Create Owners or Do not create Owners. |
| Replace Owner when Conditions Exist | Whether an existing owner is replaced: Owner field is blank, Existing Owner is different, or Do not replace Owner. |
| Debug Logging Status | The integration's debug logging: Debug Logging On or Debug Logging Off. |
| Safe Mode | Safe Mode On or Safe Mode Off. With Safe Mode On, the job runs and produces a session log, but no data is added or modified. |
You set these parameters on the integration's page in the Workflow Configuration tree, the category Integrations > Microsoft Intune. Workflow Configuration, where parameter values are set, is part of the product; the Microsoft Intune category and its parameters come from the supplied configuration. The page exists in both the Settings App and the Admin Center.
In the Settings App
Before you begin: you need the administrative right that allows managing Workflow Configuration. See Workflow Configuration and Parameters.
- Under Workflow and Business Logic, open Workflow Configuration.
- In the category tree on the left, select Integrations > Microsoft Intune. The right pane shows one input control for each parameter, with its description.
- Enter the parameter values.
- Save your changes. Only the changed values of the selected category are saved.
In the Admin Center
Before you begin: you need the Workflow Configuration permission. See Workflow Configuration and Parameters.
- Under Workflow and Business Logic, open Workflow Configuration.
- In the category tree, open Integrations > Microsoft Intune. The page shows one control for each parameter.
- Enter the parameter values. Save and Cancel appear once you change a value.
- Click Save.
The Admin Center page does not validate the values you enter. If you leave the page with unsaved changes, the Admin Center asks: "You should save you changes before leaving this page. Do you want to leave this page?"
The integration in the supplied configuration
In a new 2026.1 database created with the Default Workflow, the task and its parameters are set as follows:
- The task is supplied disabled, so it makes no call to Microsoft Graph until you supply the credentials and enable it.
- Tenant ID, Client ID, and Client Secret are empty. You enter them.
- Client ID and Client Secret are encrypted parameters in the supplied configuration.
- Computer Device Types to Import is set to all eighteen types it offers:
android,androidEnterprise,androidForWork,androidnGMS,blackberry,cloudPC,desktop,iPad,iPhone,mac,macMDM,nokia,palm,unix,windows10x,windowsPhone,windowsRT, andwinMO6. - Hardware Device Types to Import is set to five of the six types it offers:
holoLens,iPod,iSocConsumer,surfaceHub, andwinEmbedded.unknownis not selected. - Handling Unknown Device Types is set to Import Unknown deviceType and chassisType as Hardware.
- Matching Owners to Existing Persons is set to Use Display Name/Primary E-mail, then Primary E-mail.
- Create Owner when no matches exist is set to Create Owners.
- Replace Owner when Conditions Exist is set to Existing Owner is different.
- Debug Logging Status is set to Debug Logging Off.
- Safe Mode is set to Safe Mode Off, so the first run after you enable the task creates and updates Inventory Item records.
Test the settings
Neither the Settings App nor the Admin Center checks the format of the Tenant ID when you save it. A wrong value shows only when the task runs, in the session log of that run.
To run the task without adding or modifying any data:
- On the Microsoft Intune page of Workflow Configuration, set Safe Mode to Safe Mode On, and save.
- Run the Microsoft Intune Integration task, and open the session log of that run. See Scheduled Tasks.
- When the session log shows the result you expect, set Safe Mode to Safe Mode Off, and save. Runs after that create and update Inventory Item records.
Enable and run the task
You enable and run the Microsoft Intune Integration task, and read its sessions, on the Scheduled Tasks pages. See Scheduled Tasks.