macOSGeneralDeviceConfiguration resource type

Note: Using the Microsoft Graph APIs to configure Intune controls and policies still requires that the Intune service is correctly licensed by the customer.

This topic provides descriptions of the declared methods, properties and relationships exposed by the macOSGeneralDeviceConfiguration resource.

Inherits from deviceConfiguration


Method Return Type Description
List macOSGeneralDeviceConfigurations macOSGeneralDeviceConfiguration collection List properties and relationships of the macOSGeneralDeviceConfiguration objects.
Get macOSGeneralDeviceConfiguration macOSGeneralDeviceConfiguration Read properties and relationships of the macOSGeneralDeviceConfiguration object.
Create macOSGeneralDeviceConfiguration macOSGeneralDeviceConfiguration Create a new macOSGeneralDeviceConfiguration object.
Delete macOSGeneralDeviceConfiguration None Deletes a macOSGeneralDeviceConfiguration.
Update macOSGeneralDeviceConfiguration macOSGeneralDeviceConfiguration Update the properties of a macOSGeneralDeviceConfiguration object.
List deviceConfigurationGroupAssignments deviceConfigurationGroupAssignment collection Get the deviceConfigurationGroupAssignments from the groupAssignments navigation property.
List deviceConfigurationDeviceStatuses deviceConfigurationDeviceStatus collection Get the deviceConfigurationDeviceStatuses from the deviceStatuses navigation property.
List deviceConfigurationUserStatuses deviceConfigurationUserStatus collection Get the deviceConfigurationUserStatuses from the userStatuses navigation property.
Get deviceConfigurationDeviceOverview deviceConfigurationDeviceOverview Get the deviceConfigurationDeviceOverview from the deviceStatusOverview navigation property.
Get deviceConfigurationUserOverview deviceConfigurationUserOverview Get the deviceConfigurationUserOverview from the userStatusOverview navigation property.
List settingStateDeviceSummaries settingStateDeviceSummary collection Get the settingStateDeviceSummaries from the deviceSettingStateSummaries navigation property.


Property Type Description
id String Key of the entity. Inherited from deviceConfiguration
lastModifiedDateTime DateTimeOffset DateTime the object was last modified. 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
compliantAppsList appListItem collection List of apps in the compliance (either allow list or block list, controlled by CompliantAppListType). This collection can contain a maximum of 10000 elements.
compliantAppListType String List that is in the CompliantAppsList. Possible values are: none, appsInListCompliant, appsNotInListCompliant.
emailInDomainSuffixes String collection An email address lacking a suffix that matches any of these strings will be considered out-of-domain.
passwordBlockSimple Boolean Block simple passwords.
passwordExpirationDays Int32 Number of days before the password expires.
passwordMinimumCharacterSetCount Int32 Number of character sets a password must contain. Valid values 0 to 4
passwordMinimumLength Int32 Minimum length of passwords.
passwordMinutesOfInactivityBeforeLock Int32 Minutes of inactivity required before a password is required.
passwordMinutesOfInactivityBeforeScreenTimeout Int32 Minutes of inactivity required before the screen times out.
passwordPreviousPasswordBlockCount Int32 Number of previous passwords to block.
passwordRequiredType String Type of password that is required. Possible values are: deviceDefault, alphanumeric, numeric.
passwordRequired Boolean Whether or not to require a password.


Relationship Type Description
groupAssignments deviceConfigurationGroupAssignment collection The list of group assignments for the device configuration profile. Inherited from deviceConfiguration
deviceStatuses deviceConfigurationDeviceStatus collection Device configuration installation stauts by device. Inherited from deviceConfiguration
userStatuses deviceConfigurationUserStatus collection Device configuration installation stauts by user. Inherited from deviceConfiguration
deviceStatusOverview deviceConfigurationDeviceOverview Device Configuration devices status overview Inherited from deviceConfiguration
userStatusOverview deviceConfigurationUserOverview Device Configuration users status overview Inherited from deviceConfiguration
deviceSettingStateSummaries settingStateDeviceSummary collection Device Configuration Setting State Device Summary Inherited from deviceConfiguration

JSON Representation

Here is a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.macOSGeneralDeviceConfiguration",
  "id": "String (identifier)",
  "lastModifiedDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "version": 1024,
  "compliantAppsList": [
      "@odata.type": "microsoft.graph.appListItem",
      "name": "String",
      "publisher": "String",
      "appStoreUrl": "String",
      "appId": "String"
  "compliantAppListType": "String",
  "emailInDomainSuffixes": [
  "passwordBlockSimple": true,
  "passwordExpirationDays": 1024,
  "passwordMinimumCharacterSetCount": 1024,
  "passwordMinimumLength": 1024,
  "passwordMinutesOfInactivityBeforeLock": 1024,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 1024,
  "passwordPreviousPasswordBlockCount": 1024,
  "passwordRequiredType": "String",
  "passwordRequired": true