Configure the Microsoft Managed Home App - Microsoft Intune (2023)

Managed Home is the app used for enterprise-owned dedicated Android devices enrolled through Intune and running in multi-app kiosk mode. For these devices, the managed home screen acts as a launcher for other approved apps that run on it. The managed home screen gives IT admins the ability to customize their devices and limit the features the end user can access. For more details seeHow to configure Microsoft managed splash screen on dedicated devices in multi-app kiosk mode.

When to configure the Microsoft Managed Home screen app

First, make sure your devices are compatible. Intune supports dedicated Android Enterprise device enrollment for Android devices running OS version 8.0 and later that reliably connect to Google mobile services. Likewise, the managed home screen is supported on Android devices running OS version 8.0 and later.

If the settings are available to you through device settings, then you usually configure the settings there. This saves time, minimizes errors, and provides a better Intune support experience. However, some of the managed home screen settings are only available throughApplication configuration policiesDashboard in the Intune console. Use this document to learn how to configure the various settings using the configuration designer or a JSON script. Also use this document to learn which home screen managed settings are available in device settings. you can also seeSet up dedicated devicesfor a complete list of settings available atdevice configurationaffecting the managed splash screen.

If you use app settings go toMicrosoft Endpoint Manager admin centerand selectforms>Application configuration policies. Add a configuration policy formanaged devicesin another placeAndroidand choosemanaged splash screenas a related app. Chooseconfiguration settingsto configure the various settings available for the managed home screen.

Choosing a configuration definition format

There are two methods you can use to configure managed home screen configuration settings:

• configuration designerlets you configure settings with an easy-to-use interface that lets you turn features on or off and set values. In this method, there are some configuration keys disabled with value typeset of sets. These configuration keys can only be configured by entering JSON data.
• json datalets you set all possible configuration keys using a JSON script.

When adding properties with the Configuration Designer, you can automatically convert those properties to JSON by selectingEnter the JSON datadoConfiguration settings formatDropdown list.

Using the configuration designer

The Configuration Designer allows you to select prepopulated configurations and their associated values.

The following table lists the available managed home screen configuration keys, value types, default values, and descriptions. The description provides expected device behavior based on the selected values. Enter the configuration keyset of setsare disabled in the configuration designer and are described in more detail inEnter the JSON datasection of this document.

Settings for customizing apps, folders, and the general appearance of the Managed Home screen:

Settings for Device Peripherals and Home Screen Managed Settings:

Settings for a custom screensaver:

Settings to support device troubleshooting:

Settings to customize the managed splash screen experience when the device is configured with Azure AD shared device mode:

Enter the JSON data

Enter JSON data to configure all available managed splash screen settings and disabled settingsconfiguration designer.

In addition to the list of configurable settings included inconfiguration designer(above), the following table lists configuration keys that you can only configure via JSON data.

Test-Configuration	value type	standard value	Description
Set whitelisted apps	PackageArray		Lets you set the apps visible on the home screen of all apps installed on the device. You can define apps by entering the name of the app package you want to make visible. For example,com.android.settingswould make the settings accessible from the home screen. Apps whitelisted in this section must already be installed on the device to be visible on the home screen.
Set pinned web links	PackageArray		Allows you to pin websites as quick launch icons on your home screen. With this setting, you can define the URL and add it to the home screen so that the end user can launch it with a single browser tap. Note: We recommend that you create, assign, and approveManaged Google Play Web Linksto your devices. If you do, they will be treated as allowed apps.
Create a managed folder to group apps	PackageArray		It lets you create and name folders and group apps within those folders. End users cannot move folders, rename folders, or move apps within folders. Folders are displayed in the order they were created, and apps in folders are displayed alphabetically. Note: Any apps that you want to group into folders must be assigned to the device and added to the Managed Home screen if needed.

The following syntax is an example JSON script with all available configuration keys:

{ "type": "androidenterprise# managedConfiguration", "productId": "app:com.microsoft.launcher.enterprise", "managedProperty": [ { "key": "lock_home_screen", "valueBool": true }, { " key": "wallpaper", "valueString": "default" }, { "key": "icon_size", "valueInteger": 2 }, { "key": "app_folder_icon", "valueInteger": 0 }, { " key": "screen_orientation", "valueInteger": 1 }, { "key": "applications", "valueBundleArray": [ { "managedProperty": [ { "key": "bundle", "valueString": " Nome do pacote Anwendungspaket here" } ] } ] }, { "key": "weblinks", "valueBundleArray": [ { "managedProperty": [ { "key": "link", "valueString": "link here" }, { " key ": "label", "valueString": "Weblink-Label hier" } ] } ] },{ "key": "widgets", "valueBundleArray": [ { "managedProperty": [ { "key" : "package" , "valueString": "Name des App-Pakets, das Widget hier verfügbar macht. Ein Beispiel: com.microsoft.launcher.enterprise" }, { "key": "widget_class", "valueString": "Name der Klasse e des Widgets aqui. Beispiel: Time" }, { "key": "interval _x", "valueInteger": 5 }, { "key": "span_y", "valueInteger": 2 } ] } ] }, { "key": "show_virtual_home", "valueBool ": false }, { "key": "virtual_home_type", "valueString": "swipe_up" }, { "key": "show_virtual_status_bar", "valueBool": true }, { "key": "exit_lock_task_mode_code", "valueString ": "123456" }, { " key": "show_wifi_setting", "valueBool": false }, { "key": "show_bluetooth_setting", "valueBool": false }, { "key": "show_flashlight_setting ", "valueBool ": false }, { "key": "show_volume_setting", "valueBool": false }, { "key": "show_device_info_setting", "valueBool": false },{ "key": "show_device_name", "valueBool": false }, { "key": " device_name", "valueString": "{{DeviceName}}" }, { "key": "device_serial_number", "valueString": "{{SerialNumber}}" } , { "Schlüssel ": "show_managed_setting", "valueBool": false }, { "key": "enable_easy_access_debugmenu", "valueBool": false }, { "key": "enable_wifi_allowlist", "valueBool": false }, { "Schlüssel": "wi fi_allo wlist", "valueBundleArray": [ { "managed pr operty": [ { "key": "SSID", "valueString": "WLAN-Netzwerkname 1 hier" } ] }, { "managedProperty": [ { " key" : "SSID", "valueString": "Wi-Fi 2-Netzwerkname hier" } ] } ] }, { "key": "grid_size", "valueString": "4;5" }, { "key" : " app_order_enabled", "valueBool": true }, { "key": "apps_in_folder_ordered_by_name", "valueBool": true }, { "key": "app_orders", "valueBundleArray": [ { "managedProperty": [ { " key" : "Paket", "valueString": "com.Microsoft.emmx" }, { "key": "type", "valueString": "application" }, { "key": "container" , "valueInteger": 1 }, { "key": " position", "valueInteger": 1 } ] }, { " managedProperty": [ { "key": "folder_name", "valueString": "Work" }, { "key" : " type", "valueString": " managed_folder" }, { "key": "container", "integerValue": 1 }, { "key": "position", "integerValue": 2 } ] }, { " managedproperty" : [ { "key": " package", "valueString": "com.microsoft.launcher.enterprise" }, { "key e": "type", "valueString": "appli cation" }, { "key": "class", "valueString": " com .microsoft.launcher.launcher" }, { "key": "container", " valueInteger": 1 }, { "key": " position", "valueInteger": 3 } ] },{ "managedProperty": [ { "key": "package", "valueString": "Klassenname für das Widget hier " }, { "key": "type", " valueString": "widget" }, { "key": "container", "valueInteger": 1 }, { "key": "position", "IntegerValue" : 1 } ] } ] }, { "key": " managed_folders", "valueBundleArray": [ { "managedproperty": [ { "key": "folder_name", "valueString": "Ordnername hier" }, { " key ": "Anwendungen", "valueBundleArray": [ { "managedProperty ": [ { "chave": "pacote", "valueString": "com .microsoft.emmx" } ] }, { "propriedade gerenciada": [ { "chave": "pacote", "string de valor": "com .microsoft.bing" } ] }, { "propriedade gerenciada": [ { "chave": "link", "valueString": "https:// microsoft. com/" } ] } ] } ] }, { "managementProperty": [ { "key": "folder_name", "valueString": "Beispiel für Ordnername 2 " },{ "Schlüssel": "is_customer_facing", "valueBool" : true }, { "key": "applications", "valueBundleArray": [ { "managedPropert y": [ { "key": " package ", "valueString": "com.microsoft.office.word" } ] } ] } ] } ] },{ "key": "show_notification_badge", "valueBool": true },{ "key": "show_screen_saver" , "valueBool": true }, { "key": "screen_saver_image", "valueString ": "URL zum gewünschten Bildschirmschonerbild hier" }, { "key": "screen_saver_show_time" , "valueInteger": 0 } ,{ " key": "inactive_time_to_show_screen_saver", "valueInteger": 30 }, { "key": "media_detect_before_screen_saver ", "valueBool": true }, { "key": "enable_max_inactive_time_outside_MHS", " valueBool": false }, { "key" : "enable_max_absolute_time_outside_MHS", "valueBool": false }, { "key": "max_inactive_time_outside_MHS", "valueInteger": 180 }, { "key": "max_absolute_time_outside_MHS", "valueInteger": 600 },{ "key": " theme_color", "valueString": "light" }, { "key": "enable_mhs_signin", "value Bool": true }, { "key": "block_pinning_browser_web_pages_to_MHS", "valueBool": true }, { "key": "signin_type", "valueString": "AAD" }, { "key": "signin_screen_wallpaper" , " valueString": "URL zum gewünschten Bild für den Hintergrund des Anmeldebildschirms hier" }, { "key": "enable_corporate_logo", "valueBool": true }, { "key": "signin_screen_branding_logo", "valueString": "URL zum gewünschten Bild für Markenlogo hier" }, { "Schlüssel": "enable_session_PIN", "valueBool": true } , { "key": "session_PIN_complexity", "valueString": "simples" },{ "key": "max_number_of_attempts_for_session_PIN ", "valueInteger": 0 }, { "key": "Minimum_length_for_session_PIN", "valueInteger": 1 } , { "key": "max_number_of_attempts_for_exit_PIN", "valueInteger": 0 }, { "key": "amount_of_time_before_try_exit_PIN_again", "valueInteger ": 0 } { "key": "enable_auto_signout", "valueBool": true }, { " key": "inactive_time_to_signout", "valueInteger": 300 }, { "key": " auto_signout_time_to_give_user_notice", " valueInteger" : 30 }, { "key": "enable_PIN_to_resume", "valueBool": true }, { "key": "custom_privacy_statement_title", "valueString ": "Name der benutzerdefinierten Datenschutzerklärung hier" }, { "key": "custom_privacy_statement _url", "valueString": "Link zur benutzerdefinierten Datenschutzerklärung hier" }, ]}

Managed splash screen debug screen

You can access the debug screen from the managed home screen by selectingas costasuntil the debug screen appears (select theas costaskey 15 times or more). From this debug screen, you can launch the Android Device Policy app, view and upload logs, or temporarily pause kiosk mode to update your device. For more information on pausing kiosk mode, seeExit kiosk modeElemento no Android Enterprisededicated device settings. If you want easier access to the debug screen from the managed splash screen, you can enable theQuick access to debug menuConfiguration using device configuration policies or you can configure theEnable debug menu for easy accessanRIGHTthrough application configuration policies.

Next steps

• For more information on dedicated Android Enterprise devices, seeConfigure Intune enrollment for dedicated Android Enterprise devices.