Update androidDeviceOwnerGeneralDeviceConfiguration
Namespace: microsoft.graph
Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
Update the properties of a androidDeviceOwnerGeneralDeviceConfiguration object.
This API is available in the following national cloud deployments.
| Global service | US Government L4 | US Government L5 (DOD) | China operated by 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
| Permission type | Permissions (from least to most privileged) |
|---|---|
| Delegated (work or school account) | DeviceManagementConfiguration.ReadWrite.All |
| Delegated (personal Microsoft account) | Not supported. |
| Application | DeviceManagementConfiguration.ReadWrite.All |
HTTP Request
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}
Request headers
| Header | Value |
|---|---|
| Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
| Accept | application/json |
Request body
In the request body, supply a JSON representation for the androidDeviceOwnerGeneralDeviceConfiguration object.
The following table shows the properties that are required when you create the androidDeviceOwnerGeneralDeviceConfiguration.
| Property | Type | Description |
|---|---|---|
| id | String | Key of the entity. Inherited from deviceConfiguration |
| lastModifiedDateTime | DateTimeOffset | DateTime the object was last modified. Inherited from deviceConfiguration |
| roleScopeTagIds | String collection | List of Scope Tags for this Entity instance. Inherited from deviceConfiguration |
| supportsScopeTags | Boolean | Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. This property is read-only. Inherited from deviceConfiguration |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | The OS edition applicability for this Policy. Inherited from deviceConfiguration |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | The OS version applicability rule for this Policy. Inherited from deviceConfiguration |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | The device mode applicability rule for this Policy. Inherited from deviceConfiguration |
| createdDateTime | DateTimeOffset | DateTime the object was created. Inherited from deviceConfiguration |
| description | String | Admin provided description of the Device Configuration. Inherited from deviceConfiguration |
| displayName | String | Admin provided name of the device configuration. Inherited from deviceConfiguration |
| version | Int32 | Version of the device configuration. Inherited from deviceConfiguration |
| azureAdSharedDeviceDataClearApps | appListItem collection | A list of managed apps that will have their data cleared during a global sign-out in AAD shared device mode. This collection can contain a maximum of 500 elements. |
| accountsBlockModification | Boolean | Indicates whether or not adding or removing accounts is disabled. |
| appsAllowInstallFromUnknownSources | Boolean | Indicates whether or not the user is allowed to enable to unknown sources setting. |
| appsAutoUpdatePolicy | androidDeviceOwnerAppAutoUpdatePolicyType | Indicates the value of the app auto update policy. Possible values are: notConfigured, userChoice, never, wiFiOnly, always. |
| appsDefaultPermissionPolicy | androidDeviceOwnerDefaultAppPermissionPolicyType | Indicates the permission policy for requests for runtime permissions if one is not defined for the app specifically. Possible values are: deviceDefault, prompt, autoGrant, autoDeny. |
| appsRecommendSkippingFirstUseHints | Boolean | Whether or not to recommend all apps skip any first-time-use hints they may have added. |
| bluetoothBlockConfiguration | Boolean | Indicates whether or not to block a user from configuring bluetooth. |
| bluetoothBlockContactSharing | Boolean | Indicates whether or not to block a user from sharing contacts via bluetooth. |
| cameraBlocked | Boolean | Indicates whether or not to disable the use of the camera. |
| cellularBlockWiFiTethering | Boolean | Indicates whether or not to block Wi-Fi tethering. |
| certificateCredentialConfigurationDisabled | Boolean | Indicates whether or not to block users from any certificate credential configuration. |
| crossProfilePoliciesAllowCopyPaste | Boolean | Indicates whether or not text copied from one profile (personal or work) can be pasted in the other. |
| crossProfilePoliciesAllowDataSharing | androidDeviceOwnerCrossProfileDataSharing | Indicates whether data from one profile (personal or work) can be shared with apps in the other profile. Possible values are: notConfigured, crossProfileDataSharingBlocked, dataSharingFromWorkToPersonalBlocked, crossProfileDataSharingAllowed, unkownFutureValue. |
| crossProfilePoliciesShowWorkContactsInPersonalProfile | Boolean | Indicates whether or not contacts stored in work profile are shown in personal profile contact searches/incoming calls. |
| microsoftLauncherConfigurationEnabled | Boolean | Indicates whether or not to you want configure Microsoft Launcher. |
| microsoftLauncherCustomWallpaperEnabled | Boolean | Indicates whether or not to configure the wallpaper on the targeted devices. |
| microsoftLauncherCustomWallpaperImageUrl | String | Indicates the URL for the image file to use as the wallpaper on the targeted devices. |
| microsoftLauncherCustomWallpaperAllowUserModification | Boolean | Indicates whether or not the user can modify the wallpaper to personalize their device. |
| microsoftLauncherFeedEnabled | Boolean | Indicates whether or not you want to enable the launcher feed on the device. |
| microsoftLauncherFeedAllowUserModification | Boolean | Indicates whether or not the user can modify the launcher feed on the device. |
| microsoftLauncherDockPresenceConfiguration | microsoftLauncherDockPresence | Indicates whether or not you want to configure the device dock. Possible values are: notConfigured, show, hide, disabled. |
| microsoftLauncherDockPresenceAllowUserModification | Boolean | Indicates whether or not the user can modify the device dock configuration on the device. |
| microsoftLauncherSearchBarPlacementConfiguration | microsoftLauncherSearchBarPlacement | Indicates the search bar placement configuration on the device. Possible values are: notConfigured, top, bottom, hide. |
| enrollmentProfile | androidDeviceOwnerEnrollmentProfileType | Indicates which enrollment profile you want to configure. Possible values are: notConfigured, dedicatedDevice, fullyManaged. |
| dataRoamingBlocked | Boolean | Indicates whether or not to block a user from data roaming. |
| dateTimeConfigurationBlocked | Boolean | Indicates whether or not to block the user from manually changing the date or time on the device |
| detailedHelpText | androidDeviceOwnerUserFacingMessage | Represents the customized detailed help text provided to users when they attempt to modify managed settings on their device. |
| deviceOwnerLockScreenMessage | androidDeviceOwnerUserFacingMessage | Represents the customized lock screen message provided to users when they attempt to modify managed settings on their device. |
| securityCommonCriteriaModeEnabled | Boolean | Represents the security common criteria mode enabled provided to users when they attempt to modify managed settings on their device. |
| factoryResetDeviceAdministratorEmails | String collection | List of Google account emails that will be required to authenticate after a device is factory reset before it can be set up. |
| factoryResetBlocked | Boolean | Indicates whether or not the factory reset option in settings is disabled. |
| globalProxy | androidDeviceOwnerGlobalProxy | Proxy is set up directly with host, port and excluded hosts. |
| googleAccountsBlocked | Boolean | Indicates whether or not google accounts will be blocked. |
| kioskCustomizationDeviceSettingsBlocked | Boolean | Indicates whether a user can access the device's Settings app while in Kiosk Mode. |
| kioskCustomizationPowerButtonActionsBlocked | Boolean | Whether the power menu is shown when a user long presses the Power button of a device in Kiosk Mode. |
| kioskCustomizationStatusBar | androidDeviceOwnerKioskCustomizationStatusBar | Indicates whether system info and notifications are disabled in Kiosk Mode. Possible values are: notConfigured, notificationsAndSystemInfoEnabled, systemInfoOnly. |
| kioskCustomizationSystemErrorWarnings | Boolean | Indicates whether system error dialogs for crashed or unresponsive apps are shown in Kiosk Mode. |
| kioskCustomizationSystemNavigation | androidDeviceOwnerKioskCustomizationSystemNavigation | Indicates which navigation features are enabled in Kiosk Mode. Possible values are: notConfigured, navigationEnabled, homeButtonOnly. |
| kioskModeScreenSaverConfigurationEnabled | Boolean | Whether or not to enable screen saver mode or not in Kiosk Mode. |
| kioskModeScreenSaverImageUrl | String | URL for an image that will be the device's screen saver in Kiosk Mode. |
| kioskModeScreenSaverDisplayTimeInSeconds | Int32 | The number of seconds that the device will display the screen saver for in Kiosk Mode. Valid values 0 to 9999999 |
| kioskModeScreenSaverStartDelayInSeconds | Int32 | The number of seconds the device needs to be inactive for before the screen saver is shown in Kiosk Mode. Valid values 1 to 9999999 |
| kioskModeScreenSaverDetectMediaDisabled | Boolean | Whether or not the device screen should show the screen saver if audio/video is playing in Kiosk Mode. |
| kioskModeApps | appListItem collection | A list of managed apps that will be shown when the device is in Kiosk Mode. This collection can contain a maximum of 500 elements. |
| kioskModeWallpaperUrl | String | URL to a publicly accessible image to use for the wallpaper when the device is in Kiosk Mode. |
| kioskModeExitCode | String | Exit code to allow a user to escape from Kiosk Mode when the device is in Kiosk Mode. |
| kioskModeVirtualHomeButtonEnabled | Boolean | Whether or not to display a virtual home button when the device is in Kiosk Mode. |
| kioskModeVirtualHomeButtonType | androidDeviceOwnerVirtualHomeButtonType | Indicates whether the virtual home button is a swipe up home button or a floating home button. Possible values are: notConfigured, swipeUp, floating. |
| kioskModeBluetoothConfigurationEnabled | Boolean | Whether or not to allow a user to configure Bluetooth settings in Kiosk Mode. |
| kioskModeWiFiConfigurationEnabled | Boolean | Whether or not to allow a user to configure Wi-Fi settings in Kiosk Mode. |
| kioskModeFlashlightConfigurationEnabled | Boolean | Whether or not to allow a user to use the flashlight in Kiosk Mode. |
| kioskModeMediaVolumeConfigurationEnabled | Boolean | Whether or not to allow a user to change the media volume in Kiosk Mode. |
| kioskModeShowDeviceInfo | Boolean | Whether or not to allow a user to access basic device information. |
| kioskModeManagedSettingsEntryDisabled | Boolean | Whether or not to display the Managed Settings entry point on the managed home screen in Kiosk Mode. |
| kioskModeDebugMenuEasyAccessEnabled | Boolean | Whether or not to allow a user to easy access to the debug menu in Kiosk Mode. |
| kioskModeShowAppNotificationBadge | Boolean | Whether or not to display application notification badges in Kiosk Mode. |
| kioskModeScreenOrientation | androidDeviceOwnerKioskModeScreenOrientation | Screen orientation configuration for managed home screen in Kiosk Mode. Possible values are: notConfigured, portrait, landscape, autoRotate. |
| kioskModeIconSize | androidDeviceOwnerKioskModeIconSize | Icon size configuration for managed home screen in Kiosk Mode. Possible values are: notConfigured, smallest, small, regular, large, largest. |
| kioskModeFolderIcon | androidDeviceOwnerKioskModeFolderIcon | Folder icon configuration for managed home screen in Kiosk Mode. Possible values are: notConfigured, darkSquare, darkCircle, lightSquare, lightCircle. |
| kioskModeWifiAllowedSsids | String collection | The restricted set of WIFI SSIDs available for the user to configure in Kiosk Mode. This collection can contain a maximum of 500 elements. |
| kioskModeAppOrderEnabled | Boolean | Whether or not to enable app ordering in Kiosk Mode. |
| kioskModeAppsInFolderOrderedByName | Boolean | Whether or not to alphabetize applications within a folder in Kiosk Mode. |
| kioskModeGridHeight | Int32 | Number of rows for Managed Home Screen grid with app ordering enabled in Kiosk Mode. Valid values 1 to 9999999 |
| kioskModeGridWidth | Int32 | Number of columns for Managed Home Screen grid with app ordering enabled in Kiosk Mode. Valid values 1 to 9999999 |
| kioskModeLockHomeScreen | Boolean | Whether or not to lock home screen to the end user in Kiosk Mode. |
| kioskModeManagedFolders | androidDeviceOwnerKioskModeManagedFolder collection | A list of managed folders for a device in Kiosk Mode. This collection can contain a maximum of 500 elements. |
| kioskModeAppPositions | androidDeviceOwnerKioskModeAppPositionItem collection | The ordering of items on Kiosk Mode Managed Home Screen. This collection can contain a maximum of 500 elements. |
| kioskModeManagedHomeScreenAutoSignout | Boolean | Whether or not to automatically sign-out of MHS and Shared device mode applications after inactive for Managed Home Screen. |
| kioskModeManagedHomeScreenInactiveSignOutDelayInSeconds | Int32 | Number of seconds to give user notice before automatically signing them out for Managed Home Screen. Valid values 0 to 9999999 |
| kioskModeManagedHomeScreenInactiveSignOutNoticeInSeconds | Int32 | Number of seconds device is inactive before automatically signing user out for Managed Home Screen. Valid values 0 to 9999999 |
| kioskModeManagedHomeScreenPinComplexity | kioskModeManagedHomeScreenPinComplexity | Complexity of PIN for sign-in session for Managed Home Screen. Possible values are: notConfigured, simple, complex. |
| kioskModeManagedHomeScreenPinRequired | Boolean | Whether or not require user to set a PIN for sign-in session for Managed Home Screen. |
| kioskModeManagedHomeScreenPinRequiredToResume | Boolean | Whether or not required user to enter session PIN if screensaver has appeared for Managed Home Screen. |
| kioskModeManagedHomeScreenSignInBackground | String | Custom URL background for sign-in screen for Managed Home Screen. |
| kioskModeManagedHomeScreenSignInBrandingLogo | String | Custom URL branding logo for sign-in screen and session pin page for Managed Home Screen. |
| kioskModeManagedHomeScreenSignInEnabled | Boolean | Whether or not show sign-in screen for Managed Home Screen. |
| kioskModeUseManagedHomeScreenApp | kioskModeType | Whether or not to use single app kiosk mode or multi-app kiosk mode. Possible values are: notConfigured, singleAppMode, multiAppMode. |
| microphoneForceMute | Boolean | Indicates whether or not to block unmuting the microphone on the device. |
| networkEscapeHatchAllowed | Boolean | Indicates whether or not the device will allow connecting to a temporary network connection at boot time. |
| nfcBlockOutgoingBeam | Boolean | Indicates whether or not to block NFC outgoing beam. |
| passwordBlockKeyguard | Boolean | Indicates whether or not the keyguard is disabled. |
| passwordBlockKeyguardFeatures | androidKeyguardFeature collection | List of device keyguard features to block. This collection can contain a maximum of 11 elements. Possible values are: notConfigured, camera, notifications, unredactedNotifications, trustAgents, fingerprint, remoteInput, allFeatures, face, iris, biometrics. |
| passwordExpirationDays | Int32 | Indicates the amount of time that a password can be set for before it expires and a new password will be required. Valid values 1 to 365 |
| passwordMinimumLength | Int32 | Indicates the minimum length of the password required on the device. Valid values 4 to 16 |
| passwordMinimumLetterCharacters | Int32 | Indicates the minimum number of letter characters required for device password. Valid values 1 to 16 |
| passwordMinimumLowerCaseCharacters | Int32 | Indicates the minimum number of lower case characters required for device password. Valid values 1 to 16 |
| passwordMinimumNonLetterCharacters | Int32 | Indicates the minimum number of non-letter characters required for device password. Valid values 1 to 16 |
| passwordMinimumNumericCharacters | Int32 | Indicates the minimum number of numeric characters required for device password. Valid values 1 to 16 |
| passwordMinimumSymbolCharacters | Int32 | Indicates the minimum number of symbol characters required for device password. Valid values 1 to 16 |
| passwordMinimumUpperCaseCharacters | Int32 | Indicates the minimum number of upper case letter characters required for device password. Valid values 1 to 16 |
| passwordMinutesOfInactivityBeforeScreenTimeout | Int32 | Minutes of inactivity before the screen times out. |
| passwordPreviousPasswordCountToBlock | Int32 | Indicates the length of password history, where the user will not be able to enter a new password that is the same as any password in the history. Valid values 0 to 24 |
| passwordRequiredType | androidDeviceOwnerRequiredPasswordType | Indicates the minimum password quality required on the device. Possible values are: deviceDefault, required, numeric, numericComplex, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, customPassword. |
| passwordRequireUnlock | androidDeviceOwnerRequiredPasswordUnlock | Indicates the timeout period after which a device must be unlocked using a form of strong authentication. Possible values are: deviceDefault, daily, unkownFutureValue. |
| passwordSignInFailureCountBeforeFactoryReset | Int32 | Indicates the number of times a user can enter an incorrect password before the device is wiped. Valid values 4 to 11 |
| playStoreMode | androidDeviceOwnerPlayStoreMode | Indicates the Play Store mode of the device. Possible values are: notConfigured, allowList, blockList. |
| screenCaptureBlocked | Boolean | Indicates whether or not to disable the capability to take screenshots. |
| securityDeveloperSettingsEnabled | Boolean | Indicates whether or not the user is allowed to access developer settings like developer options and safe boot on the device. |
| securityRequireVerifyApps | Boolean | Indicates whether or not verify apps is required. |
| shortHelpText | androidDeviceOwnerUserFacingMessage | Represents the customized short help text provided to users when they attempt to modify managed settings on their device. |
| statusBarBlocked | Boolean | Indicates whether or the status bar is disabled, including notifications, quick settings and other screen overlays. |
| stayOnModes | androidDeviceOwnerBatteryPluggedMode collection | List of modes in which the device's display will stay powered-on. This collection can contain a maximum of 4 elements. Possible values are: notConfigured, ac, usb, wireless. |
| storageAllowUsb | Boolean | Indicates whether or not to allow USB mass storage. |
| storageBlockExternalMedia | Boolean | Indicates whether or not to block external media. |
| storageBlockUsbFileTransfer | Boolean | Indicates whether or not to block USB file transfer. |
| systemUpdateFreezePeriods | androidDeviceOwnerSystemUpdateFreezePeriod collection | Indicates the annually repeating time periods during which system updates are postponed. This collection can contain a maximum of 500 elements. |
| systemUpdateWindowStartMinutesAfterMidnight | Int32 | Indicates the number of minutes after midnight that the system update window starts. Valid values 0 to 1440 |
| systemUpdateWindowEndMinutesAfterMidnight | Int32 | Indicates the number of minutes after midnight that the system update window ends. Valid values 0 to 1440 |
| systemUpdateInstallType | androidDeviceOwnerSystemUpdateInstallType | The type of system update configuration. Possible values are: deviceDefault, postpone, windowed, automatic. |
| systemWindowsBlocked | Boolean | Whether or not to block Android system prompt windows, like toasts, phone activities, and system alerts. |
| usersBlockAdd | Boolean | Indicates whether or not adding users and profiles is disabled. |
| usersBlockRemove | Boolean | Indicates whether or not to disable removing other users from the device. |
| volumeBlockAdjustment | Boolean | Indicates whether or not adjusting the master volume is disabled. |
| vpnAlwaysOnLockdownMode | Boolean | If an always on VPN package name is specified, whether or not to lock network traffic when that VPN is disconnected. |
| vpnAlwaysOnPackageIdentifier | String | Android app package name for app that will handle an always-on VPN connection. |
| wifiBlockEditConfigurations | Boolean | Indicates whether or not to block the user from editing the wifi connection settings. |
| wifiBlockEditPolicyDefinedConfigurations | Boolean | Indicates whether or not to block the user from editing just the networks defined by the policy. |
| personalProfileAppsAllowInstallFromUnknownSources | Boolean | Indicates whether the user can install apps from unknown sources on the personal profile. |
| personalProfileCameraBlocked | Boolean | Indicates whether to disable the use of the camera on the personal profile. |
| personalProfileScreenCaptureBlocked | Boolean | Indicates whether to disable the capability to take screenshots on the personal profile. |
| personalProfilePlayStoreMode | personalProfilePersonalPlayStoreMode | Used together with PersonalProfilePersonalApplications to control how apps in the personal profile are allowed or blocked. Possible values are: notConfigured, blockedApps, allowedApps. |
| personalProfilePersonalApplications | appListItem collection | Policy applied to applications in the personal profile. This collection can contain a maximum of 500 elements. |
| workProfilePasswordExpirationDays | Int32 | Indicates the number of days that a work profile password can be set before it expires and a new password will be required. Valid values 1 to 365 |
| workProfilePasswordMinimumLength | Int32 | Indicates the minimum length of the work profile password. Valid values 4 to 16 |
| workProfilePasswordMinimumNumericCharacters | Int32 | Indicates the minimum number of numeric characters required for the work profile password. Valid values 1 to 16 |
| workProfilePasswordMinimumNonLetterCharacters | Int32 | Indicates the minimum number of non-letter characters required for the work profile password. Valid values 1 to 16 |
| workProfilePasswordMinimumLetterCharacters | Int32 | Indicates the minimum number of letter characters required for the work profile password. Valid values 1 to 16 |
| workProfilePasswordMinimumLowerCaseCharacters | Int32 | Indicates the minimum number of lower-case characters required for the work profile password. Valid values 1 to 16 |
| workProfilePasswordMinimumUpperCaseCharacters | Int32 | Indicates the minimum number of upper-case letter characters required for the work profile password. Valid values 1 to 16 |
| workProfilePasswordMinimumSymbolCharacters | Int32 | Indicates the minimum number of symbol characters required for the work profile password. Valid values 1 to 16 |
| workProfilePasswordPreviousPasswordCountToBlock | Int32 | Indicates the length of the work profile password history, where the user will not be able to enter a new password that is the same as any password in the history. Valid values 0 to 24 |
| workProfilePasswordSignInFailureCountBeforeFactoryReset | Int32 | Indicates the number of times a user can enter an incorrect work profile password before the device is wiped. Valid values 4 to 11 |
| workProfilePasswordRequiredType | androidDeviceOwnerRequiredPasswordType | Indicates the minimum password quality required on the work profile password. Possible values are: deviceDefault, required, numeric, numericComplex, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, customPassword. |
| workProfilePasswordRequireUnlock | androidDeviceOwnerRequiredPasswordUnlock | Indicates the timeout period after which a work profile must be unlocked using a form of strong authentication. Possible values are: deviceDefault, daily, unkownFutureValue. |
| locateDeviceUserlessDisabled | Boolean | Indicates whether or not LocateDevice for userless (COSU) devices is disabled. |
| locateDeviceLostModeEnabled | Boolean | Indicates whether or not LocateDevice for devices with lost mode (COBO, COPE) is enabled. |
| androidDeviceOwnerDelegatedScopeAppSettings | androidDeviceOwnerDelegatedScopeAppSetting collection | Specifies the list of managed apps with app details and its associated delegated scope(s). This collection can contain a maximum of 500 elements. |
| shareDeviceLocationDisabled | Boolean | Indicates whether or not location sharing is disabled for fully managed devices (COBO), and corporate owned devices with a work profile (COPE) |
| deviceLocationMode | androidDeviceOwnerLocationMode | Indicates the location setting configuration for fully managed devices (COBO) and corporate owned devices with a work profile (COPE). Possible values are: notConfigured, disabled, unknownFutureValue. |
Response
If successful, this method returns a 200 OK response code and an updated androidDeviceOwnerGeneralDeviceConfiguration object in the response body.
Example
Request
Here is an example of the request.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 10717
{
"@odata.type": "#microsoft.graph.androidDeviceOwnerGeneralDeviceConfiguration",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"azureAdSharedDeviceDataClearApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"accountsBlockModification": true,
"appsAllowInstallFromUnknownSources": true,
"appsAutoUpdatePolicy": "userChoice",
"appsDefaultPermissionPolicy": "prompt",
"appsRecommendSkippingFirstUseHints": true,
"bluetoothBlockConfiguration": true,
"bluetoothBlockContactSharing": true,
"cameraBlocked": true,
"cellularBlockWiFiTethering": true,
"certificateCredentialConfigurationDisabled": true,
"crossProfilePoliciesAllowCopyPaste": true,
"crossProfilePoliciesAllowDataSharing": "crossProfileDataSharingBlocked",
"crossProfilePoliciesShowWorkContactsInPersonalProfile": true,
"microsoftLauncherConfigurationEnabled": true,
"microsoftLauncherCustomWallpaperEnabled": true,
"microsoftLauncherCustomWallpaperImageUrl": "https://example.com/microsoftLauncherCustomWallpaperImageUrl/",
"microsoftLauncherCustomWallpaperAllowUserModification": true,
"microsoftLauncherFeedEnabled": true,
"microsoftLauncherFeedAllowUserModification": true,
"microsoftLauncherDockPresenceConfiguration": "show",
"microsoftLauncherDockPresenceAllowUserModification": true,
"microsoftLauncherSearchBarPlacementConfiguration": "top",
"enrollmentProfile": "dedicatedDevice",
"dataRoamingBlocked": true,
"dateTimeConfigurationBlocked": true,
"detailedHelpText": {
"@odata.type": "microsoft.graph.androidDeviceOwnerUserFacingMessage",
"localizedMessages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"defaultMessage": "Default Message value"
},
"deviceOwnerLockScreenMessage": {
"@odata.type": "microsoft.graph.androidDeviceOwnerUserFacingMessage",
"localizedMessages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"defaultMessage": "Default Message value"
},
"securityCommonCriteriaModeEnabled": true,
"factoryResetDeviceAdministratorEmails": [
"Factory Reset Device Administrator Emails value"
],
"factoryResetBlocked": true,
"globalProxy": {
"@odata.type": "microsoft.graph.androidDeviceOwnerGlobalProxyAutoConfig",
"proxyAutoConfigURL": "Proxy Auto Config URL value"
},
"googleAccountsBlocked": true,
"kioskCustomizationDeviceSettingsBlocked": true,
"kioskCustomizationPowerButtonActionsBlocked": true,
"kioskCustomizationStatusBar": "notificationsAndSystemInfoEnabled",
"kioskCustomizationSystemErrorWarnings": true,
"kioskCustomizationSystemNavigation": "navigationEnabled",
"kioskModeScreenSaverConfigurationEnabled": true,
"kioskModeScreenSaverImageUrl": "https://example.com/kioskModeScreenSaverImageUrl/",
"kioskModeScreenSaverDisplayTimeInSeconds": 8,
"kioskModeScreenSaverStartDelayInSeconds": 7,
"kioskModeScreenSaverDetectMediaDisabled": true,
"kioskModeApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"kioskModeWallpaperUrl": "https://example.com/kioskModeWallpaperUrl/",
"kioskModeExitCode": "Kiosk Mode Exit Code value",
"kioskModeVirtualHomeButtonEnabled": true,
"kioskModeVirtualHomeButtonType": "swipeUp",
"kioskModeBluetoothConfigurationEnabled": true,
"kioskModeWiFiConfigurationEnabled": true,
"kioskModeFlashlightConfigurationEnabled": true,
"kioskModeMediaVolumeConfigurationEnabled": true,
"kioskModeShowDeviceInfo": true,
"kioskModeManagedSettingsEntryDisabled": true,
"kioskModeDebugMenuEasyAccessEnabled": true,
"kioskModeShowAppNotificationBadge": true,
"kioskModeScreenOrientation": "portrait",
"kioskModeIconSize": "smallest",
"kioskModeFolderIcon": "darkSquare",
"kioskModeWifiAllowedSsids": [
"Kiosk Mode Wifi Allowed Ssids value"
],
"kioskModeAppOrderEnabled": true,
"kioskModeAppsInFolderOrderedByName": true,
"kioskModeGridHeight": 3,
"kioskModeGridWidth": 2,
"kioskModeLockHomeScreen": true,
"kioskModeManagedFolders": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeManagedFolder",
"folderName": "Folder Name value",
"folderIdentifier": "Folder Identifier value",
"items": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeWeblink",
"label": "Label value",
"link": "Link value"
}
]
}
],
"kioskModeAppPositions": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeAppPositionItem",
"position": 8,
"item": {
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeWeblink",
"label": "Label value",
"link": "Link value"
}
}
],
"kioskModeManagedHomeScreenAutoSignout": true,
"kioskModeManagedHomeScreenInactiveSignOutDelayInSeconds": 7,
"kioskModeManagedHomeScreenInactiveSignOutNoticeInSeconds": 8,
"kioskModeManagedHomeScreenPinComplexity": "simple",
"kioskModeManagedHomeScreenPinRequired": true,
"kioskModeManagedHomeScreenPinRequiredToResume": true,
"kioskModeManagedHomeScreenSignInBackground": "Kiosk Mode Managed Home Screen Sign In Background value",
"kioskModeManagedHomeScreenSignInBrandingLogo": "Kiosk Mode Managed Home Screen Sign In Branding Logo value",
"kioskModeManagedHomeScreenSignInEnabled": true,
"kioskModeUseManagedHomeScreenApp": "singleAppMode",
"microphoneForceMute": true,
"networkEscapeHatchAllowed": true,
"nfcBlockOutgoingBeam": true,
"passwordBlockKeyguard": true,
"passwordBlockKeyguardFeatures": [
"camera"
],
"passwordExpirationDays": 6,
"passwordMinimumLength": 5,
"passwordMinimumLetterCharacters": 15,
"passwordMinimumLowerCaseCharacters": 2,
"passwordMinimumNonLetterCharacters": 2,
"passwordMinimumNumericCharacters": 0,
"passwordMinimumSymbolCharacters": 15,
"passwordMinimumUpperCaseCharacters": 2,
"passwordMinutesOfInactivityBeforeScreenTimeout": 14,
"passwordPreviousPasswordCountToBlock": 4,
"passwordRequiredType": "required",
"passwordRequireUnlock": "daily",
"passwordSignInFailureCountBeforeFactoryReset": 12,
"playStoreMode": "allowList",
"screenCaptureBlocked": true,
"securityDeveloperSettingsEnabled": true,
"securityRequireVerifyApps": true,
"shortHelpText": {
"@odata.type": "microsoft.graph.androidDeviceOwnerUserFacingMessage",
"localizedMessages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"defaultMessage": "Default Message value"
},
"statusBarBlocked": true,
"stayOnModes": [
"ac"
],
"storageAllowUsb": true,
"storageBlockExternalMedia": true,
"storageBlockUsbFileTransfer": true,
"systemUpdateFreezePeriods": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerSystemUpdateFreezePeriod",
"startMonth": 10,
"startDay": 8,
"endMonth": 8,
"endDay": 6
}
],
"systemUpdateWindowStartMinutesAfterMidnight": 11,
"systemUpdateWindowEndMinutesAfterMidnight": 9,
"systemUpdateInstallType": "postpone",
"systemWindowsBlocked": true,
"usersBlockAdd": true,
"usersBlockRemove": true,
"volumeBlockAdjustment": true,
"vpnAlwaysOnLockdownMode": true,
"vpnAlwaysOnPackageIdentifier": "Vpn Always On Package Identifier value",
"wifiBlockEditConfigurations": true,
"wifiBlockEditPolicyDefinedConfigurations": true,
"personalProfileAppsAllowInstallFromUnknownSources": true,
"personalProfileCameraBlocked": true,
"personalProfileScreenCaptureBlocked": true,
"personalProfilePlayStoreMode": "blockedApps",
"personalProfilePersonalApplications": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"workProfilePasswordExpirationDays": 1,
"workProfilePasswordMinimumLength": 0,
"workProfilePasswordMinimumNumericCharacters": 11,
"workProfilePasswordMinimumNonLetterCharacters": 13,
"workProfilePasswordMinimumLetterCharacters": 10,
"workProfilePasswordMinimumLowerCaseCharacters": 13,
"workProfilePasswordMinimumUpperCaseCharacters": 13,
"workProfilePasswordMinimumSymbolCharacters": 10,
"workProfilePasswordPreviousPasswordCountToBlock": 15,
"workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
"workProfilePasswordRequiredType": "required",
"workProfilePasswordRequireUnlock": "daily",
"locateDeviceUserlessDisabled": true,
"locateDeviceLostModeEnabled": true,
"androidDeviceOwnerDelegatedScopeAppSettings": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerDelegatedScopeAppSetting",
"appDetail": {
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
},
"appScopes": [
"certificateInstall"
]
}
],
"shareDeviceLocationDisabled": true,
"deviceLocationMode": "disabled"
}
Response
Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 10889
{
"@odata.type": "#microsoft.graph.androidDeviceOwnerGeneralDeviceConfiguration",
"id": "edad943d-943d-edad-3d94-aded3d94aded",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"azureAdSharedDeviceDataClearApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"accountsBlockModification": true,
"appsAllowInstallFromUnknownSources": true,
"appsAutoUpdatePolicy": "userChoice",
"appsDefaultPermissionPolicy": "prompt",
"appsRecommendSkippingFirstUseHints": true,
"bluetoothBlockConfiguration": true,
"bluetoothBlockContactSharing": true,
"cameraBlocked": true,
"cellularBlockWiFiTethering": true,
"certificateCredentialConfigurationDisabled": true,
"crossProfilePoliciesAllowCopyPaste": true,
"crossProfilePoliciesAllowDataSharing": "crossProfileDataSharingBlocked",
"crossProfilePoliciesShowWorkContactsInPersonalProfile": true,
"microsoftLauncherConfigurationEnabled": true,
"microsoftLauncherCustomWallpaperEnabled": true,
"microsoftLauncherCustomWallpaperImageUrl": "https://example.com/microsoftLauncherCustomWallpaperImageUrl/",
"microsoftLauncherCustomWallpaperAllowUserModification": true,
"microsoftLauncherFeedEnabled": true,
"microsoftLauncherFeedAllowUserModification": true,
"microsoftLauncherDockPresenceConfiguration": "show",
"microsoftLauncherDockPresenceAllowUserModification": true,
"microsoftLauncherSearchBarPlacementConfiguration": "top",
"enrollmentProfile": "dedicatedDevice",
"dataRoamingBlocked": true,
"dateTimeConfigurationBlocked": true,
"detailedHelpText": {
"@odata.type": "microsoft.graph.androidDeviceOwnerUserFacingMessage",
"localizedMessages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"defaultMessage": "Default Message value"
},
"deviceOwnerLockScreenMessage": {
"@odata.type": "microsoft.graph.androidDeviceOwnerUserFacingMessage",
"localizedMessages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"defaultMessage": "Default Message value"
},
"securityCommonCriteriaModeEnabled": true,
"factoryResetDeviceAdministratorEmails": [
"Factory Reset Device Administrator Emails value"
],
"factoryResetBlocked": true,
"globalProxy": {
"@odata.type": "microsoft.graph.androidDeviceOwnerGlobalProxyAutoConfig",
"proxyAutoConfigURL": "Proxy Auto Config URL value"
},
"googleAccountsBlocked": true,
"kioskCustomizationDeviceSettingsBlocked": true,
"kioskCustomizationPowerButtonActionsBlocked": true,
"kioskCustomizationStatusBar": "notificationsAndSystemInfoEnabled",
"kioskCustomizationSystemErrorWarnings": true,
"kioskCustomizationSystemNavigation": "navigationEnabled",
"kioskModeScreenSaverConfigurationEnabled": true,
"kioskModeScreenSaverImageUrl": "https://example.com/kioskModeScreenSaverImageUrl/",
"kioskModeScreenSaverDisplayTimeInSeconds": 8,
"kioskModeScreenSaverStartDelayInSeconds": 7,
"kioskModeScreenSaverDetectMediaDisabled": true,
"kioskModeApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"kioskModeWallpaperUrl": "https://example.com/kioskModeWallpaperUrl/",
"kioskModeExitCode": "Kiosk Mode Exit Code value",
"kioskModeVirtualHomeButtonEnabled": true,
"kioskModeVirtualHomeButtonType": "swipeUp",
"kioskModeBluetoothConfigurationEnabled": true,
"kioskModeWiFiConfigurationEnabled": true,
"kioskModeFlashlightConfigurationEnabled": true,
"kioskModeMediaVolumeConfigurationEnabled": true,
"kioskModeShowDeviceInfo": true,
"kioskModeManagedSettingsEntryDisabled": true,
"kioskModeDebugMenuEasyAccessEnabled": true,
"kioskModeShowAppNotificationBadge": true,
"kioskModeScreenOrientation": "portrait",
"kioskModeIconSize": "smallest",
"kioskModeFolderIcon": "darkSquare",
"kioskModeWifiAllowedSsids": [
"Kiosk Mode Wifi Allowed Ssids value"
],
"kioskModeAppOrderEnabled": true,
"kioskModeAppsInFolderOrderedByName": true,
"kioskModeGridHeight": 3,
"kioskModeGridWidth": 2,
"kioskModeLockHomeScreen": true,
"kioskModeManagedFolders": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeManagedFolder",
"folderName": "Folder Name value",
"folderIdentifier": "Folder Identifier value",
"items": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeWeblink",
"label": "Label value",
"link": "Link value"
}
]
}
],
"kioskModeAppPositions": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeAppPositionItem",
"position": 8,
"item": {
"@odata.type": "microsoft.graph.androidDeviceOwnerKioskModeWeblink",
"label": "Label value",
"link": "Link value"
}
}
],
"kioskModeManagedHomeScreenAutoSignout": true,
"kioskModeManagedHomeScreenInactiveSignOutDelayInSeconds": 7,
"kioskModeManagedHomeScreenInactiveSignOutNoticeInSeconds": 8,
"kioskModeManagedHomeScreenPinComplexity": "simple",
"kioskModeManagedHomeScreenPinRequired": true,
"kioskModeManagedHomeScreenPinRequiredToResume": true,
"kioskModeManagedHomeScreenSignInBackground": "Kiosk Mode Managed Home Screen Sign In Background value",
"kioskModeManagedHomeScreenSignInBrandingLogo": "Kiosk Mode Managed Home Screen Sign In Branding Logo value",
"kioskModeManagedHomeScreenSignInEnabled": true,
"kioskModeUseManagedHomeScreenApp": "singleAppMode",
"microphoneForceMute": true,
"networkEscapeHatchAllowed": true,
"nfcBlockOutgoingBeam": true,
"passwordBlockKeyguard": true,
"passwordBlockKeyguardFeatures": [
"camera"
],
"passwordExpirationDays": 6,
"passwordMinimumLength": 5,
"passwordMinimumLetterCharacters": 15,
"passwordMinimumLowerCaseCharacters": 2,
"passwordMinimumNonLetterCharacters": 2,
"passwordMinimumNumericCharacters": 0,
"passwordMinimumSymbolCharacters": 15,
"passwordMinimumUpperCaseCharacters": 2,
"passwordMinutesOfInactivityBeforeScreenTimeout": 14,
"passwordPreviousPasswordCountToBlock": 4,
"passwordRequiredType": "required",
"passwordRequireUnlock": "daily",
"passwordSignInFailureCountBeforeFactoryReset": 12,
"playStoreMode": "allowList",
"screenCaptureBlocked": true,
"securityDeveloperSettingsEnabled": true,
"securityRequireVerifyApps": true,
"shortHelpText": {
"@odata.type": "microsoft.graph.androidDeviceOwnerUserFacingMessage",
"localizedMessages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"defaultMessage": "Default Message value"
},
"statusBarBlocked": true,
"stayOnModes": [
"ac"
],
"storageAllowUsb": true,
"storageBlockExternalMedia": true,
"storageBlockUsbFileTransfer": true,
"systemUpdateFreezePeriods": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerSystemUpdateFreezePeriod",
"startMonth": 10,
"startDay": 8,
"endMonth": 8,
"endDay": 6
}
],
"systemUpdateWindowStartMinutesAfterMidnight": 11,
"systemUpdateWindowEndMinutesAfterMidnight": 9,
"systemUpdateInstallType": "postpone",
"systemWindowsBlocked": true,
"usersBlockAdd": true,
"usersBlockRemove": true,
"volumeBlockAdjustment": true,
"vpnAlwaysOnLockdownMode": true,
"vpnAlwaysOnPackageIdentifier": "Vpn Always On Package Identifier value",
"wifiBlockEditConfigurations": true,
"wifiBlockEditPolicyDefinedConfigurations": true,
"personalProfileAppsAllowInstallFromUnknownSources": true,
"personalProfileCameraBlocked": true,
"personalProfileScreenCaptureBlocked": true,
"personalProfilePlayStoreMode": "blockedApps",
"personalProfilePersonalApplications": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"workProfilePasswordExpirationDays": 1,
"workProfilePasswordMinimumLength": 0,
"workProfilePasswordMinimumNumericCharacters": 11,
"workProfilePasswordMinimumNonLetterCharacters": 13,
"workProfilePasswordMinimumLetterCharacters": 10,
"workProfilePasswordMinimumLowerCaseCharacters": 13,
"workProfilePasswordMinimumUpperCaseCharacters": 13,
"workProfilePasswordMinimumSymbolCharacters": 10,
"workProfilePasswordPreviousPasswordCountToBlock": 15,
"workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
"workProfilePasswordRequiredType": "required",
"workProfilePasswordRequireUnlock": "daily",
"locateDeviceUserlessDisabled": true,
"locateDeviceLostModeEnabled": true,
"androidDeviceOwnerDelegatedScopeAppSettings": [
{
"@odata.type": "microsoft.graph.androidDeviceOwnerDelegatedScopeAppSetting",
"appDetail": {
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
},
"appScopes": [
"certificateInstall"
]
}
],
"shareDeviceLocationDisabled": true,
"deviceLocationMode": "disabled"
}