Intune Troubleshooting: Complete Guide
Learn how to troubleshoot common Intune issues including device enrollment, policy deployment, app installation, compliance problems, and configuration errors.
Troubleshooting Intune issues requires a systematic approach to identify and resolve problems with device enrollment, policy deployment, app installation, and compliance. This guide provides comprehensive troubleshooting strategies and solutions for common Intune issues.
Understanding Intune Troubleshooting
Effective troubleshooting in Intune involves understanding device check-in cycles, policy refresh intervals, and how different components interact. The built-in troubleshooting tools and reports provide valuable insights into device and policy status.
Key Troubleshooting Tools
- Troubleshoot Pane: Built-in troubleshooting for users and devices
- Device Status Reports: Policy and compliance status
- Event Logs: Windows event logs for device-side issues
- Intune Logs: Management Extension and service logs
For an overview, see Troubleshooting policies and profiles in Microsoft Intune.
Using the Troubleshoot Pane
Access Troubleshoot
- Sign in to the Microsoft Intune admin center
- Navigate to Troubleshooting + support > Troubleshoot
- Select Select user
- Choose the user experiencing issues
Review User Status
Check the following:
- Intune license: Should show green check
- Device enrollment: Should be MDM or EAS/MDM
- Microsoft Entra join type: Should be Workplace or AzureAD
- Intune compliant: Should be Yes
- Microsoft Entra compliant: Should be Yes
- Last check-in: Should be recent (within 24 hours)
Review Device Status
For each device:
- Select the device
- Review Device Compliance status
- Review Device Configuration status
- Check for conflicts or errors
For detailed guidance, see Troubleshooting policies and profiles in Microsoft Intune.
Common Issues and Solutions
Issue 1: Device Not Enrolling
Symptoms:
- Device doesn't appear in Intune
- Enrollment fails with error
- User can't complete enrollment
Troubleshooting Steps:
- Verify user has Intune license
- Check enrollment restrictions
- Verify automatic enrollment is configured
- Check device meets requirements
- Review enrollment logs
Solutions:
- Assign Intune license to user
- Adjust enrollment restrictions
- Configure automatic enrollment
- Verify device compatibility
- Check network connectivity
For guidance, see Troubleshooting Windows device enrollment errors in Intune.
Issue 2: Policies Not Applying
Symptoms:
- Policies show as pending
- Policies show errors
- Settings not configured on device
Troubleshooting Steps:
- Verify device enrollment
- Check device check-in status
- Review policy assignments
- Check for policy conflicts
- Verify device meets requirements
Solutions:
- Ensure device is enrolled
- Force device check-in
- Verify policy assignments
- Resolve policy conflicts
- Check device compatibility
For details, see Troubleshooting policies and profiles in Microsoft Intune.
Issue 3: Apps Not Installing
Symptoms:
- App shows as failed
- App not appearing on device
- Installation timeout
Troubleshooting Steps:
- Verify app assignments
- Check device requirements
- Review installation logs
- Check for installation conflicts
- Verify app compatibility
Solutions:
- Verify app is assigned correctly
- Check device meets requirements
- Review installation command
- Test installation manually
- Check for conflicting apps
Issue 4: Compliance Issues
Symptoms:
- Device marked as noncompliant
- Compliance policies not evaluating
- Conditional Access blocking access
Troubleshooting Steps:
- Review compliance policy assignments
- Check device compliance status
- Review per-setting compliance
- Verify device check-in
- Check compliance policy settings
Solutions:
- Verify compliance policy assignments
- Address noncompliant settings
- Force device check-in
- Review compliance policy configuration
- Check grace period settings
For guidance, see Monitor results of your Intune Device compliance policies.
Issue 5: Configuration Conflicts
Symptoms:
- Settings show as conflict
- Policies not applying correctly
- Unexpected device behavior
Troubleshooting Steps:
- Review all assigned policies
- Identify conflicting settings
- Check conflict resolution rules
- Review policy precedence
- Resolve conflicts
Solutions:
- Remove conflicting policies
- Adjust policy settings
- Use scope tags to organize
- Understand conflict resolution
- Document policy relationships
For details, see View and monitor device configuration policies in Microsoft Intune.
Device Check-In and Refresh Cycles
Understanding Check-In Cycles
Devices check in with Intune:
- Default: Every 8 hours
- After enrollment: Immediately
- After policy change: Within 8 hours
- Manual sync: User can force sync
Forcing Device Check-In
Windows:
- Open Settings > Accounts > Access work or school
- Select the account
- Select Info > Sync
iOS/iPadOS:
- Open Company Portal app
- Go to Devices
- Select device > Check Settings
Android:
- Open Company Portal app
- Go to Devices
- Select device > Check Device Settings
Reviewing Logs
Windows Event Logs
Location: Event Viewer > Applications and Services Logs > Microsoft > Windows > DeviceManagement-Enterprise-Diagnostics-Provider
Key Events:
- Event 306: Policy received
- Event 307: Policy applied
- Event 308: Policy error
Intune Management Extension Logs
Location: %ProgramFiles(x86)%\Microsoft Intune Management Extension\Logs
Log Files:
- IMEAgent.log
- IMESetup.log
- IMEDownloadContent.log
Best Practices
1. Use Troubleshoot Pane First
- Start with built-in troubleshooting
- Review user and device status
- Check policy assignments
- Identify obvious issues
2. Check Device Status
- Verify device enrollment
- Check last check-in time
- Review compliance status
- Check for errors
3. Review Policy Assignments
- Verify policies are assigned
- Check group membership
- Review scope tags
- Verify policy compatibility
4. Test Incrementally
- Test with single device first
- Verify fix before expanding
- Document solutions
- Share knowledge
5. Monitor Regularly
- Review reports weekly
- Address issues promptly
- Track recurring problems
- Improve processes
Additional Resources
- Troubleshooting policies and profiles in Microsoft Intune
- Troubleshooting Windows device enrollment errors in Intune
- Troubleshooting the deployment of SCEP certificates profile to devices in Intune
Conclusion
Effective troubleshooting requires a systematic approach and understanding of Intune's components. By following these best practices:
✅ Use troubleshoot pane as starting point
✅ Check device status and check-in
✅ Review policy assignments
✅ Test solutions incrementally
✅ Monitor and document issues
You can efficiently identify and resolve Intune issues, ensuring your device management environment remains healthy and functional.
Remember: Most Intune issues relate to device check-in, policy assignments, or device requirements. Start with the troubleshoot pane and work through common issues systematically.