+ Title: "Create macOSDmgApp"

+description: "Create a new macOSDmgApp object."

+localization_priority: Normal

+# Create macOSDmgApp

+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

+Create a new [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) object.

+## Prerequisites

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|DeviceManagementApps.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|DeviceManagementApps.ReadWrite.All|

+## HTTP Request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /deviceAppManagement/mobileApps

+```

+## Request headers

+|Header|Value|

+|:|:|

+|Authorization|Bearer &lt;token&gt; Required.|

+|Accept|application/json|

+## Request body

+In the request body, supply a JSON representation for the macOSDmgApp object.

+The following table shows the properties that are required when you create the macOSDmgApp.

+|Property|Type|Description|

+|:|:|:|

+|id|String|Key of the entity. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|displayName|String|The admin provided or imported title of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|description|String|The description of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|publisher|String|The publisher of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|largeIcon|[mimeContent](../resources/intune-shared-mimecontent.md)|The large icon, to be displayed in the app details and used for upload of the icon. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|createdDateTime|DateTimeOffset|The date and time the app was created. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|lastModifiedDateTime|DateTimeOffset|The date and time the app was last modified. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|isFeatured|Boolean|The value indicating whether the app is marked as featured by the admin. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|privacyInformationUrl|String|The privacy statement Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|informationUrl|String|The more information Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|owner|String|The owner of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|developer|String|The developer of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|notes|String|Notes for the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|uploadState|Int32|The upload state. Possible values are: 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|publishingState|[mobileAppPublishingState](../resources/intune-apps-mobileapppublishingstate.md)|The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md). Possible values are: `notPublished`, `processing`, `published`.|

+|isAssigned|Boolean|The value indicating whether the app is assigned to at least one group. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|roleScopeTagIds|String collection|List of scope tag ids for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|

+|fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|

+|size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|

+|primaryBundleId|String|The primary CFBundleIdentifier of the DMG.|

+|primaryBundleVersion|String|The primary CFBundleVersion of the DMG.|

+|includedApps|[macOSIncludedApp](../resources/intune-apps-macosincludedapp.md) collection|The list of apps expected to be installed by the DMG.|

+|ignoreVersionDetection|Boolean|A value indicating whether the app's version will be used to detect the app after it is installed on a device. Set this to true for apps that use a self-update feature. Set this to false to install the app when it is not already installed on the device, or if the deploying app's version number does not match the version that's already installed on the device.|

+|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.|

+## Response

+If successful, this method returns a `201 Created` response code and a [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) object in the response body.

+## Example

+### Request

+Here is an example of the request.

+``` http

+POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps

+Content-type: application/json

+Content-length: 1545

+{

+ "@odata.type": "#microsoft.graph.macOSDmgApp",

+ "displayName": "Display Name value",

+ "description": "Description value",

+ "publisher": "Publisher value",

+ "largeIcon": {

+ "@odata.type": "microsoft.graph.mimeContent",

+ "type": "Type value",

+ "value": "dmFsdWU="

+ },

+ "isFeatured": true,

+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",

+ "informationUrl": "https://example.com/informationUrl/",

+ "owner": "Owner value",

+ "developer": "Developer value",

+ "notes": "Notes value",

+ "uploadState": 11,

+ "publishingState": "processing",

+ "isAssigned": true,

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ],

+ "dependentAppCount": 1,

+ "supersedingAppCount": 3,

+ "supersededAppCount": 2,

+ "committedContentVersion": "Committed Content Version value",

+ "fileName": "File Name value",

+ "size": 4,

+ "primaryBundleId": "Primary Bundle Id value",

+ "primaryBundleVersion": "Primary Bundle Version value",

+ "includedApps": [

+ {

+ "@odata.type": "microsoft.graph.macOSIncludedApp",

+ "bundleId": "Bundle Id value",

+ "bundleVersion": "Bundle Version value"

+ }

+ ],

+ "ignoreVersionDetection": true,

+ "minimumSupportedOperatingSystem": {

+ "@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",

+ "v10_7": true,

+ "v10_8": true,

+ "v10_9": true,

+ "v10_10": true,

+ "v10_11": true,

+ "v10_12": true,

+ "v10_13": true,

+ "v10_14": true,

+ "v10_15": true,

+ "v11_0": true,

+ "v12_0": true

+ }

+}

+```

+### 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

+HTTP/1.1 201 Created

+Content-Type: application/json

+Content-Length: 1717

+{

+ "@odata.type": "#microsoft.graph.macOSDmgApp",

+ "id": "5f40a691-a691-5f40-91a6-405f91a6405f",

+ "displayName": "Display Name value",

+ "description": "Description value",

+ "publisher": "Publisher value",

+ "largeIcon": {

+ "@odata.type": "microsoft.graph.mimeContent",

+ "type": "Type value",

+ "value": "dmFsdWU="

+ },

+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",

+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",

+ "isFeatured": true,

+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",

+ "informationUrl": "https://example.com/informationUrl/",

+ "owner": "Owner value",

+ "developer": "Developer value",

+ "notes": "Notes value",

+ "uploadState": 11,

+ "publishingState": "processing",

+ "isAssigned": true,

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ],

+ "dependentAppCount": 1,

+ "supersedingAppCount": 3,

+ "supersededAppCount": 2,

+ "committedContentVersion": "Committed Content Version value",

+ "fileName": "File Name value",

+ "size": 4,

+ "primaryBundleId": "Primary Bundle Id value",

+ "primaryBundleVersion": "Primary Bundle Version value",

+ "includedApps": [

+ {

+ "@odata.type": "microsoft.graph.macOSIncludedApp",

+ "bundleId": "Bundle Id value",

+ "bundleVersion": "Bundle Version value"

+ }

+ ],

+ "ignoreVersionDetection": true,

+ "minimumSupportedOperatingSystem": {

+ "@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",

+ "v10_7": true,

+ "v10_8": true,

+ "v10_9": true,

+ "v10_10": true,

+ "v10_11": true,

+ "v10_12": true,

+ "v10_13": true,

+ "v10_14": true,

+ "v10_15": true,

+ "v11_0": true,

+ "v12_0": true

+ }

+}

+```

+ Title: "Delete macOSDmgApp"

+description: "Deletes a macOSDmgApp."

+localization_priority: Normal

+# Delete macOSDmgApp

+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

+Deletes a [macOSDmgApp](../resources/intune-apps-macosdmgapp.md).

+## Prerequisites

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|DeviceManagementApps.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|DeviceManagementApps.ReadWrite.All|

+## HTTP Request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+DELETE /deviceAppManagement/mobileApps/{mobileAppId}

+DELETE /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app

+DELETE /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app

+```

+## Request headers

+|Header|Value|

+|:|:|

+|Authorization|Bearer &lt;token&gt; Required.|

+|Accept|application/json|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `204 No Content` response code.

+## Example

+### Request

+Here is an example of the request.

+``` http

+DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}

+```

+### 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

+HTTP/1.1 204 No Content

+```

+ Title: "Get macOSDmgApp"

+description: "Read properties and relationships of the macOSDmgApp object."

+localization_priority: Normal

+# Get macOSDmgApp

+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

+Read properties and relationships of the [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) object.

+## Prerequisites

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

+## HTTP Request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /deviceAppManagement/mobileApps/{mobileAppId}

+GET /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app

+GET /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app

+```

+## Optional query parameters

+This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.

+## Request headers

+|Header|Value|

+|:|:|

+|Authorization|Bearer &lt;token&gt; Required.|

+|Accept|application/json|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) object in the response body.

+## Example

+### Request

+Here is an example of the request.

+``` http

+GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}

+```

+### 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

+HTTP/1.1 200 OK

+Content-Type: application/json

+Content-Length: 1844

+{

+ "value": {

+ "@odata.type": "#microsoft.graph.macOSDmgApp",

+ "id": "5f40a691-a691-5f40-91a6-405f91a6405f",

+ "displayName": "Display Name value",

+ "description": "Description value",

+ "publisher": "Publisher value",

+ "largeIcon": {

+ "@odata.type": "microsoft.graph.mimeContent",

+ "type": "Type value",

+ "value": "dmFsdWU="

+ },

+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",

+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",

+ "isFeatured": true,

+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",

+ "informationUrl": "https://example.com/informationUrl/",

+ "owner": "Owner value",

+ "developer": "Developer value",

+ "notes": "Notes value",

+ "uploadState": 11,

+ "publishingState": "processing",

+ "isAssigned": true,

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ],

+ "dependentAppCount": 1,

+ "supersedingAppCount": 3,

+ "supersededAppCount": 2,

+ "committedContentVersion": "Committed Content Version value",

+ "fileName": "File Name value",

+ "size": 4,

+ "primaryBundleId": "Primary Bundle Id value",

+ "primaryBundleVersion": "Primary Bundle Version value",

+ "includedApps": [

+ {

+ "@odata.type": "microsoft.graph.macOSIncludedApp",

+ "bundleId": "Bundle Id value",

+ "bundleVersion": "Bundle Version value"

+ }

+ ],

+ "ignoreVersionDetection": true,

+ "minimumSupportedOperatingSystem": {

+ "@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",

+ "v10_7": true,

+ "v10_8": true,

+ "v10_9": true,

+ "v10_10": true,

+ "v10_11": true,

+ "v10_12": true,

+ "v10_13": true,

+ "v10_14": true,

+ "v10_15": true,

+ "v11_0": true,

+ "v12_0": true

+ }

+ }

+}

+```

+ Title: "List macOSDmgApps"

+description: "List properties and relationships of the macOSDmgApp objects."

+localization_priority: Normal

+# List macOSDmgApps

+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

+List properties and relationships of the [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) objects.

+## Prerequisites

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

+## HTTP Request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /deviceAppManagement/mobileApps

+```

+## Request headers

+|Header|Value|

+|:|:|

+|Authorization|Bearer &lt;token&gt; Required.|

+|Accept|application/json|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a collection of [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) objects in the response body.

+## Example

+### Request

+Here is an example of the request.

+``` http

+GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps

+```

+### 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

+HTTP/1.1 200 OK

+Content-Type: application/json

+Content-Length: 1966

+{

+ "value": [

+ {

+ "@odata.type": "#microsoft.graph.macOSDmgApp",

+ "id": "5f40a691-a691-5f40-91a6-405f91a6405f",

+ "displayName": "Display Name value",

+ "description": "Description value",

+ "publisher": "Publisher value",

+ "largeIcon": {

+ "@odata.type": "microsoft.graph.mimeContent",

+ "type": "Type value",

+ "value": "dmFsdWU="

+ },

+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",

+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",

+ "isFeatured": true,

+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",

+ "informationUrl": "https://example.com/informationUrl/",

+ "owner": "Owner value",

+ "developer": "Developer value",

+ "notes": "Notes value",

+ "uploadState": 11,

+ "publishingState": "processing",

+ "isAssigned": true,

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ],

+ "dependentAppCount": 1,

+ "supersedingAppCount": 3,

+ "supersededAppCount": 2,

+ "committedContentVersion": "Committed Content Version value",

+ "fileName": "File Name value",

+ "size": 4,

+ "primaryBundleId": "Primary Bundle Id value",

+ "primaryBundleVersion": "Primary Bundle Version value",

+ "includedApps": [

+ {

+ "@odata.type": "microsoft.graph.macOSIncludedApp",

+ "bundleId": "Bundle Id value",

+ "bundleVersion": "Bundle Version value"

+ }

+ ],

+ "ignoreVersionDetection": true,

+ "minimumSupportedOperatingSystem": {

+ "@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",

+ "v10_7": true,

+ "v10_8": true,

+ "v10_9": true,

+ "v10_10": true,

+ "v10_11": true,

+ "v10_12": true,

+ "v10_13": true,

+ "v10_14": true,

+ "v10_15": true,

+ "v11_0": true,

+ "v12_0": true

+ }

+ }

+ ]

+}

+```

+ Title: "Update macOSDmgApp"

+description: "Update the properties of a macOSDmgApp object."

+localization_priority: Normal

+# Update macOSDmgApp

+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

+Update the properties of a [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) object.

+## Prerequisites

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|DeviceManagementApps.ReadWrite.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|DeviceManagementApps.ReadWrite.All|

+## HTTP Request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+PATCH /deviceAppManagement/mobileApps/{mobileAppId}

+PATCH /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app

+PATCH /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app

+```

+## Request headers

+|Header|Value|

+|:|:|

+|Authorization|Bearer &lt;token&gt; Required.|

+|Accept|application/json|

+## Request body

+In the request body, supply a JSON representation for the [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) object.

+The following table shows the properties that are required when you create the [macOSDmgApp](../resources/intune-apps-macosdmgapp.md).

+|Property|Type|Description|

+|:|:|:|

+|id|String|Key of the entity. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|displayName|String|The admin provided or imported title of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|description|String|The description of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|publisher|String|The publisher of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|largeIcon|[mimeContent](../resources/intune-shared-mimecontent.md)|The large icon, to be displayed in the app details and used for upload of the icon. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|createdDateTime|DateTimeOffset|The date and time the app was created. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|lastModifiedDateTime|DateTimeOffset|The date and time the app was last modified. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|isFeatured|Boolean|The value indicating whether the app is marked as featured by the admin. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|privacyInformationUrl|String|The privacy statement Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|informationUrl|String|The more information Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|owner|String|The owner of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|developer|String|The developer of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|notes|String|Notes for the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|uploadState|Int32|The upload state. Possible values are: 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|publishingState|[mobileAppPublishingState](../resources/intune-apps-mobileapppublishingstate.md)|The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md). Possible values are: `notPublished`, `processing`, `published`.|

+|isAssigned|Boolean|The value indicating whether the app is assigned to at least one group. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|roleScopeTagIds|String collection|List of scope tag ids for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|

+|fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|

+|size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|

+|primaryBundleId|String|The primary CFBundleIdentifier of the DMG.|

+|primaryBundleVersion|String|The primary CFBundleVersion of the DMG.|

+|includedApps|[macOSIncludedApp](../resources/intune-apps-macosincludedapp.md) collection|The list of apps expected to be installed by the DMG.|

+|ignoreVersionDetection|Boolean|A value indicating whether the app's version will be used to detect the app after it is installed on a device. Set this to true for apps that use a self-update feature. Set this to false to install the app when it is not already installed on the device, or if the deploying app's version number does not match the version that's already installed on the device.|

+|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.|

+## Response

+If successful, this method returns a `200 OK` response code and an updated [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) object in the response body.

+## Example

+### Request

+Here is an example of the request.

+``` http

+PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}

+Content-type: application/json

+Content-length: 1545

+{

+ "@odata.type": "#microsoft.graph.macOSDmgApp",

+ "displayName": "Display Name value",

+ "description": "Description value",

+ "publisher": "Publisher value",

+ "largeIcon": {

+ "@odata.type": "microsoft.graph.mimeContent",

+ "type": "Type value",

+ "value": "dmFsdWU="

+ },

+ "isFeatured": true,

+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",

+ "informationUrl": "https://example.com/informationUrl/",

+ "owner": "Owner value",

+ "developer": "Developer value",

+ "notes": "Notes value",

+ "uploadState": 11,

+ "publishingState": "processing",

+ "isAssigned": true,

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ],

+ "dependentAppCount": 1,

+ "supersedingAppCount": 3,

+ "supersededAppCount": 2,

+ "committedContentVersion": "Committed Content Version value",

+ "fileName": "File Name value",

+ "size": 4,

+ "primaryBundleId": "Primary Bundle Id value",

+ "primaryBundleVersion": "Primary Bundle Version value",

+ "includedApps": [

+ {

+ "@odata.type": "microsoft.graph.macOSIncludedApp",

+ "bundleId": "Bundle Id value",

+ "bundleVersion": "Bundle Version value"

+ }

+ ],

+ "ignoreVersionDetection": true,

+ "minimumSupportedOperatingSystem": {

+ "@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",

+ "v10_7": true,

+ "v10_8": true,

+ "v10_9": true,

+ "v10_10": true,

+ "v10_11": true,

+ "v10_12": true,

+ "v10_13": true,

+ "v10_14": true,

+ "v10_15": true,

+ "v11_0": true,

+ "v12_0": true

+ }

+}

+```

+### 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

+HTTP/1.1 200 OK

+Content-Type: application/json

+Content-Length: 1717

+{

+ "@odata.type": "#microsoft.graph.macOSDmgApp",

+ "id": "5f40a691-a691-5f40-91a6-405f91a6405f",

+ "displayName": "Display Name value",

+ "description": "Description value",

+ "publisher": "Publisher value",

+ "largeIcon": {

+ "@odata.type": "microsoft.graph.mimeContent",

+ "type": "Type value",

+ "value": "dmFsdWU="

+ },

+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",

+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",

+ "isFeatured": true,

+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",

+ "informationUrl": "https://example.com/informationUrl/",

+ "owner": "Owner value",

+ "developer": "Developer value",

+ "notes": "Notes value",

+ "uploadState": 11,

+ "publishingState": "processing",

+ "isAssigned": true,

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ],

+ "dependentAppCount": 1,

+ "supersedingAppCount": 3,

+ "supersededAppCount": 2,

+ "committedContentVersion": "Committed Content Version value",

+ "fileName": "File Name value",

+ "size": 4,

+ "primaryBundleId": "Primary Bundle Id value",

+ "primaryBundleVersion": "Primary Bundle Version value",

+ "includedApps": [

+ {

+ "@odata.type": "microsoft.graph.macOSIncludedApp",

+ "bundleId": "Bundle Id value",

+ "bundleVersion": "Bundle Version value"

+ }

+ ],

+ "ignoreVersionDetection": true,

+ "minimumSupportedOperatingSystem": {

+ "@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",

+ "v10_7": true,

+ "v10_8": true,

+ "v10_9": true,

+ "v10_10": true,

+ "v10_11": true,

+ "v10_12": true,

+ "v10_13": true,

+ "v10_14": true,

+ "v10_15": true,

+ "v11_0": true,

+ "v12_0": true

+ }

+}

+```

+|systemUpdateFreezePeriods|[androidDeviceOwnerSystemUpdateFreezePeriod](../resources/intune-deviceconfig-androiddeviceownersystemupdatefreezeperiod.md) collection|Indicates the annually repeating time periods during which system updates are postponed. This collection can contain a maximum of 500 elements.|

+Content-length: 8916

+ "systemUpdateFreezePeriods": [

+ {

+ "@odata.type": "microsoft.graph.androidDeviceOwnerSystemUpdateFreezePeriod",

+ "startMonth": 10,

+ "startDay": 8,

+ "endMonth": 8,

+ "endDay": 6

+ }

+ ],

+Content-Length: 9088

+ "systemUpdateFreezePeriods": [

+ {

+ "@odata.type": "microsoft.graph.androidDeviceOwnerSystemUpdateFreezePeriod",

+ "startMonth": 10,

+ "startDay": 8,

+ "endMonth": 8,

+ "endDay": 6

+ }

+ ],

+Content-Length: 9557

+ "systemUpdateFreezePeriods": [

+ {

+ "@odata.type": "microsoft.graph.androidDeviceOwnerSystemUpdateFreezePeriod",

+ "startMonth": 10,

+ "startDay": 8,

+ "endMonth": 8,

+ "endDay": 6

+ }

+ ],

+Content-Length: 10021

+ "systemUpdateFreezePeriods": [

+ {

+ "@odata.type": "microsoft.graph.androidDeviceOwnerSystemUpdateFreezePeriod",

+ "startMonth": 10,

+ "startDay": 8,

+ "endMonth": 8,

+ "endDay": 6

+ }

+ ],

+|systemUpdateFreezePeriods|[androidDeviceOwnerSystemUpdateFreezePeriod](../resources/intune-deviceconfig-androiddeviceownersystemupdatefreezeperiod.md) collection|Indicates the annually repeating time periods during which system updates are postponed. This collection can contain a maximum of 500 elements.|

+Content-length: 8916

+ "systemUpdateFreezePeriods": [

+ {

+ "@odata.type": "microsoft.graph.androidDeviceOwnerSystemUpdateFreezePeriod",

+ "startMonth": 10,

+ "startDay": 8,

+ "endMonth": 8,

+ "endDay": 6

+ }

+ ],

+Content-Length: 9088

+ "systemUpdateFreezePeriods": [

+ {

+ "@odata.type": "microsoft.graph.androidDeviceOwnerSystemUpdateFreezePeriod",

+ "startMonth": 10,

+ "startDay": 8,

+ "endMonth": 8,

+ "endDay": 6

+ }

+ ],

+Content-length: 1587

+Content-Length: 1759

+Content-Length: 1870

+Content-Length: 1976

+Content-length: 1587

+Content-Length: 1759

+ Title: "assignHardwareConfiguration action"

+description: "Not yet documented"

+localization_priority: Normal

+# assignHardwareConfiguration action

+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

+Not yet documented

+## Prerequisites

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|DeviceManagementConfiguration.Read.All|

+## HTTP Request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /deviceManagement/hardwareConfigurations/{hardwareConfigurationId}/assignHardwareConfiguration

+```

+## Request headers

+|Header|Value|

+|:|:|

+|Authorization|Bearer &lt;token&gt; Required.|

+|Accept|application/json|

+## Request body

+In the request body, supply JSON representation of the parameters.

+The following table shows the parameters that can be used with this action.

+|Property|Type|Description|

+|:|:|:|

+|hardwareConfigurationAssignments|[hardwareConfigurationAssignment](../resources/intune-deviceconfig-hardwareconfigurationassignment.md) collection|Not yet documented|

+## Response

+If successful, this action returns a `200 OK` response code and a [hardwareConfigurationAssignment](../resources/intune-deviceconfig-hardwareconfigurationassignment.md) collection in the response body.

+## Example

+### Request

+Here is an example of the request.

+``` http

+POST https://graph.microsoft.com/beta/deviceManagement/hardwareConfigurations/{hardwareConfigurationId}/assignHardwareConfiguration

+Content-type: application/json

+Content-length: 531

+{

+ "hardwareConfigurationAssignments": [

+ {

+ "@odata.type": "#microsoft.graph.hardwareConfigurationAssignment",

+ "id": "2ab8e97c-e97c-2ab8-7ce9-b82a7ce9b82a",

+ "target": {

+ "@odata.type": "microsoft.graph.configurationManagerCollectionAssignmentTarget",

+ "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value",

+ "deviceAndAppManagementAssignmentFilterType": "include",

+ "collectionId": "Collection Id value"

+ }

+ }

+ ]

+}

+```

+### 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

+HTTP/1.1 200 OK

+Content-Type: application/json

+Content-Length: 504

+{

+ "value": [

+ {

+ "@odata.type": "#microsoft.graph.hardwareConfigurationAssignment",

+ "id": "2ab8e97c-e97c-2ab8-7ce9-b82a7ce9b82a",

+ "target": {

+ "@odata.type": "microsoft.graph.configurationManagerCollectionAssignmentTarget",

+ "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value",

+ "deviceAndAppManagementAssignmentFilterType": "include",

+ "collectionId": "Collection Id value"

+ }

+ }

+ ]

+}

+```

+|upn|String|User Principal Name (UPN).|

+|userEmail|String|User Email address.|

+|successfulDeviceCount|Int32|Success device count for specific user.|

+|failedDeviceCount|Int32|Failed device count for specific user.|

+|upn|String|User Principal Name (UPN).|

+|userEmail|String|User Email address.|

+|successfulDeviceCount|Int32|Success device count for specific user.|

+|failedDeviceCount|Int32|Failed device count for specific user.|

+|advancedThreatProtectionRealTime|[enablement](../resources/intune-shared-enablement.md)|Determines whether or not to enable real-time protection for Microsoft Defender Advanced Threat Protection on macOS. Possible values are: `notConfigured`, `enabled`, `disabled`.|

+|advancedThreatProtectionCloudDelivered|[enablement](../resources/intune-shared-enablement.md)|Determines whether or not to enable cloud-delivered protection for Microsoft Defender Advanced Threat Protection on macOS. Possible values are: `notConfigured`, `enabled`, `disabled`.|

+|advancedThreatProtectionAutomaticSampleSubmission|[enablement](../resources/intune-shared-enablement.md)|Determines whether or not to enable automatic file sample submission for Microsoft Defender Advanced Threat Protection on macOS. Possible values are: `notConfigured`, `enabled`, `disabled`.|

+|advancedThreatProtectionDiagnosticDataCollection|[enablement](../resources/intune-shared-enablement.md)|Determines whether or not to enable diagnostic and usage data collection for Microsoft Defender Advanced Threat Protection on macOS. Possible values are: `notConfigured`, `enabled`, `disabled`.|

+|advancedThreatProtectionExcludedFolders|String collection|A list of paths to folders to exclude from antivirus scanning for Microsoft Defender Advanced Threat Protection on macOS.|

+|advancedThreatProtectionExcludedFiles|String collection|A list of paths to files to exclude from antivirus scanning for Microsoft Defender Advanced Threat Protection on macOS.|

+|advancedThreatProtectionExcludedExtensions|String collection|A list of file extensions to exclude from antivirus scanning for Microsoft Defender Advanced Threat Protection on macOS.|

+|advancedThreatProtectionExcludedProcesses|String collection|A list of process names to exclude from antivirus scanning for Microsoft Defender Advanced Threat Protection on macOS.|

+|advancedThreatProtectionRealTime|[enablement](../resources/intune-shared-enablement.md)|Determines whether or not to enable real-time protection for Microsoft Defender Advanced Threat Protection on macOS. Possible values are: `notConfigured`, `enabled`, `disabled`.|

+|advancedThreatProtectionCloudDelivered|[enablement](../resources/intune-shared-enablement.md)|Determines whether or not to enable cloud-delivered protection for Microsoft Defender Advanced Threat Protection on macOS. Possible values are: `notConfigured`, `enabled`, `disabled`.|

+|advancedThreatProtectionAutomaticSampleSubmission|[enablement](../resources/intune-shared-enablement.md)|Determines whether or not to enable automatic file sample submission for Microsoft Defender Advanced Threat Protection on macOS. Possible values are: `notConfigured`, `enabled`, `disabled`.|

+|advancedThreatProtectionDiagnosticDataCollection|[enablement](../resources/intune-shared-enablement.md)|Determines whether or not to enable diagnostic and usage data collection for Microsoft Defender Advanced Threat Protection on macOS. Possible values are: `notConfigured`, `enabled`, `disabled`.|

+|advancedThreatProtectionExcludedFolders|String collection|A list of paths to folders to exclude from antivirus scanning for Microsoft Defender Advanced Threat Protection on macOS.|

+|advancedThreatProtectionExcludedFiles|String collection|A list of paths to files to exclude from antivirus scanning for Microsoft Defender Advanced Threat Protection on macOS.|

+|advancedThreatProtectionExcludedExtensions|String collection|A list of file extensions to exclude from antivirus scanning for Microsoft Defender Advanced Threat Protection on macOS.|

+|advancedThreatProtectionExcludedProcesses|String collection|A list of process names to exclude from antivirus scanning for Microsoft Defender Advanced Threat Protection on macOS.|

+|iCloudDesktopAndDocumentsBlocked|Boolean|When TRUE the synchronization of cloud desktop and documents is blocked. When FALSE, synchronization of the cloud desktop and documents are allowed. Available for devices running macOS 10.12.4 and later.|

+Content-length: 5014

+ "iCloudPrivateRelayBlocked": true,

+ "iCloudDesktopAndDocumentsBlocked": true

+Content-Length: 5186

+ "iCloudPrivateRelayBlocked": true,

+ "iCloudDesktopAndDocumentsBlocked": true

+Content-Length: 5483

+ "iCloudPrivateRelayBlocked": true,

+ "iCloudDesktopAndDocumentsBlocked": true

+Content-Length: 5775

+ "iCloudPrivateRelayBlocked": true,

+ "iCloudDesktopAndDocumentsBlocked": true

+|iCloudDesktopAndDocumentsBlocked|Boolean|When TRUE the synchronization of cloud desktop and documents is blocked. When FALSE, synchronization of the cloud desktop and documents are allowed. Available for devices running macOS 10.12.4 and later.|

+Content-length: 5014

+ "iCloudPrivateRelayBlocked": true,

+ "iCloudDesktopAndDocumentsBlocked": true

+Content-Length: 5186

+ "iCloudPrivateRelayBlocked": true,

+ "iCloudDesktopAndDocumentsBlocked": true

+|criticalUpdateBehavior|[macOSSoftwareUpdateBehavior](../resources/intune-deviceconfig-macossoftwareupdatebehavior.md)|Update behavior for critical updates. Possible values are: `notConfigured`, `default`, `downloadOnly`, `installASAP`, `notifyOnly`, `installLater`.|

+|configDataUpdateBehavior|[macOSSoftwareUpdateBehavior](../resources/intune-deviceconfig-macossoftwareupdatebehavior.md)|Update behavior for configuration data file updates. Possible values are: `notConfigured`, `default`, `downloadOnly`, `installASAP`, `notifyOnly`, `installLater`.|

+|firmwareUpdateBehavior|[macOSSoftwareUpdateBehavior](../resources/intune-deviceconfig-macossoftwareupdatebehavior.md)|Update behavior for firmware updates. Possible values are: `notConfigured`, `default`, `downloadOnly`, `installASAP`, `notifyOnly`, `installLater`.|

+|allOtherUpdateBehavior|[macOSSoftwareUpdateBehavior](../resources/intune-deviceconfig-macossoftwareupdatebehavior.md)|Update behavior for all other updates. Possible values are: `notConfigured`, `default`, `downloadOnly`, `installASAP`, `notifyOnly`, `installLater`.|

+|criticalUpdateBehavior|[macOSSoftwareUpdateBehavior](../resources/intune-deviceconfig-macossoftwareupdatebehavior.md)|Update behavior for critical updates. Possible values are: `notConfigured`, `default`, `downloadOnly`, `installASAP`, `notifyOnly`, `installLater`.|

+|configDataUpdateBehavior|[macOSSoftwareUpdateBehavior](../resources/intune-deviceconfig-macossoftwareupdatebehavior.md)|Update behavior for configuration data file updates. Possible values are: `notConfigured`, `default`, `downloadOnly`, `installASAP`, `notifyOnly`, `installLater`.|

+|firmwareUpdateBehavior|[macOSSoftwareUpdateBehavior](../resources/intune-deviceconfig-macossoftwareupdatebehavior.md)|Update behavior for firmware updates. Possible values are: `notConfigured`, `default`, `downloadOnly`, `installASAP`, `notifyOnly`, `installLater`.|

+|allOtherUpdateBehavior|[macOSSoftwareUpdateBehavior](../resources/intune-deviceconfig-macossoftwareupdatebehavior.md)|Update behavior for all other updates. Possible values are: `notConfigured`, `default`, `downloadOnly`, `installASAP`, `notifyOnly`, `installLater`.|

+description: "Play lost mode sound"

+Play lost mode sound

+In the request body, supply JSON representation of the parameters.

+The following table shows the parameters that can be used with this action.

+|Property|Type|Description|

+|:|:|:|

+|durationInMinutes|String|Not yet documented|

+Content-type: application/json

+Content-length: 56

+{

+ "durationInMinutes": "Duration In Minutes value"

+}

+|workFromAnywhereScore|Int32|The User experience analytics work from anywhere score.|

+|workFromAnywhereTotalDevices|Int32|The total device count of the user experience analytics category work from anywhere.|

+Content-length: 555

+ "workFromAnywhereScore": 5,

+ "workFromAnywhereTotalDevices": 12,

+Content-Length: 604

+ "workFromAnywhereScore": 5,

+ "workFromAnywhereTotalDevices": 12,

+Content-Length: 657

+ "workFromAnywhereScore": 5,

+ "workFromAnywhereTotalDevices": 12,

+Content-Length: 705

+ "workFromAnywhereScore": 5,

+ "workFromAnywhereTotalDevices": 12,

+|workFromAnywhereScore|Int32|The User experience analytics work from anywhere score.|

+|workFromAnywhereTotalDevices|Int32|The total device count of the user experience analytics category work from anywhere.|

+Content-length: 555

+ "workFromAnywhereScore": 5,

+ "workFromAnywhereTotalDevices": 12,

+Content-Length: 604

+ "workFromAnywhereScore": 5,

+ "workFromAnywhereTotalDevices": 12,

+ "runSchedule": {

+ "@odata.type": "microsoft.graph.runSchedule"

+ },

+ "runSchedule": {

+ "@odata.type": "microsoft.graph.runSchedule"

+ },

+ Title: "syncInventory action"

+description: "Sync the driver inventory of a WindowsDriverUpdateProfile."

+localization_priority: Normal

+# syncInventory action

+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

+Sync the driver inventory of a WindowsDriverUpdateProfile.

+## Prerequisites

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|DeviceManagementConfiguration.Read.All|

+## HTTP Request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /deviceManagement/windowsDriverUpdateProfiles/{windowsDriverUpdateProfileId}/syncInventory

+```

+## Request headers

+|Header|Value|

+|:|:|

+|Authorization|Bearer &lt;token&gt; Required.|

+|Accept|application/json|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this action returns a `204 No Content` response code.

+## Example

+### Request

+Here is an example of the request.

+``` http

+POST https://graph.microsoft.com/beta/deviceManagement/windowsDriverUpdateProfiles/{windowsDriverUpdateProfileId}/syncInventory

+```

+### 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

+HTTP/1.1 204 No Content

+```

+|[validateProperties](../api/directoryobject-validateproperties.md)|JSON| Validate a Microsoft 365 group's display name or mail nickname complies with naming policies. |

+None.

+- [macOS dmg app](intune-apps-macosdmgapp.md)

+- [macOS included app](intune-apps-macosincludedapp.md)

+ Title: "macOSDmgApp resource type"

+description: "Contains properties and inherited properties for the MacOS DMG App."

+localization_priority: Normal

+# macOSDmgApp resource type

+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

+Contains properties and inherited properties for the MacOS DMG App.

+Inherits from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)

+## Methods

+|Method|Return Type|Description|

+|:|:|:|

+|[List macOSDmgApps](../api/intune-apps-macosdmgapp-list.md)|[macOSDmgApp](../resources/intune-apps-macosdmgapp.md) collection|List properties and relationships of the [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) objects.|

+|[Get macOSDmgApp](../api/intune-apps-macosdmgapp-get.md)|[macOSDmgApp](../resources/intune-apps-macosdmgapp.md)|Read properties and relationships of the [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) object.|

+|[Create macOSDmgApp](../api/intune-apps-macosdmgapp-create.md)|[macOSDmgApp](../resources/intune-apps-macosdmgapp.md)|Create a new [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) object.|

+|[Delete macOSDmgApp](../api/intune-apps-macosdmgapp-delete.md)|None|Deletes a [macOSDmgApp](../resources/intune-apps-macosdmgapp.md).|

+|[Update macOSDmgApp](../api/intune-apps-macosdmgapp-update.md)|[macOSDmgApp](../resources/intune-apps-macosdmgapp.md)|Update the properties of a [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) object.|

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|id|String|Key of the entity. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|displayName|String|The admin provided or imported title of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|description|String|The description of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|publisher|String|The publisher of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|largeIcon|[mimeContent](../resources/intune-shared-mimecontent.md)|The large icon, to be displayed in the app details and used for upload of the icon. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|createdDateTime|DateTimeOffset|The date and time the app was created. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|lastModifiedDateTime|DateTimeOffset|The date and time the app was last modified. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|isFeatured|Boolean|The value indicating whether the app is marked as featured by the admin. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|privacyInformationUrl|String|The privacy statement Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|informationUrl|String|The more information Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|owner|String|The owner of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|developer|String|The developer of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|notes|String|Notes for the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|uploadState|Int32|The upload state. Possible values are: 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|publishingState|[mobileAppPublishingState](../resources/intune-apps-mobileapppublishingstate.md)|The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md). Possible values are: `notPublished`, `processing`, `published`.|

+|isAssigned|Boolean|The value indicating whether the app is assigned to at least one group. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|roleScopeTagIds|String collection|List of scope tag ids for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|

+|fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|

+|size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|

+|primaryBundleId|String|The primary CFBundleIdentifier of the DMG.|

+|primaryBundleVersion|String|The primary CFBundleVersion of the DMG.|

+|includedApps|[macOSIncludedApp](../resources/intune-apps-macosincludedapp.md) collection|The list of apps expected to be installed by the DMG.|

+|ignoreVersionDetection|Boolean|A value indicating whether the app's version will be used to detect the app after it is installed on a device. Set this to true for apps that use a self-update feature. Set this to false to install the app when it is not already installed on the device, or if the deploying app's version number does not match the version that's already installed on the device.|

+|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.|

+## Relationships

+|Relationship|Type|Description|

+|:|:|:|

+|categories|[mobileAppCategory](../resources/intune-apps-mobileappcategory.md) collection|The list of categories for this app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|assignments|[mobileAppAssignment](../resources/intune-apps-mobileappassignment.md) collection|The list of group assignments for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|installSummary|[mobileAppInstallSummary](../resources/intune-apps-mobileappinstallsummary.md)|Mobile App Install Summary. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|deviceStatuses|[mobileAppInstallStatus](../resources/intune-apps-mobileappinstallstatus.md) collection|The list of installation states for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|userStatuses|[userAppInstallStatus](../resources/intune-apps-userappinstallstatus.md) collection|The list of installation states for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|relationships|[mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md) collection|The set of direct relationships for this app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|

+|contentVersions|[mobileAppContent](../resources/intune-apps-mobileappcontent.md) collection|The list of content versions for this app. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|

+## JSON Representation

+Here is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.macOSDmgApp"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.macOSDmgApp",

+ "id": "String (identifier)",

+ "displayName": "String",

+ "description": "String",

+ "publisher": "String",

+ "largeIcon": {

+ "@odata.type": "microsoft.graph.mimeContent",

+ "type": "String",

+ "value": "binary"

+ },

+ "createdDateTime": "String (timestamp)",

+ "lastModifiedDateTime": "String (timestamp)",

+ "isFeatured": true,

+ "privacyInformationUrl": "String",

+ "informationUrl": "String",

+ "owner": "String",

+ "developer": "String",

+ "notes": "String",

+ "uploadState": 1024,

+ "publishingState": "String",

+ "isAssigned": true,

+ "roleScopeTagIds": [

+ "String"

+ ],

+ "dependentAppCount": 1024,

+ "supersedingAppCount": 1024,

+ "supersededAppCount": 1024,

+ "committedContentVersion": "String",

+ "fileName": "String",

+ "size": 1024,

+ "primaryBundleId": "String",

+ "primaryBundleVersion": "String",

+ "includedApps": [

+ {

+ "@odata.type": "microsoft.graph.macOSIncludedApp",

+ "bundleId": "String",

+ "bundleVersion": "String"

+ }

+ ],

+ "ignoreVersionDetection": true,

+ "minimumSupportedOperatingSystem": {

+ "@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",

+ "v10_7": true,

+ "v10_8": true,

+ "v10_9": true,

+ "v10_10": true,

+ "v10_11": true,

+ "v10_12": true,

+ "v10_13": true,

+ "v10_14": true,

+ "v10_15": true,

+ "v11_0": true,

+ "v12_0": true

+ }

+}

+```

+ Title: "macOSIncludedApp resource type"

+description: "Contains properties of an included .app in a MacOS app."

+localization_priority: Normal

+# macOSIncludedApp resource type

+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

+Contains properties of an included .app in a MacOS app.

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|bundleId|String|The CFBundleIdentifier.|

+|bundleVersion|String|The CFBundleVersion.|

+## Relationships

+None

+## JSON Representation

+Here is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.macOSIncludedApp"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.macOSIncludedApp",

+ "bundleId": "String",

+ "bundleVersion": "String"

+}

+```

+description: "Contains properties and inherited properties for the macOS Microsoft Defender Advanced Threat Protection (MDATP) App."

+Contains properties and inherited properties for the macOS Microsoft Defender Advanced Threat Protection (MDATP) App.

+- [Android device owner system update freeze period](intune-deviceconfig-androiddeviceownersystemupdatefreezeperiod.md)

+|systemUpdateFreezePeriods|[androidDeviceOwnerSystemUpdateFreezePeriod](../resources/intune-deviceconfig-androiddeviceownersystemupdatefreezeperiod.md) collection|Indicates the annually repeating time periods during which system updates are postponed. This collection can contain a maximum of 500 elements.|

+ "systemUpdateFreezePeriods": [

+ {

+ "@odata.type": "microsoft.graph.androidDeviceOwnerSystemUpdateFreezePeriod",

+ "startMonth": 1024,

+ "startDay": 1024,

+ "endMonth": 1024,

+ "endDay": 1024

+ }

+ ],

+ Title: "androidDeviceOwnerSystemUpdateFreezePeriod resource type"

+description: "Represents one item in the list of freeze periods for Android Device Owner system updates"

+localization_priority: Normal

+# androidDeviceOwnerSystemUpdateFreezePeriod resource type

+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

+Represents one item in the list of freeze periods for Android Device Owner system updates

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|startMonth|Int32|The month of the start date of the freeze period. Valid values 1 to 12|

+|startDay|Int32|The day of the start date of the freeze period. Valid values 1 to 31|

+|endMonth|Int32|The month of the end date of the freeze period. Valid values 1 to 12|

+|endDay|Int32|The day of the end date of the freeze period. Valid values 1 to 31|

+## Relationships

+None

+## JSON Representation

+Here is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "@odata.type": "microsoft.graph.androidDeviceOwnerSystemUpdateFreezePeriod"

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.androidDeviceOwnerSystemUpdateFreezePeriod",

+ "startMonth": 1024,

+ "startDay": 1024,

+ "endMonth": 1024,

+ "endDay": 1024

+}

+```

+|[assignHardwareConfiguration action](../api/intune-deviceconfig-hardwareconfiguration-assignhardwareconfiguration.md)|[hardwareConfigurationAssignment](../resources/intune-deviceconfig-hardwareconfigurationassignment.md) collection|Not yet documented|

+|upn|String|User Principal Name (UPN).|

+|userEmail|String|User Email address.|

+|successfulDeviceCount|Int32|Success device count for specific user.|

+|failedDeviceCount|Int32|Failed device count for specific user.|

+|advancedThreatProtectionRealTime|[enablement](../resources/intune-shared-enablement.md)|Determines whether or not to enable real-time protection for Microsoft Defender Advanced Threat Protection on macOS. Possible values are: `notConfigured`, `enabled`, `disabled`.|

+|advancedThreatProtectionCloudDelivered|[enablement](../resources/intune-shared-enablement.md)|Determines whether or not to enable cloud-delivered protection for Microsoft Defender Advanced Threat Protection on macOS. Possible values are: `notConfigured`, `enabled`, `disabled`.|

+|advancedThreatProtectionAutomaticSampleSubmission|[enablement](../resources/intune-shared-enablement.md)|Determines whether or not to enable automatic file sample submission for Microsoft Defender Advanced Threat Protection on macOS. Possible values are: `notConfigured`, `enabled`, `disabled`.|

+|advancedThreatProtectionDiagnosticDataCollection|[enablement](../resources/intune-shared-enablement.md)|Determines whether or not to enable diagnostic and usage data collection for Microsoft Defender Advanced Threat Protection on macOS. Possible values are: `notConfigured`, `enabled`, `disabled`.|

+|advancedThreatProtectionExcludedFolders|String collection|A list of paths to folders to exclude from antivirus scanning for Microsoft Defender Advanced Threat Protection on macOS.|

+|advancedThreatProtectionExcludedFiles|String collection|A list of paths to files to exclude from antivirus scanning for Microsoft Defender Advanced Threat Protection on macOS.|

+|advancedThreatProtectionExcludedExtensions|String collection|A list of file extensions to exclude from antivirus scanning for Microsoft Defender Advanced Threat Protection on macOS.|

+|advancedThreatProtectionExcludedProcesses|String collection|A list of process names to exclude from antivirus scanning for Microsoft Defender Advanced Threat Protection on macOS.|

+|iCloudDesktopAndDocumentsBlocked|Boolean|When TRUE the synchronization of cloud desktop and documents is blocked. When FALSE, synchronization of the cloud desktop and documents are allowed. Available for devices running macOS 10.12.4 and later.|

+ "iCloudPrivateRelayBlocked": true,

+ "iCloudDesktopAndDocumentsBlocked": true

+|downloadOnly|2|Download the software update without installing it.|

+|installASAP|3|Install an already downloaded software update.|

+|notifyOnly|4|Download the software update and notify the user via the App Store.|

+|installLater|5|Download the software update and install it at a later time.|

+|criticalUpdateBehavior|[macOSSoftwareUpdateBehavior](../resources/intune-deviceconfig-macossoftwareupdatebehavior.md)|Update behavior for critical updates. Possible values are: `notConfigured`, `default`, `downloadOnly`, `installASAP`, `notifyOnly`, `installLater`.|

+|configDataUpdateBehavior|[macOSSoftwareUpdateBehavior](../resources/intune-deviceconfig-macossoftwareupdatebehavior.md)|Update behavior for configuration data file updates. Possible values are: `notConfigured`, `default`, `downloadOnly`, `installASAP`, `notifyOnly`, `installLater`.|

+|firmwareUpdateBehavior|[macOSSoftwareUpdateBehavior](../resources/intune-deviceconfig-macossoftwareupdatebehavior.md)|Update behavior for firmware updates. Possible values are: `notConfigured`, `default`, `downloadOnly`, `installASAP`, `notifyOnly`, `installLater`.|

+|allOtherUpdateBehavior|[macOSSoftwareUpdateBehavior](../resources/intune-deviceconfig-macossoftwareupdatebehavior.md)|Update behavior for all other updates. Possible values are: `notConfigured`, `default`, `downloadOnly`, `installASAP`, `notifyOnly`, `installLater`.|

+|action|[configurationManagerActionType](../resources/intune-devices-configurationmanageractiontype.md)|The action type to trigger on Configuration Manager client. Possible values are: `refreshMachinePolicy`, `refreshUserPolicy`, `wakeUpClient`, `appEvaluation`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`.|

+|quickScan|5|Evaluation application policy on Configuration Manager client|

+|fullScan|6|Evaluation application policy on Configuration Manager client|

+|windowsDefenderUpdateSignatures|7|Evaluation application policy on Configuration Manager client|

+|[playLostModeSound action](../api/intune-devices-manageddevice-playlostmodesound.md)|None|Play lost mode sound|

+|skuNumber|Int32|Device sku number, see also: [GetProductInfo](/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo). Valid values 0 to 2147483647. This property is read-only.|

+|workFromAnywhereScore|Int32|The User experience analytics work from anywhere score.|

+|workFromAnywhereTotalDevices|Int32|The total device count of the user experience analytics category work from anywhere.|

+ "workFromAnywhereScore": 1024,

+ "workFromAnywhereTotalDevices": 1024,

+|advancedThreatProtection|1|Windows Defender ATP Threat & Vulnerability Management.|

+|scheduleActionsForRules action|None|Not yet documented|

+|refreshDeviceComplianceReportSummarization action](../api/intune-shared-devicecompliancepolicy-refreshdevicecompliancereportsummarization.md)|None|Not yet documented|

+|userExperienceAnalyticsOverview|[userExperienceAnalyticsOverview](../resources/intune-devices-userExperienceAnalyticsOverview.md)|User experience analytics overview|

+|userExperienceAnalyticsBaselines|[userExperienceAnalyticsBaseline](../resources/intune-devices-userExperienceAnalyticsBaseline.md) collection|User experience analytics baselines|

+|userExperienceAnalyticsCategories|[userExperienceAnalyticsCategory](../resources/intune-devices-userExperienceAnalyticsCategory.md) collection|User experience analytics categories|

+|userExperienceAnalyticsDevicePerformance|[userExperienceAnalyticsDevicePerformance](../resources/intune-devices-userExperienceAnalyticsDevicePerformance.md) collection|User experience analytics device performance|

+|userExperienceAnalyticsRegressionSummary|[userExperienceAnalyticsRegressionSummary](../resources/intune-devices-userExperienceAnalyticsRegressionSummary.md)|User experience analytics regression summary|

+|userExperienceAnalyticsDeviceStartupHistory|[userExperienceAnalyticsDeviceStartupHistory](../resources/intune-devices-userExperienceAnalyticsDeviceStartupHistory.md) collection|User experience analytics device Startup History|

+|userExperienceAnalyticsDeviceStartupProcesses|[userExperienceAnalyticsDeviceStartupProcess](../resources/intune-devices-userExperienceAnalyticsDeviceStartupProcess.md) collection|User experience analytics device Startup Processes|

+|userExperienceAnalyticsDeviceStartupProcessPerformance|[userExperienceAnalyticsDeviceStartupProcessPerformance](../resources/intune-devices-userExperienceAnalyticsDeviceStartupProcessPerformance.md) collection|User experience analytics device Startup Process Performance|

+|userExperienceAnalyticsScoreHistory|[userExperienceAnalyticsScoreHistory](../resources/intune-devices-userExperienceAnalyticsScoreHistory.md) collection|User experience analytics device Startup Score History|

+|[syncInventory action](../api/intune-softwareupdate-windowsdriverupdateprofile-syncinventory.md)|None|Sync the driver inventory of a WindowsDriverUpdateProfile.|

+|[validateProperties](../api/directoryobject-validateproperties.md)|JSON| Validate that a Microsoft 365 group's display name or mail nickname complies with naming policies. |

+None.