Notice: This website is an unofficial Microsoft Knowledge Base (hereinafter KB) archive and is intended to provide a reliable access to deleted content from Microsoft KB. All KB articles are owned by Microsoft Corporation. Read full disclaimer for more details.

Troubleshooting Wi-Fi profile issues in Microsoft Intune


View products that this article applies to.

Introduction

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

↑ Back to the top


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

↑ Back to the top


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.

For Android

4519428_1

↑ Back to the top


Assigning Wi-Fi profiles

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

See the following Assignments screen examples.

For Android

4519428_5

↑ Back to the top


What successful Wi-Fi profiles look like on your device

For Android

The following is an example of Nokia 6.1 device. In this example, you must install the Trusted Root and SCEP profiles before the Wi-Fi profile can be installed on the device.

  1. You receive a notification to install the Trusted Root certificate profile.

    4519428_8

    4519428_9

  2. You receive a notification to install the SCEP certificate profile.

    4519428_10

    4519428_11

    Note If you use a device administrator-managed Android device, there may be multiple certificates. This is because the certificates aren’t revoked or removed when a certificate profile is changed or removed. In this case, select the latest certificate. Usually, this is the last one in the list of certificates.

    This situation doesn’t occur on Android Enterprise and Samsung Knox devices. For more information, see Manage Android work profile devices with Intune and Remove SCEP and PKCS certificates in Microsoft Intune.

  3. You receive a notification to install the Wi-Fi profile.

    4519428_12

  4. The Wi-Fi connection is successfully created.

    4519428_13

↑ Back to the top


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

For Android

On an Android device, the Omadmlog.log file logs detail activities of the Wi-Fi profile when it's processed on the device. Depending on how long the Company Portal app has been installed, you may have up to five Omadmlog log files. You can use the timestamp of the last sync to help find the related entries.

The following example uses CMTrace to read the logs and uses “wifimgr” as the search string filter.

4519428_22

The following sample log snippet shows a successful processing of the Wi-Fi profile:

↑ Back to the top


Troubleshooting common issues

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

For Android
  • Verify that the Wi-Fi profile is assigned to the correct group.

    In the Intune portal, go to Device configuration > Profiles, select Assignments, and then examine the selected groups.
     

    4519428_5

    Also review the Assignments information in the Troubleshoot pane.
     

    4519428_19

  • Verify that the device can sync with Intune by checking the Last Check In time in the Troubleshoot pane.

  • If the Wi-Fi profile is linked to the Trusted Root and SCEP profiles, verify that both profiles have been deployed to the device. The Wi-Fi profile has a dependency on these profiles.
     


    If the Trusted Root and SCEP profiles aren't installed on the device, you will see the following entry in the Company Portal Omadmlog file:

    Note There is a scenario in which the Trusted Root and SCEP profiles are on the device and compliant but the Wi-Fi profile is still not on the device. This situation occurs when the CertificateSelector provider from the Company Portal app doesn't find a certificate that matches the specified criteria. The specific criteria can be on the Certificate Template or in the SCEP profile. If a matching certificate isn't found, the certificates on the device will be excluded. This will cause the Wi-Fi profile to be skipped because it doesn’t have the correct certificate. In this scenario, you see the following entry in the Company Portal Omadmlog file:
    The following is a sample log snippet in which certificates are excluded because the Any Purpose Extended Key Usage
     (EKU) criteria was specified but the certificates that are assigned to the device don’t have that EKU:
     

    In this example, the SCEP profile has the option of Any Purpose EKU specified, but it is not specified in the Certificate Template on the certificate authority (CA). To fix the issue, add the Any Purpose option to the certificate template, or remove the Any Purpose option from the SCEP profile.

    4519426_27

    4519426_28

  • Verify that all required certificates in the complete certificate chain are on the device. Otherwise, the Wi-Fi profile can't be installed on the device. For more information, see Missing intermediate certificate authority.
  • Filter Omadmlog with keyword to look for useful information, such as what certificate is used for the Wi-Fi profile and whether it was applied or not.
     

    For example, you can use CMTrace to read the logs and use the search string filter of “wifimgr”.

    4519428_22

    Sample log snippet:

    4519428_24

    If you see an error in the log, copy the time stamp of the error and un-filter the log.  Then use the “find” option with the time stamp to see what happened right before the error occurred.

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.

↑ Back to the top


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:

↑ Back to the top


Keywords: Configure Wi-Fi settings, kbContentAuto, kbSupportTopic, wi-fi profile intune

↑ Back to the top

Article Info
Article ID : 4519428
Revision : 30
Created on : 9/25/2019
Published on : 9/25/2019
Exists online : False
Views : 1877