cloudPcUserSetting resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a Cloud PC user setting.

Methods

Method	Return type	Description
List	cloudPcUserSetting collection	Get a list of the cloudPcUserSetting objects and their properties.
Get	cloudPcUserSetting	Read the properties and relationships of a cloudPcUserSetting object.
Create	cloudPcUserSetting	Create a new cloudPcUserSetting object.
Update	cloudPcUserSetting	Update the properties of a cloudPcUserSetting object.
Delete	None	Delete a cloudPcUserSetting object.
Assign	None	Assign a cloudPcUserSetting to user groups.

Properties

Property	Type	Description
createdDateTime	DateTimeOffset	The date and time the setting was created. The timestamp type represents the date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 looks like this: '2014-01-01T00:00:00Z'.
crossRegionDisasterRecoverySetting	cloudPcCrossRegionDisasterRecoverySetting	Defines whether the user's Cloud PC enables cross-region disaster recovery and specifies the network for the disaster recovery.
displayName	String	The setting name displayed in the user interface.
id	String	Unique identifier for the Cloud PC user setting. Read-only.
lastModifiedDateTime	DateTimeOffset	The last date and time the setting was modified. The timestamp type represents the date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 looks like this: '2014-01-01T00:00:00Z'.
localAdminEnabled	Boolean	Indicates whether the local admin option is enabled. Default value is false. To enable the local admin option, change the setting to true. If the local admin option is enabled, the end user can be an admin of the Cloud PC device.
resetEnabled	Boolean	Indicates whether an end user is allowed to reset their Cloud PC. When true, the user is allowed to reset their Cloud PC. When false, end-user initiated reset isn't allowed. The default value is false.
restorePointSetting	cloudPcRestorePointSetting	Defines how frequently a restore point is created that is, a snapshot is taken) for users' provisioned Cloud PCs (default is 12 hours), and whether the user is allowed to restore their own Cloud PCs to a backup made at a specific point in time.
selfServiceEnabled (deprecated)	Boolean	Indicates whether the self-service option is enabled. Default value is false. To enable the self-service option, change the setting to true. If the self-service option is enabled, the end user is allowed to perform some self-service operations, such as upgrading the Cloud PC through the end user portal. The selfServiceEnabled property is deprecated and will stop returning data on December 1, 2023.
notificationSetting	cloudPcNotificationSetting	Defines the setting of the Cloud PC notification prompts for the Cloud PC user.

Relationships

Relationship	Type	Description
assignments	cloudPcUserSettingAssignment collection	Represents the set of Microsoft 365 groups and security groups in Microsoft Entra ID that have cloudPCUserSetting assigned. Returned only on $expand. For an example, see Get cloudPcUserSettingample.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.cloudPcUserSetting",
  "createdDateTime": "String (timestamp)",
  "crossRegionDisasterRecoverySetting": {"@odata.type": "microsoft.graph.cloudPcCrossRegionDisasterRecoverySetting"},
  "displayName": "String",
  "id": "String (identifier)",  
  "lastModifiedDateTime": "String (timestamp)",
  "localAdminEnabled": "Boolean",
  "resetEnabled": "Boolean",
  "restorePointSetting": {
    "@odata.type": "microsoft.graph.cloudPcRestorePointSetting"
  },
  "selfServiceEnabled": "Boolean",
  "notificationSetting": {
    "@odata.type": "microsoft.graph.cloudPcNotificationSetting"
  }
}