Troubleshooting Wi-Fi profile issues in Microsoft Intune

Applies to: Microsoft Intune


This guide helps you understand and troubleshoot Wi-Fi profile issues that you may encounter when you use Microsoft Intune.

This article is divided into the following sections:

The examples in this guide use SCEP certificate authentication for these profiles and assume that the Trusted Root and SCEP profiles work correctly on the device. In the examples, the Trusted Root and SCEP profiles are named as follows.

  Android iOS Windows
Trusted Root Profile AndroidRoot iOSRoot WindowsRoot2
SCEP profile AndroidSCEP iOSSCEP WindowsSCEP2

Overview of Wi-Fi profiles

Wi-Fi is a wireless network that's used by many mobile devices to get network access. Microsoft Intune includes built-in Wi-Fi settings that can be deployed to users and devices in your organization. This group of settings is called a profile. It can be assigned to different users and groups. After the profile is assigned, your users get access your organization's Wi-Fi network without configuring it themselves.

For example, you install a new Wi-Fi network that is named Contoso Wi-Fi. Then, you want to set up all iOS devices to connect to this network. This process includes the following steps:

  1. You create a Wi-Fi profile that includes the settings that connect to the Contoso Wi-Fi wireless network.
  2. You assign the profile to a group that includes all users of iOS devices.
  3. Users find the new Contoso Wi-Fi network in the list of wireless networks on their device. They can then connect to the network by using the authentication method of your choice.

Wi-Fi profiles support the following device platforms and versions:

  • Android 4 and later
  • Android Enterprise and kiosk
  • iOS 8.0 and later
  • macOS X 10.11 and newer
  • Windows 10 and later, Windows 10 Mobile, and Windows Holographic for Business

Creating Wi-Fi profiles

To create a Wi-Fi profile, follow the steps in the "Create a device profile" section of the following Microsoft Docs article:

Add and use Wi-Fi settings on your devices in Microsoft Intune

The Properties screen on the supported platforms resembles the following examples.

Assigning Wi-Fi profiles

After you create the Wi-Fi profile, assign the profile to selected groups.

See the following Assignments screen examples.

What successful Wi-Fi profiles look like on your device

Entries in Company Portal logs of successful Wi-Fi profile deployment

Troubleshooting common issues

Issue 1: The Wi-Fi profile isn't deployed to the device

Issue 2: The Wi-Fi profile is deployed to the device, but the device can't connect to the network

Typically this is not an Intune issue. There can be multiple causes of a connectivity issue. The following items may help you understand and troubleshoot the issue:

  • Can you manually connect to the network by using a certificate that has the same criteria that's specified in the Wi-Fi profile?

    If so, examine the properties of the certificate that you used in the manual connection and make changes to the Intune Wi-Fi profile accordingly.
  • Did the Radius server log show that the device tried to connect by using the Wi-Fi profile? Usually, connectivity errors are logged in the Radius server log.

More information

If you’re still looking for a solution to a related problem, or if you want more information about Intune, post a question in our Microsoft Intune forum. Many support engineers, MVPs, and members of our development team visit the forums. So, there’s a good chance that you can find someone who has the information that you need.

If you want to open a support request with the Microsoft Intune Support team, see the following article:

How to get support for Microsoft Intune

For more information about Wi-Fi profiles in Microsoft Intune, see the following articles:

For all the latest news, information, and tech tips, visit our official blogs: