Import Wi-Fi settings for Windows devices in Intune

For devices that run Windows, you can import a Wi-Fi configuration profile that was previously exported to a file. For Windows 10 and later devices, you can also create a Wi-Fi profile directly in Intune.

Applies to:

  • Windows 8.1 and later
  • Windows 10 and later
  • Windows 10 desktop or mobile
  • Windows Holographic for Business

Export Wi-Fi settings from a Windows device

In Windows, use netsh wlan to export an existing Wi-Fi profile to an XML file readable by Intune. The key must be exported in plain text to successfully use the profile.

On a Windows computer that already has the required WiFi profile installed, use the following steps:

  1. Create a local folder for the exported Wi-Fi profiles, such as c:\WiFi.
  2. Open up a Command Prompt as an administrator.
  3. Run the netsh wlan show profiles command. Note the name of the profile you'd like to export. In this example, the profile name is WiFiName.
  4. Run the netsh wlan export profile name="ProfileName" folder=c:\Wifi command. This command creates a Wi-Fi profile file named Wi-Fi-WiFiName.xml in your target folder.

Import the Wi-Fi settings into Intune

  1. Sign in to the Microsoft Endpoint Manager admin center.

  2. Select Devices > Configuration profiles > Create profile.

  3. Enter the following settings:

    • Name: Enter a descriptive name for the profile. The name must be the same as the name attribute in the Wi-Fi profile xml. Otherwise, it fails.
    • Description: Enter a description that gives an overview of the setting, and any other important details.
    • Platform: Select Windows 8.1 and later.
    • Profile type: Select Wi-Fi import.

    Important

    • If you are exporting a Wi-Fi profile that includes a pre-shared key, you must add key=clear to the command. For example, enter: netsh wlan export profile name="ProfileName" key=clear folder=c:\Wifi
    • Using a pre-shared key with Windows 10 causes a remediation error to show in Intune. When this happens, the Wi-Fi profile is properly assigned to the device, and the profile works as expected.
    • If you export a Wi-Fi profile that includes a pre-shared key, be sure the file is protected. The key is in plain text, so it's your responsibility to protect the key.
  4. Enter the following settings:

    • Connection name: Enter a name for the Wi-Fi connection. This name is shown to users when they browse available Wi-Fi networks.
    • Profile XML: Select the browse button, and select the XML file that contains the Wi-Fi profile settings you want to import.
    • File contents: Shows the XML code for the configuration profile you selected.
  5. Select OK to save your changes.

  6. When finished, select OK > Create to create the Intune profile. When complete, your profile is shown in the Devices - Configuration profiles list.

Next steps

The profile is created, but it's not doing anything. Next, assign the profile and monitor its status.

See the Wi-Fi settings overview, including other available platforms.