Optional restrictions

Optional policies, while relatively common, are provided for more situational use cases.

To learn more, see:

• Use the settings catalog to configure settings on Windows, iOS/iPadOS and macOS devices
• Restrictions payload

Tip

When creating a settings catalog profile in the Microsoft Intune admin center, you can copy a policy name from this article and paste it into the settings picker search field to find the desired policy.

Settings

Category	Property	Value	Notes	Payload property
Managed Settings > Bluetooth	Enabled	True	Enable the Bluetooth setting.	Enabled
Restrictions	Force Automatic Date And Time	True	Enables the Set Automatically feature in Date & Time and the user can't disable it. Note: Location services must be enabled during Setup Assistant. Manual Time Zone policy will return an error if this policy is set to True.	forceAutomaticDateAndTime
Managed Settings > Time Zone	Time Zone	Example: America/Los_Angeles Asia/Tokyo Australia/Brisbane See complete list in IANA time zone database.	If the forceAutomaticDateAndTime restriction is set in Restrictions, this setting fails with an error. Otherwise, setting this value disables automatic time zone logic. The user is still able to change the time zone; for example, by turning automatic date and time back on. The intention is to allow setting the time zone when automatic determination isn't available, such as when Location Services are off.	TimeZone
Restrictions	Allow Bluetooth Modification	False	Prevents modification of Bluetooth settings.	allowBluetoothModification
Restrictions	Allow USB Restricted Mode	True	Allows iOS devices to always connect to USB accessories while locked. If the system has Lockdown mode enabled, it ignores this value.	allowUSBRestrictedMode
Restrictions	Blocked App Bundle IDs	Example: com.apple.facetime com.apple.findmy com.apple.Home com.apple.MobileStore com.apple.MobileSMS com.apple.Music com.apple.podcasts com.apple.stocks com.apple.tv com.apple.store.Jolly com.apple.supportapp	Prevents showing or launching apps with bundle IDs in the array.	blockedAppBundleIDs
Restrictions	Enforced Software Update Delay	30	How many days to delay a software update on the device.	enforcedSoftwareUpdateDelay
Restrictions	Force Classroom Automatically Join Classes	True	Automatically gives permission to the teacher's requests without prompting the student.	forceClassroomAutomaticallyJoinClasses
Restrictions	Force Classroom Request Permission To Leave Classes	True	A student enrolled in an unmanaged course through Classroom needs to request permission from the teacher to leave the course.	forceClassroomRequestPermissionToLeaveClasses
Restrictions	Force Classroom Unprompted App And Device Lock	True	Allows the teacher to lock apps or the device without prompting the student.	forceClassroomUnpromptedAppAndDeviceLock
Restrictions	Force Classroom Unprompted Screen Observation	True	If true and ScreenObservationPermissionModificationAllowed is also true in the Education payload, a student enrolled in a managed course through the Classroom app automatically gives permission to that course teacher's requests to observe the student's screen without prompting the student.	forceClassroomUnpromptedScreenObservation
Restrictions	Force Preserve ESIM On Erase	True	Preserves eSIM when it erases the device due to too many failed password attempts or the Erase All Content and Settings option. Note: Doesn't preserve eSIM if Find My initiates erasing the device.	forcePreserveESIMOnErase
System Configuration > Lock Screen Message	Asset Tag Information	{{devicename}}	Displayed in the login window and Lock screen.	AssetTagInformation
System Configuration > Lock Screen Message	Lock Screen Footnote	Example: School of Fine Art	The footnote displayed in the login window and Lock screen.	LockScreenFootnote

Create policy using Graph Explorer

Use Graph to create the settings catalog policy in your tenant without assignments or scope tags.

This will create a policy in your tenant with the name _MSLearn_Example_CommonEDU - iPads - Optional.

POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies
Content-Type: application/json

{"name":"_MSLearn_Example_CommonEDU - iPads - Optional","description":"","platforms":"iOS","technologies":"mdm,appleRemoteManagement","roleScopeTagIds":["0"],"settings":[{"@odata.type":"#microsoft.graph.deviceManagementConfigurationSetting","settingInstance":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationGroupSettingCollectionInstance","settingDefinitionId":"settings_item_bluetooth","groupSettingCollectionValue":[{"children":[{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingInstance","settingDefinitionId":"settings_item_bluetooth_enabled","choiceSettingValue":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingValue","value":"settings_item_bluetooth_enabled_true","children":[]}}]}]}},{"@odata.type":"#microsoft.graph.deviceManagementConfigurationSetting","settingInstance":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationGroupSettingCollectionInstance","settingDefinitionId":"settings_item_timezone","groupSettingCollectionValue":[{"children":[{"@odata.type":"#microsoft.graph.deviceManagementConfigurationSimpleSettingInstance","settingDefinitionId":"settings_item_timezone_timezone","simpleSettingValue":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue","value":"America/Los_Angeles"}}]}]}},{"@odata.type":"#microsoft.graph.deviceManagementConfigurationSetting","settingInstance":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationGroupSettingCollectionInstance","settingDefinitionId":"com.apple.applicationaccess_com.apple.applicationaccess","groupSettingCollectionValue":[{"children":[{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingInstance","settingDefinitionId":"com.apple.applicationaccess_allowbluetoothmodification","choiceSettingValue":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingValue","value":"com.apple.applicationaccess_allowbluetoothmodification_false","children":[]}},{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingInstance","settingDefinitionId":"com.apple.applicationaccess_allowusbrestrictedmode","choiceSettingValue":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingValue","value":"com.apple.applicationaccess_allowusbrestrictedmode_true","children":[]}},{"@odata.type":"#microsoft.graph.deviceManagementConfigurationSimpleSettingCollectionInstance","settingDefinitionId":"com.apple.applicationaccess_blockedappbundleids","simpleSettingCollectionValue":[{"value":"com.apple.facetime","@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue"},{"value":"com.apple.findmy","@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue"},{"value":"com.apple.Home","@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue"},{"value":"com.apple.MobileStore","@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue"},{"value":"com.apple.MobileSMS","@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue"},{"value":"com.apple.Music","@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue"},{"value":"com.apple.podcasts","@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue"},{"value":"com.apple.stocks","@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue"},{"value":"com.apple.tv","@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue"},{"value":"com.apple.store.Jolly","@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue"},{"value":"com.apple.supportapp","@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue"}]},{"@odata.type":"#microsoft.graph.deviceManagementConfigurationSimpleSettingInstance","settingDefinitionId":"com.apple.applicationaccess_enforcedsoftwareupdatedelay","simpleSettingValue":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationIntegerSettingValue","value":30}},{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingInstance","settingDefinitionId":"com.apple.applicationaccess_forceautomaticdateandtime","choiceSettingValue":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingValue","value":"com.apple.applicationaccess_forceautomaticdateandtime_true","children":[]}},{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingInstance","settingDefinitionId":"com.apple.applicationaccess_forceclassroomautomaticallyjoinclasses","choiceSettingValue":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingValue","value":"com.apple.applicationaccess_forceclassroomautomaticallyjoinclasses_true","children":[]}},{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingInstance","settingDefinitionId":"com.apple.applicationaccess_forceclassroomrequestpermissiontoleaveclasses","choiceSettingValue":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingValue","value":"com.apple.applicationaccess_forceclassroomrequestpermissiontoleaveclasses_true","children":[]}},{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingInstance","settingDefinitionId":"com.apple.applicationaccess_forceclassroomunpromptedappanddevicelock","choiceSettingValue":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingValue","value":"com.apple.applicationaccess_forceclassroomunpromptedappanddevicelock_true","children":[]}},{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingInstance","settingDefinitionId":"com.apple.applicationaccess_forceclassroomunpromptedscreenobservation","choiceSettingValue":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingValue","value":"com.apple.applicationaccess_forceclassroomunpromptedscreenobservation_true","children":[]}},{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingInstance","settingDefinitionId":"com.apple.applicationaccess_forcepreserveesimonerase","choiceSettingValue":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationChoiceSettingValue","value":"com.apple.applicationaccess_forcepreserveesimonerase_true","children":[]}}]}]}},{"@odata.type":"#microsoft.graph.deviceManagementConfigurationSetting","settingInstance":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationGroupSettingCollectionInstance","settingDefinitionId":"com.apple.shareddeviceconfiguration_com.apple.shareddeviceconfiguration","groupSettingCollectionValue":[{"children":[{"@odata.type":"#microsoft.graph.deviceManagementConfigurationSimpleSettingInstance","settingDefinitionId":"com.apple.shareddeviceconfiguration_assettaginformation","simpleSettingValue":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue","value":"{{devicename}}"}},{"@odata.type":"#microsoft.graph.deviceManagementConfigurationSimpleSettingInstance","settingDefinitionId":"com.apple.shareddeviceconfiguration_lockscreenfootnote","simpleSettingValue":{"@odata.type":"#microsoft.graph.deviceManagementConfigurationStringSettingValue","value":"MSLearn_Example_CommonEDU"}}]}]}}]}

1. Click Try it to open Graph Explorer.
2. Once Graph Explorer is open, select the user icon in the top right to sign-in and sign in with your Intune administrator organizational account.
3. Click Run query to create the policy in your tenant.

   Tip

   If it's the first time using Graph Explorer, you may need to authorize the application to access your tenant or to modify the existing permissions. This graph call requires DeviceManagementConfiguration.ReadWrite.All permissions. You can grant the required permissions by selecting modify permissions and then selecting Consent.

4. The policy is created in your tenant and can be edited to meet your requirements before assigning to groups.