Edit

cloudPcUserSetting resource type

  • Article

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 cloudPcUserSettings cloudPcUserSetting collection Get a list of the cloudPcUserSetting objects and their properties.
Get cloudPcUserSetting cloudPcUserSetting Read the properties and relationships of a cloudPcUserSetting object.
Create cloudPcUserSetting cloudPcUserSetting Create a new cloudPcUserSetting object.
Update cloudPcUserSetting cloudPcUserSetting Update the properties of a cloudPcUserSetting object.
Delete cloudPcUserSetting 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'. 
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 is not 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.

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 is a JSON representation of the resource.

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