imobileconfig
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:
Note
This will download the profile to your iOS device, but will not activate your profile.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.
Note
The udid parameter can be used to target a specific device, the uuid parameter is used to target a specific configuration profile.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.