Create sharedPCConfiguration
Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
Create a new sharedPCConfiguration object.
Prerequisites
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from most to least privileged) |
---|---|
Delegated (work or school account) | DeviceManagementConfiguration.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | Not supported. |
HTTP Request
POST /deviceManagement/deviceConfigurations
Request headers
Header | Value |
---|---|
Authorization | Bearer <token> Required. |
Accept | application/json |
Request body
In the request body, supply a JSON representation for the sharedPCConfiguration object.
The following table shows the properties that are required when you create the sharedPCConfiguration.
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 |
accountManagerPolicy | sharedPCAccountManagerPolicy | Specifies how accounts are managed on a shared PC. Only applies when disableAccountManager is false. |
allowedAccounts | sharedPCAllowedAccountType | Indicates which type of accounts are allowed to use on a shared PC. Possible values are: guest , domain . |
allowLocalStorage | Boolean | Specifies whether local storage is allowed on a shared PC. |
disableAccountManager | Boolean | Disables the account manager for shared PC mode. |
disableEduPolicies | Boolean | Specifies whether the default shared PC education environment policies should be disabled. For Windows 10 RS2 and later, this policy will be applied without setting Enabled to true. |
disablePowerPolicies | Boolean | Specifies whether the default shared PC power policies should be disabled. |
disableSignInOnResume | Boolean | Disables the requirement to sign in whenever the device wakes up from sleep mode. |
enabled | Boolean | Enables shared PC mode and applies the shared pc policies. |
idleTimeBeforeSleepInSeconds | Int32 | Specifies the time in seconds that a device must sit idle before the PC goes to sleep. Setting this value to 0 prevents the sleep timeout from occurring. |
kioskAppDisplayName | String | Specifies the display text for the account shown on the sign-in screen which launches the app specified by SetKioskAppUserModelId. Only applies when KioskAppUserModelId is set. |
kioskAppUserModelId | String | Specifies the application user model ID of the app to use with assigned access. |
maintenanceStartTime | TimeOfDay | Specifies the daily start time of maintenance hour. |
Response
If successful, this method returns a 201 Created
response code and a sharedPCConfiguration object in the response body.
Example
Request
Here is an example of the request.
POST https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 860
{
"@odata.type": "#microsoft.graph.sharedPCConfiguration",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"accountManagerPolicy": {
"@odata.type": "microsoft.graph.sharedPCAccountManagerPolicy",
"accountDeletionPolicy": "diskSpaceThreshold",
"cacheAccountsAboveDiskFreePercentage": 4,
"inactiveThresholdDays": 5,
"removeAccountsBelowDiskFreePercentage": 5
},
"allowedAccounts": "domain",
"allowLocalStorage": true,
"disableAccountManager": true,
"disableEduPolicies": true,
"disablePowerPolicies": true,
"disableSignInOnResume": true,
"enabled": true,
"idleTimeBeforeSleepInSeconds": 12,
"kioskAppDisplayName": "Kiosk App Display Name value",
"kioskAppUserModelId": "Kiosk App User Model Id value",
"maintenanceStartTime": "11:59:24.7240000"
}
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/1.1 201 Created
Content-Type: application/json
Content-Length: 1032
{
"@odata.type": "#microsoft.graph.sharedPCConfiguration",
"id": "5206be3b-be3b-5206-3bbe-06523bbe0652",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"accountManagerPolicy": {
"@odata.type": "microsoft.graph.sharedPCAccountManagerPolicy",
"accountDeletionPolicy": "diskSpaceThreshold",
"cacheAccountsAboveDiskFreePercentage": 4,
"inactiveThresholdDays": 5,
"removeAccountsBelowDiskFreePercentage": 5
},
"allowedAccounts": "domain",
"allowLocalStorage": true,
"disableAccountManager": true,
"disableEduPolicies": true,
"disablePowerPolicies": true,
"disableSignInOnResume": true,
"enabled": true,
"idleTimeBeforeSleepInSeconds": 12,
"kioskAppDisplayName": "Kiosk App Display Name value",
"kioskAppUserModelId": "Kiosk App User Model Id value",
"maintenanceStartTime": "11:59:24.7240000"
}
Feedback
Loading feedback...