imobileconfig

Hands-off configuration of iOS devices

imobileconfig is a command-line utility which allows you to push configuration profiles to iOS devices, using a PC running Windows or Linux.

For more information about configuration profiles, see the Configuration Profile Reference .

Prequisites

To push configuration profiles to iOS devices using the Quamotion imobileconfig command-line utility, you need:

  • A PC running Linux or Windows
  • On Windows: The latest version of iTunes
  • On Linux: The latest version of libimobiledevice

Using the Quamotion imobileconfig utility

All imobileconfig commands take the following common parameters:

-l|--license <path to your Quamotion license file>
-u|--udid <the UDID of your device>

where:

  • license is the path to your Quamotion license file
  • udid is the UDID of the device on which you want to execute the command. You can omit the udid parameter if only one iOS device is connected to your computer

Installing a mobile configuration profile on your device

To install a configuration profile on your device, run the imobileconfig install --license <path to your Quamotion license file> --profile <path to your profile> command:

For example:

C:\imobileconfig>imobileconfig.exe install -l %LICENSE% --profile QM_DEMO.mobileconfig
Quamotion iOS Configuration Profile utility version 0.130.105
Machine ID: 000FFICE
 
Installing configuration profile QM_DEMO.mobileconfig on device 0123456789abcde0123456789abcde0123456789
Successfully installed the configuration profile.

Listing all configuration profiles installed on your device

To list all configuration profiles installed on your device, run the imobileconfig list --license <path to your Quamotion license file> command.

For example:

C:\imobileconfig>imobileconfig.exe list -l %LICENSE%
Quamotion iOS Configuration Profile utility version 0.130.105
Machine ID: 000FFICE
 
Listing configuration profiles for device 0123456789abcde0123456789abcde0123456789
 
Name        Identifier                                           UUID                                   Version  Status
QM_DEMO     quamotion-ios.AB71FB8C-907E-4667-84B8-B43AF3E40B7D   1F5A68D7-8874-4ED1-99F4-103045EAD27F   1        active
 
Found 1 mobile configuration profile(s).

Removing a mobile configuration profile from your device

To remove a profile from your device, run the imobileconfig remove --license <path to your Quamotion license file> --identifier <id> --uuid <uuid> --version <version> command.

For example:

C:\imobileconfig>imobileconfig.exe remove -l %LICENSE% --identifier quamotion-ios.AB71FB8C-907E-4667-84B8-B43AF3E40B7D --uuid 1F5A68D7-8874-4ED1-99F4-103045EAD27F --version 1
Quamotion iOS Configuration Profile utility version 0.130.105
Machine ID: 000FFICE
 
Removing configuration profile from device 0123456789abcde0123456789abcde0123456789
Successfully removed the configuration profile.

For more information about the Quamotion iosreset command-line utility, contact us at info@quamotion.mobi.

Last modified November 18, 2019: Fix typos (3799848)