IntuneManagement GUI is a graphical user interface built on top of the IntuneManagement PowerShell module. It provides a user-friendly way to export and import Intune configurations. In this tutorial, you’ll learn how to use the IntuneManagement GUI for exporting and importing configurations.
Step 1: Download the IntuneManagement GUI
Visit the IntuneManagement GUI GitHub repository and download the latest release of the application.
Step 2: Launch the IntuneManagement GUI
Extract the downloaded ZIP file and run the Start-IntuneManagement.ps1 application in Powershell.
.\Start-IntuneManagement.ps1Step 3: Connect to Source Tenant
Click on the “Connect” button to connect to the source Intune tenant. Enter your credentials when prompted.
In the modern authentication window that pops up, sign in with an account that has appropriate permissions, if unsure use Global Administrator.
After sign-in you will be prompted to accept permissions for Microsoft Intune PowerShell, DO NOT tick the box to consent on behalf of your organisation.
It’s likely the first time you do this you’ll still see you don’t have access to the settings, you’ll know this as the menu on the left-hand side will have all text in red,If this happens we need to click the top right profile icon again and request consent another time.
Step 4: Export Configuration
Navigate to the desired configuration tab in the IntuneManagement GUI. Select the desired options for export, such as devices, applications, policies, etc. Click on the “Export” button to start the export process.
Step 5: Save Exported Configuration
Once clicked on export we have the following screen :
Export root: The location of the export file
Add object name to path: Add the name of the object to the exported path.
Add company name to path: Add the name of your company to the path
Export Assignments: Add the allready assigned groups/scopes to the export(if you import this already needs to be there)
Step 6: Connect to Destination Tenant
Click on the “Connect” button again to connect to the destination Intune tenant. Enter your credentials when prompted.And repeat the previous steps.
Step 7: Import Configuration
Navigate to the “Import” tab in the IntuneManagement GUI. Click on the “Browse” button to select the exported configuration file (.json format). Once selected, click on the “Import” button to start the import process.
The script can import the exported json files in multiple ways:
- Always import: The script will try to import the file. It will not check if it exists. This is the default behavior
- Skip if object exists: The script will look if there is an existing object with the same name and type. It will not import the file if existing object is detected
- Replace (Preview): If an existing object is detected, the script will
- Import the file without assignments
- Copy assignments from the existing object
- Run PostReplace commands – Priority will be set for Enrollment Restrictions etc.
- Update PolicySets object(s) to use the new imported object (detected by policySet assignments)
- Delete the original object
- Update (Preview): This will update the existing object. The update APIs does not support all the properties that the import API sdoes and object types behaves differently during update e.g. Settings for Endpoint Security objects will not be cleared. There is no API for removing settings, only adding. If a setting does not exist in the import file, the existing setting will be set to Not Configured. Settings Catalog replaces the whole settings property during update. This has been tested with all supported object types except Import Scripts (Shell), Android OEM Config and Apple Enrollment Types. Each application type works differently. Update functionality has been tested on Win32, Windows MSI LoB, iOS Store, Microsoft Store and Microsoft 365 (Windows and MacOS).
Step 8: Verify Imported Configuration
After the import process completes, verify that the configurations have been successfully imported into the destination Intune tenant by checking the Intune portal or relevant cmdlets.
Conclusion:
You’ve successfully used the IntuneManagement GUI to export and import configurations between Intune tenants. This graphical interface simplifies the process, making it more accessible to users who prefer a visual approach. Explore more features of the IntuneManagement GUI to enhance your Intune management experience further.
