title | description | author | ms.localizationpriority | ms.subservice | doc_type |
---|---|---|---|---|---|
Create windowsFeatureUpdateProfile |
Create a new windowsFeatureUpdateProfile object. |
jaiprakashmb |
medium |
intune |
apiPageType |
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.
Create a new windowsFeatureUpdateProfile object.
[!INCLUDE national-cloud-support]
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 least to most privileged) |
---|---|
Delegated (work or school account) | DeviceManagementConfiguration.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | DeviceManagementConfiguration.ReadWrite.All |
POST /deviceManagement/windowsFeatureUpdateProfiles
Header | Value |
---|---|
Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
Accept | application/json |
In the request body, supply a JSON representation for the windowsFeatureUpdateProfile object.
The following table shows the properties that are required when you create the windowsFeatureUpdateProfile.
Property | Type | Description |
---|---|---|
id | String | The Identifier of the entity. |
displayName | String | The display name of the profile. |
description | String | The description of the profile which is specified by the user. |
featureUpdateVersion | String | The feature update version that will be deployed to the devices targeted by this profile. The version could be any supported version for example 1709, 1803 or 1809 and so on. |
rolloutSettings | windowsUpdateRolloutSettings | The windows update rollout settings, including offer start date time, offer end date time, and days between each set of offers. |
createdDateTime | DateTimeOffset | The date time that the profile was created. |
lastModifiedDateTime | DateTimeOffset | The date time that the profile was last modified. |
roleScopeTagIds | String collection | List of Scope Tags for this Feature Update entity. |
deployableContentDisplayName | String | Friendly display name of the quality update profile deployable content |
endOfSupportDate | DateTimeOffset | The last supported date for a feature update |
installLatestWindows10OnWindows11IneligibleDevice | Boolean | If true, the latest Microsoft Windows 10 update will be installed on devices ineligible for Microsoft Windows 11 |
installFeatureUpdatesOptional | Boolean | If true, the Windows 11 update will become optional |
If successful, this method returns a 201 Created
response code and a windowsFeatureUpdateProfile object in the response body.
Here is an example of the request.
POST https://graph.microsoft.com/beta/deviceManagement/windowsFeatureUpdateProfiles
Content-type: application/json
Content-length: 773
{
"@odata.type": "#microsoft.graph.windowsFeatureUpdateProfile",
"displayName": "Display Name value",
"description": "Description value",
"featureUpdateVersion": "Feature Update Version value",
"rolloutSettings": {
"@odata.type": "microsoft.graph.windowsUpdateRolloutSettings",
"offerStartDateTimeInUTC": "2017-01-01T00:01:16.3697768-08:00",
"offerEndDateTimeInUTC": "2016-12-31T23:58:15.1925199-08:00",
"offerIntervalInDays": 3
},
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"deployableContentDisplayName": "Deployable Content Display Name value",
"endOfSupportDate": "2017-01-01T00:02:08.3437725-08:00",
"installLatestWindows10OnWindows11IneligibleDevice": true,
"installFeatureUpdatesOptional": true
}
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: 945
{
"@odata.type": "#microsoft.graph.windowsFeatureUpdateProfile",
"id": "885bd4ee-d4ee-885b-eed4-5b88eed45b88",
"displayName": "Display Name value",
"description": "Description value",
"featureUpdateVersion": "Feature Update Version value",
"rolloutSettings": {
"@odata.type": "microsoft.graph.windowsUpdateRolloutSettings",
"offerStartDateTimeInUTC": "2017-01-01T00:01:16.3697768-08:00",
"offerEndDateTimeInUTC": "2016-12-31T23:58:15.1925199-08:00",
"offerIntervalInDays": 3
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"deployableContentDisplayName": "Deployable Content Display Name value",
"endOfSupportDate": "2017-01-01T00:02:08.3437725-08:00",
"installLatestWindows10OnWindows11IneligibleDevice": true,
"installFeatureUpdatesOptional": true
}