Use and manage Android Enterprise devices with OEMConfig in Microsoft Intune
In Microsoft Intune, you can use OEMConfig to add, create, and customize OEM-specific settings for Android Enterprise devices. OEMConfig is typically used to configure settings that aren't built in to Intune. Different original equipment manufacturers (OEM) include different settings. The available settings depend on what the OEM includes in their OEMConfig app.
This feature applies to:
- Android Enterprise
To manage Zebra Technologies devices using Android device administrator, use Zebra Mobile Extensions (MX).
This article describes OEMConfig, lists the prerequisites, shows how to create a configuration profile, and lists the supported OEMConfig apps in Intune.
OEMConfig policies are a special type of device configuration policy similar to app configuration policy. OEMConfig is a standard defined by Google that uses app configuration in Android to send device settings to apps written by OEMs (original equipment manufacturers). This standard allows OEMs and enterprise mobility management service providers (EMMs) to build and support OEM-specific features in a standardized way. Learn more about OEMConfig (opens Google's web site).
Historically, OEMs create features. Then EMMs, like Intune, manually build support for these OEM-specific features. This approach leads to duplicated efforts and slow adoption.
With OEMConfig, an OEM creates a schema that defines OEM-specific management features. The OEM embeds the schema into an app, and then puts this app on Google Play. The EMM service reads the schema from the app, and exposes the schema in the EMM admin console. The console allows Intune administrators to configure the settings in the schema.
When the OEMConfig app installs on a device, it uses the settings configured in the EMM admin console to manage the device. The OEMConfig app executes the device settings, instead of an MDM agent built by the EMM.
When the OEM adds and improves management features, the OEM also updates the app in Google Play. As an administrator, you get these new features and updates (including fixes) without waiting for EMMs to include these updates.
You can only use OEMConfig with devices that support this feature and have a corresponding OEMConfig app. Consult your OEM for specific details.
Before you begin
When using OEMConfig, be aware of the following information:
Intune exposes the OEMConfig app's schema so you can configure it. Intune doesn't validate or change the schema provided by the app. So if the schema is incorrect, or has inaccurate data, then this data is still sent to devices. If you find a problem that originates in the schema, contact the OEM for guidance.
Intune doesn't influence or control the content of the app schema. For example, Intune doesn't have any control over strings, language, the actions allowed, and so on. We recommend contacting the OEM for more information on managing their devices with OEMConfig.
At any time, OEMs can update their supported features and schemas, and upload a new app to Google Play. Intune always syncs the latest version of the OEMConfig app from Google Play. Intune doesn't maintain older versions of the schema or the app. If you run into version conflicts, we recommend contacting the OEM for more information.
On Zebra devices, you can create multiple profiles, and assign them to the same device. For more information, go to OEMConfig on Zebra devices.
The OEMConfig model on non-Zebra devices only supports a single policy per device. If multiple profiles are assigned to the same device, you may see inconsistent behavior.
To use OEMConfig on your devices, you need the following requirements:
- An Android Enterprise device enrolled in Intune.
- An OEMConfig app built by the OEM, and uploaded to Google Play. If it's not on Google Play, contact the OEM for more information.
- The Intune administrator has role-based access control (RBAC) permissions for Mobile apps, Device Configurations, and the "read" permission under Android for Work. These permissions are required because OEMConfig profiles use managed app configurations to manage device configurations.
Prepare the OEMConfig app
Be sure the device supports OEMConfig, the correct OEMConfig app is added to Intune, and the app is installed on the device. Contact the OEM for this information.
OEMConfig apps are specific to the OEM. For example, a Sony OEMConfig app installed on a Zebra Technologies device doesn't do anything.
- Get the OEMConfig app from the Managed Google Play Store. Add Managed Google Play apps to Android enterprise devices lists the steps.
- Some OEMs may ship devices with the OEMConfig app preinstalled. If the app isn't preinstalled, use Intune to add and deploy the app to devices.
Create an OEMConfig profile
Sign in to the Microsoft Intune admin center.
Select Devices > Configuration > Create.
Enter the following properties:
- Platform: Select Android Enterprise.
- Profile type: Select OEMConfig.
In Basics, enter the following properties:
- Name: Enter a descriptive name for the new profile.
- Description: Enter a description for the profile. This setting is optional, but recommended.
- OEMConfig app: Choose Select an OEMConfig app.
In Associated app, select an existing OEMConfig app you previously added > Select. Be sure to choose the correct OEMConfig app for the devices you're assigning the policy to.
If you don't see any apps listed, then set up Managed Google Play, and get apps from the Managed Google Play store. Add Managed Google Play apps to Android Enterprise devices lists the steps.
If you added an OEMConfig app and synced it to Google Play, but it's not listed as an Associated app, you may have to contact Intune to onboard the app. See adding a new app (in this article).
In Configure settings, select the Configuration designer or JSON editor:
Read the OEM documentation to make sure you're configuring the properties correctly. These app properties are included by the OEM, not Intune. Intune does minimal validation of the properties, or what you enter. For example, if you enter
abcdfor a port number, the profile saves as-is, and is deployed to your devices with the values you configure. Be sure you enter the correct information.
Configuration designer: When you select this option, the properties available within the app schema are shown for you to configure.
Context menus in the configuration designer indicate that more options are available. For example, the context menu might let you add, delete, and reorder settings. The OEM makes these options available. Be sure to read the OEM app documentation to learn how these options should be used to create profiles.
Many settings have default values supplied by the OEM. To see if there's a default value, hover over the info icon next to the setting. A tooltip shows the default values for that setting (if applicable), and more details provided by the OEM.
Clicking Clear deletes a setting from the profile. If a setting isn't in the profile, its value on the device doesn't change when the profile is applied.
Use the Locate button to look for settings. In the side panel, type in a keyword to see all the relevant settings and their descriptions. Select any setting to automatically add the setting to the configuration designer tree, if it's not there already. It also automatically opens the tree so you can see the setting.
If you create an empty (unconfigured) bundle in the configuration designer, it's deleted when switching to the JSON editor.
JSON editor: When you select this option, a JSON editor opens with a template for the full configuration schema embedded in the app. In the editor, customize the template with values for the different settings. If you use the Configuration designer to change your values, the JSON editor overwrites the template with values from the configuration designer.
If you're updating an existing profile, the JSON editor shows the settings that were last saved with the profile.
OEMConfig schemas can be large and complex. If you prefer to update these settings using a different editor, select the Download JSON template button. Use an editor of your choice to add your configuration values to the template. Then, copy and paste your updated JSON in to the JSON editor property.
You can use the JSON editor to create a backup of your configuration. After you configure your settings, use this feature to get the JSON settings with your values. Copy and paste the JSON to a file, and save it. Now you have a backup file.
Any changes made in the configuration designer are also made automatically in the JSON editor. Likewise, any changes made in the JSON editor are automatically made in the configuration designer. If your input contains invalid values, you can't switch between the configuration designer and JSON editor until you fix the issues.
In Scope tags (optional), assign a tag to filter the profile to specific IT groups, such as
US-NC IT Teamor
JohnGlenn_ITDepartment. For more information about scope tags, go to Use RBAC and scope tags for distributed IT.
In Assignments, select the users or groups that will receive your profile. Assign one profile to each device. The OEMConfig model only supports one policy per device.
The maximum size of any OEMConfig profile is 350 KB. Any profile that exceeds this limit isn't deployed to the device.
For more information on assigning profiles, go to Assign user and device profiles.
In Review + create, review your settings. When you select Create, your changes are saved, and the profile is assigned. The policy is also shown in the profiles list.
The next time the device checks for configuration updates, the OEM-specific settings you configured are applied to the OEMConfig app.
Reporting and deployment status
After your profile is deployed, you can check its status:
In the Microsoft Intune admin center, select Devices > Configuration. A list of all your profiles is shown.
Select your OEMConfig profile. You can get more information on your profile, including successful and failed deployments:
- Overview: Shows the profile assignment statuses. For more information on what the statuses mean, go to Monitor device profiles in Microsoft Intune.
- Properties: Shows the settings you configured when you created the profile. You can change the profile name, or update any existing settings.
- Device status: The devices assigned to the profile are listed, and it shows if the profile successfully deployed. You can select a specific device to get more details.
- User status: Lists the user names with devices affected by this profile, and if the profile successfully deployed. You can select a specific user to get more details.
You can also see if individual settings in a profile successfully applied. To see the per-setting status of an OEMConfig profile, select Devices > All devices, and choose a device from the list. Then, go to App configuration, and select your OEMConfig profile. Select an individual setting status to get more information.
The maximum size of any OEMConfig profile is 350 KB. Any profile that exceeds this limit isn't deployed to the device. Profiles in a pending state or profiles larger that 350KB aren't shown.
For Zebra devices, only a single setting row is shown. Selecting the row shows details for all settings in the policy.
Supported OEMConfig apps
Compared to standard apps, OEMConfig apps expand the managed configurations privileges granted by Google to support more complex schemas and functions. OEMs must register their OEMConfig apps with Google. If you don't register, these features may not work as expected. Intune currently supports the following OEMConfig apps:
|OEM Documentation (if available)
|Ecom - Ex-Handy 10
|Ecom - Smart-Ex 02
|Elo OEMConfig Configurations
|Honeywell - Scanpal EDA
|HMDGlobal - 7.2
|HMDGlobal - 4.2
|HMDGlobal - 5.3
|HMDGlobal - OEMConfig
|Moto OEMConfig Guide
|Knox Service Plugin Admin Guide
|Spectralink - Barcodes
|Spectralink - Buttons
|Spectralink - Device
|Spectralink - Logging
|Spectralink - VQO
|Zebra OEMConfig overview
Zebra OEMConfig Powered by MX app supports Android 11.0 and newer.
|Zebra OEMConfig overview
Legacy Zebra OEMConfig app supports Android 11.0 and earlier.
If you represent an OEM, and an OEMConfig application exists for your devices, but isn't listed in the table, then email
IntuneOEMConfig@microsoft.com for onboarding help. OEMs must also register their OEMConfig apps with Google.
OEMConfig apps must on-boarded by Google and Intune before they can be configured with OEMConfig profiles. Once an app is supported, you don't need to contact Microsoft about setting it up in your tenant. Just follow the instructions in this article.
If you experience settings within an OEMConfig app behaving incorrectly, then contact the developers of the OEMConfig app. Intune isn't responsible for technical issues with the individual OEMConfig apps.