From 21fcd14813b077be3651924b607155cbefc92878 Mon Sep 17 00:00:00 2001 From: abigail-stein <123512958+abigail-stein@users.noreply.github.com> Date: Wed, 14 Aug 2024 10:57:12 -0400 Subject: [PATCH 1/4] Update app-configuration-managed-home-screen-app.md These are changes for once all devices are automatically migrated to the updated user experience for MHS. --- ...p-configuration-managed-home-screen-app.md | 23 ++++++++----------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/memdocs/intune/apps/app-configuration-managed-home-screen-app.md b/memdocs/intune/apps/app-configuration-managed-home-screen-app.md index a5d2cf28c6e..de31b4331c2 100644 --- a/memdocs/intune/apps/app-configuration-managed-home-screen-app.md +++ b/memdocs/intune/apps/app-configuration-managed-home-screen-app.md @@ -80,10 +80,9 @@ The following table lists the Managed Home Screen available configuration keys, | Set device wall paper | string | Default | Allows you to set a wallpaper of your choice. Enter the URL of the image that you want to set as a wallpaper. | ✔️ | | Define theme color | string | light | Specify if you want Managed Home Screen to run in "light" or "dark" mode. | ❌ | | Block pinning browser web pages to MHS | bool | FALSE | Set this restriction to `true` to block users from pinning web pages from any browser onto Managed Home Screen. | ❌ | -| Enable updated user experience | bool | FALSE | Set to **true** to display the updated app design, with improvements to user workflows for usability and supportability, for MHS. If **false**, user will continue to see previous workflows on the app.
**NOTE**: Starting in August 2024, previous Managed Home Screen workflows will be removed and all devices will be required to use the updated app design. | ❌ | -| Top Bar Primary Element | choice | | Use this key to select whether the primary element of the top bar will be the device Serial Number, Device Name, or Tenant Name. This setting can only be used if **Enable sign in** key is set to **false**. If the **Enable sign in** key is set to **true**, the user's name will be shown as the primary element. **Enable updated user experience** must be set to **true** to make the top bar visible on users devices. If you select serial number, **Show serial number for all supported OS versions on MHS** must be set to `{{SerialNumber}}`. If you select device name, **Show device name for all supported OS version on MHS** must be set to `{{DeviceName}}`. | ❌ | -| Top Bar Secondary Element | choice | | Use this key to select whether the secondary element of the top bar will be the device Serial Number, Device Name, or Tenant Name. **Enable updated user experience** must be set to **true** to make the top bar visible on users devices. If you select serial number, **Show serial number for all supported OS versions on MHS** must be set to `{{SerialNumber}}`. If you select device name, **Show device name for all supported OS version on MHS** must be set to `{{DeviceName}}`. | ❌ | -| Top Bar User Name Style | choice | | Use this setting to select the style of the user's name in the top bar based on the following list:
NOTE: On devices that have a device configuration profile with the [**Enabled System Navigation Features** setting](../configuration/device-restrictions-android-for-work.md#dedicated-devices) set to **Home and Overview buttons**, end users can ignore and skip the sign in screen. | | Sign in type | string | Microsoft Entra ID | Set this configuration to "AAD" to sign in with a Microsoft Entra account. Otherwise, set this configuration to "Other". Users who sign in with a non-AAD account won't get single sign-on to all apps that have integrated with Microsoft Entra shared device mode, but will still get signed in to Managed Home Screen. By default, this setting uses "AAD" user accounts. This setting can only be used if **Enable sign in** has been set to True. | ✔️ | -| Domain name | string | | Set a domain name to be appended to usernames for sign in. If this is not set, users will need to enter the domain name. To allow users to select between multiple domain name options, add semicolon delimited strings. Enable sign in must be set to TRUE to use this configuration. This configuration is only available when **Enable updated user experience** is set to TRUE.
**NOTE**: This setting does not prevent users from inputting alternative domain names. | ❌ | -| Login hint text | string | | Set a custom login hint string by entering a string. If no string is set, the default string "Enter email or phone number" will be displayed. Enable sign in must be set to TRUE to use this configuration. This configuration is only available when **Enable updated user experience** is set to TRUE. | ❌ | +| Domain name | string | | Set a domain name to be appended to usernames for sign in. If this is not set, users will need to enter the domain name. To allow users to select between multiple domain name options, add semicolon delimited strings. Enable sign in must be set to TRUE to use this configuration.
**NOTE**: This setting does not prevent users from inputting alternative domain names. | ❌ |
+| Login hint text | string | | Set a custom login hint string by entering a string. If no string is set, the default string "Enter email or phone number" will be displayed. Enable sign in must be set to TRUE to use this configuration. | ❌ |
| Set to the url of wallpaper | string | | Allows you to set a wallpaper of your choice for the sign in screen. To use this setting, enter the URL of the image that you want set for the sign-in screen wallpaper. This image can be different than the Managed Home Screen wallpaper that is configured with **Set device wallpaper**. This setting can only be used if **Enable sign in** has been set to True. | ✔️ |
| Enable show organization logo on sign in page | bool | TRUE | Turn this setting to True to use a company logo that will appear on the sign-in screen. This setting is used with **Organization logo on sign in page** and can only be used if **Enable sign in** has been set to TRUE. | ✔️ |
| Organization logo on sign in page | string | | Allows you to brand your device with a logo of your choice on the Managed Home Screen sign-in screen. To use this setting, enter the URL of the image that you want set for the logo. This setting can only be used if **Enable show organization logo on sign in page** and **Enable sign in** have been set to True. | ✔️ |
@@ -178,7 +177,7 @@ The following table lists the Managed Home Screen available configuration keys,
| Maximum number of attempts for session PIN | string | | Define the maximum number of times a user can attempt to enter their session PIN before getting automatically logged out from Managed Home Screen. The default value is zero (0), where zero (0) means the user gets infinite tries. This can be used with any of the complexity values for session PIN. This setting can only be used if **Enable session PIN** and **Enable sign in** have been set to True. | ❌ |
| Customer facing folder | Bool | FALSE | Use this specification with **Create Managed Folder for grouping apps** to create a folder that can't be exited without a user entering their Session PIN. This setting can only be used if **Enable session PIN** and **Enable sign in** have been set to True. | ❌ |
| Require PIN code after returning from screensaver | bool | FALSE | Turn this setting True if you want to require end-users to enter their Session PIN to resume activity on Managed Home Screen after the screensaver has appeared. This setting can only be used if **Enable sign in** has been set to True. | ✔️ |
-| Minimum inactive time before session PIN is required | int | | The number of seconds the device is inactive before end-user input of session PIN is required. If set to 0, the device will always require PIN after screen saver, regardless of the inactive time. This configuration is only available when **Require PIN code after returning from screensaver** and **Enable updated user experience** are set to TRUE. | ✔️ |
+| Minimum inactive time before session PIN is required | int | | The number of seconds the device is inactive before end-user input of session PIN is required. If set to 0, the device will always require PIN after screen saver, regardless of the inactive time. This configuration is only available when **Require PIN code after returning from screensaver** is set to TRUE. | ✔️ |
| Enable auto sign-out | bool | FALSE | Turn this setting to True to automatically sign current user out of Managed Home Screen after a specified period of inactivity. When used with Microsoft Entra shared device mode, users will also get signed out of all apps on the device that participate with Microsoft Entra shared device mode. By default, this setting is turned off. This setting can only be used if **Enable sign in** has been set to True. | ✔️ |
| Auto sign-out time | integer | 300 | Set a period of inactivity, in seconds, that can pass before user gets automatically signed out of Managed Home Screen. This setting can only be used if **Enable auto sign-out** and **Enable sign in** have been set to True. | ✔️ |
| Count down time on auto sign-out dialog | integer | 60 | The amount of time, in seconds, to give notice to user before signing them out of Managed Home Screen. This setting can only be used if **Enable auto sign-out** and **Enable sign in** have been set to True. | ✔️ |
@@ -348,10 +347,6 @@ The following syntax is an example JSON script with all the available configurat
"key": "device_name",
"valueString": "{{DeviceName}}"
},
- {
- "key": "enable_updated_user_experience",
- "valueBool": false
- },
{
"key": "header_primary_element",
"valueString": "Tenant Name"
From 35121fbcb56c60a7d97e75e90510d425d5c8e049 Mon Sep 17 00:00:00 2001
From: abigail-stein <123512958+abigail-stein@users.noreply.github.com>
Date: Wed, 14 Aug 2024 11:01:17 -0400
Subject: [PATCH 2/4] Update app-configuration-managed-home-screen-app.md
---
.../intune/apps/app-configuration-managed-home-screen-app.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/memdocs/intune/apps/app-configuration-managed-home-screen-app.md b/memdocs/intune/apps/app-configuration-managed-home-screen-app.md
index de31b4331c2..cc555773616 100644
--- a/memdocs/intune/apps/app-configuration-managed-home-screen-app.md
+++ b/memdocs/intune/apps/app-configuration-managed-home-screen-app.md
@@ -105,7 +105,7 @@ The following table lists the Managed Home Screen available configuration keys,
| Enable virtual home button | bool | FALSE | True allows end users to have access to a Managed Home Screen home button that will return the user to the Managed Home Screen from the current task they are in. | ✔️ |
| Type of virtual home button | string | swipe_up | Use swipe_up to access home button with a swipe up gesture. Use float to access a sticky, persistent home button that can be moved around the screen by the end user. | ✔️ |
| Enable notifications badge | bool | FALSE | Enables the notification badge for app icons that shows the number of new notifications on the app. If you enable this setting, end users will see notification badges on apps that have unread notifications. If you keep this configuration key disabled, the end user won't see any notification badged to apps that might have unread notifications. | ✔️ |
-| Battery and Signal Strength indicator bar | bool | TRUE | Turning this setting to True shows the battery and signal strength indicator bar. | ❌ |
+| Battery and Signal Strength indicator bar | bool | FALSE | Turning this setting to True shows the battery and signal strength indicator bar. | ❌ |
| Type of virtual app switcher button | string | | The configuration key is `virtual_app_switcher_type` and the possible values are `none`, `float`, and `swipe_up`. Use `swipe_up` to access app switcher button with a swipe up gesture. Use `float` to access a sticky, persistent app switcher button that can be moved around the screen by the end user. | ❌ |
> [!IMPORTANT]
From 28d0833ff633fe92249979eb8e27ee073173f561 Mon Sep 17 00:00:00 2001
From: Erik Reitan