hardwareConfigurationDeviceState 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 for the tenant.

Contains properties for device run state of the hardware configuration

Methods

Method	Return Type	Description
List hardwareConfigurationDeviceStates	hardwareConfigurationDeviceState collection	List properties and relationships of the hardwareConfigurationDeviceState objects.
Get hardwareConfigurationDeviceState	hardwareConfigurationDeviceState	Read properties and relationships of the hardwareConfigurationDeviceState object.
Create hardwareConfigurationDeviceState	hardwareConfigurationDeviceState	Create a new hardwareConfigurationDeviceState object.
Delete hardwareConfigurationDeviceState	None	Deletes a hardwareConfigurationDeviceState.
Update hardwareConfigurationDeviceState	hardwareConfigurationDeviceState	Update the properties of a hardwareConfigurationDeviceState object.

Properties

Property	Type	Description
id	String	Key of the hardware configuration script device state entity. This property is read-only.
deviceName	String	The name of the device
osVersion	String	Operating system version of the device (E.g. 10.0.19042.1165, 10.0.19042.1288 etc.)
upn	String	User Principal Name (UPN).
internalVersion	Int32	The Policy internal version
lastStateUpdateDateTime	DateTimeOffset	The last timestamp of when the hardware configuration executed
configurationState	runState	Configuration state from the lastest hardware configuration execution. Possible values are: unknown, success, fail, scriptError, pending, notApplicable.
configurationOutput	String	Output of the hardware configuration execution
configurationError	String	Error from the hardware configuration execution
assignmentFilterIds	String	A list of identifier strings of different assignment filters applied
userId	String	The unique identifier of the Entra user associated with the device for which policy is applied. Read-Only.

Relationships

None

JSON Representation

Here is a JSON representation of the resource.

{
  "@odata.type": "#microsoft.graph.hardwareConfigurationDeviceState",
  "id": "String (identifier)",
  "deviceName": "String",
  "osVersion": "String",
  "upn": "String",
  "internalVersion": 1024,
  "lastStateUpdateDateTime": "String (timestamp)",
  "configurationState": "String",
  "configurationOutput": "String",
  "configurationError": "String",
  "assignmentFilterIds": "String",
  "userId": "String"
}