Updates from: 07/24/2024 02:44:56
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackageassignmentpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/accesspackageassignmentpolicy-get.md
Content-type: application/json
The following example shows a request to retrieve the collection of custom extension stage settings that are defined for a policy and their associated access package custom workflow extension. - # [HTTP](#tab/http) <!-- { "blockType": "request",
v1.0 Accesspackageassignmentpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/accesspackageassignmentpolicy-update.md
Content-Type: application/json
### Example 3: Remove the customExtensionStageSettings from a policy
-To remove the collection of **customExtensionStageSettings** and their associated custom workflow extension objects from a policy, assign an empty collection to the **customExtensionStageSettings** object.
+To remove the collection of **customExtensionStageSettings** and their associated custom workflow extension objects from a policy, assign an empty collection to the **customExtensionStageSettings** object.
#### Request
Content-Type: application/json
-->
+### Example 4: Update the customExtensionStageSettings for a policy
+
+The following example shows how to update a policy to include a custom extension.
+
+#### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_accesspackageassignmentpolicy_updating_customExtensionStageSettings"
+}
+-->
+
+```http
+PUT https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentPolicies/f9afd2e3-7486-40df-9c35-aa2ae108c495
+Content-Type: application/json
+
+{
+ "displayName": "API Created policy with updated customExtensionStageSettings",
+ "description": "policy with updated customExtensionStageSettings",
+ "allowedTargetScope": "notSpecified",
+ "specificAllowedTargets": [],
+ "expiration": {
+ "endDateTime": null,
+ "duration": null,
+ "type": "noExpiration"
+ },
+ "requestorSettings": {
+ "enableTargetsToSelfAddAccess": false,
+ "enableTargetsToSelfUpdateAccess": false,
+ "enableTargetsToSelfRemoveAccess": false,
+ "allowCustomAssignmentSchedule": true,
+ "enableOnBehalfRequestorsToAddAccess": false,
+ "enableOnBehalfRequestorsToUpdateAccess": false,
+ "enableOnBehalfRequestorsToRemoveAccess": false,
+ "onBehalfRequestors": []
+ },
+ "requestApprovalSettings": {
+ "isApprovalRequiredForAdd": false,
+ "isApprovalRequiredForUpdate": false,
+ "stages": []
+ },
+ "accessPackage": {
+ "id": "f9afd2e3-7486-40df-9c35-aa2ae108c495"
+ },
+ "customExtensionStageSettings": [
+ {
+ "stage": "assignmentRequestCreated",
+ "customExtension": {
+ "@odata.type": "#microsoft.graph.accessPackageAssignmentRequestWorkflowExtension",
+ "id": "bebe7873-1f0d-4db9-b6c3-01f7ebfe8476"
+ }
+ }
+ ]
+}
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++
+#### Response
+
+The following example shows the response.
+> **Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.accessPackageAssignmentPolicy"
+}
+-->
+
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id": "4540a08f-8ab5-43f6-a923-015275799197",
+ "displayName": "API Created policy with updated customExtensionStageSettings",
+ "description": "policy with updated customExtensionStageSettings",
+ "accessPackageId": "f9afd2e3-7486-40df-9c35-aa2ae108c495",
+ "expiration": {
+ "type": "afterDuration",
+ "duration": "P365D"
+ },
+ "requestApprovalSettings": null,
+ "requestorSettings": {
+ "acceptRequests": true,
+ "scopeType": "AllExistingDirectorySubjects",
+ "allowedRequestors": []
+ },
+ "accessReviewSettings": null,
+ "customExtensionStageSettings": [
+ {
+ "stage": "assignmentRequestCreated",
+ "customExtension": {
+ "@odata.type": "#microsoft.graph.accessPackageAssignmentRequestWorkflowExtension",
+ "id": "bebe7873-1f0d-4db9-b6c3-01f7ebfe8476"
+ }
+ }
+ ]
+}
+```
v1.0 Activitybasedtimeoutpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/activitybasedtimeoutpolicy-update.md
PATCH /policies/activityBasedTimeoutPolicies/{id}
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type | Description | |:-|:|:|
v1.0 Administrativeunit Post Members https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/administrativeunit-post-members.md
To add a user, group, or device to an administrative unit, the calling user must
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. --> |Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Directory.ReadWrite.All |
+|Delegated (work or school account) | Group.ReadWrite.All and AdministrativeUnit.Read.All, Directory.ReadWrite.All |
|Delegated (personal Microsoft account) | Not supported. |
-|Application | Directory.ReadWrite.All |
+|Application | Group.Create and AdministrativeUnit.Read.All, Group.ReadWrite.All and AdministrativeUnit.Read.All, Directory.ReadWrite.All |
-To create a new group in an administrative unit, the calling user must be assigned the *Privileged Role Administrator* or *Groups Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json).
+To create a new group in an administrative unit, the calling principal must be assigned at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) at the scope of the administrative unit:
+
+* Groups Administrator
+* User Administrator
+
+When these roles are assigned to a service principal, additional permissions are required to read the directory, such as assignment to the Directory Readers role, or having Microsoft Graph application permissions, such as Directory.Read.All.
## HTTP request
v1.0 Agreement Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/agreement-update.md
PATCH /identityGovernance/termsOfUse/agreements/{id}
| Authorization | string | Bearer \{token\}. Required. | ## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type | Description | |:-|:|:|
v1.0 Application Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-update.md
PUT /applications(appId='{appId}')/logo
| Content-Type | application/json. Required. | ## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type | Description | |:|:-|:--|
In the request body, supply the values for relevant fields that should be update
| isFallbackPublicClient | Boolean | Specifies the fallback application type as public client, such as an installed application running on a mobile device. The default value is `false`, which means the fallback application type is confidential client such as web app. There are certain scenarios where Microsoft Entra ID cannot determine the client application type (for example, [ROPC](https://tools.ietf.org/html/rfc6749#section-4.3) flow where it is configured without specifying a redirect URI). In those cases, Microsoft Entra ID will interpret the application type based on the value of this property. | | keyCredentials | [keyCredential](../resources/keycredential.md) collection | The collection of key credentials associated with the application. Not nullable. | | logo | Stream | The main logo for the application. Not nullable. Use the PUT method to update the logo. |
+| nativeAuthenticationApisEnabled | String | Specifies whether the native authentication APIs are enabled so that the application can use them to provide native authentication. The possible values are: `none`, `all`, and `unknownFutureValue`. For more information, see [Native Authentication](/entra/external-id/customers/concept-native-authentication).|
| onPremisesPublishing | [onPremisesPublishing](../resources/onpremisespublishing.md) | Represents the set of properties for configuring [Microsoft Entra application proxy](/azure/active-directory/app-proxy/what-is-application-proxy) for an on-premises application. This property can only be set after the application has been created and cannot be updated in the same request as other application properties. | | optionalClaims | optionalClaims | Application developers can configure optional claims in their Microsoft Entra apps to specify which claims they want in tokens sent to their application by the Microsoft security token service. See [optional claims](/azure/active-directory/develop/active-directory-optional-claims) for more information. | | parentalControlSettings | [parentalControlSettings](../resources/parentalcontrolsettings.md) | Specifies parental control settings for an application. |
v1.0 Application Upsert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-upsert.md
Create a new [application](../resources/application.md) object if it doesn't exi
## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
-<!-- { "blockType": "permissions", "name": "application_post_applications" } -->
+<!-- { "blockType": "permissions", "name": "application_upsert" } -->
## HTTP request
PATCH /applications(uniqueName='{uniqueName}')
## Request headers | Name | Description| |:--|:-|
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | | Prefer | `create-if-missing`. Required for upsert behavior, otherwise the request is treated as an update operation. |
v1.0 Applicationtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationtemplate-get.md
Retrieve the properties of an [applicationTemplate](../resources/applicationtemp
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
-<!-- { "blockType": "permissions", "name": "applicationtemplate_get" } -->
+<!-- {
+ "blockType": "permissions",
+ "name": "applicationtemplate-get-permissions"
+}
+-->
+ [!INCLUDE [permissions-table](../includes/permissions/applicationtemplate-get-permissions.md)] Additional permissions aren't required to call this API, as long as your application has a valid access token to call Microsoft Graph.
Additional permissions aren't required to call this API, as long as your applica
<!-- { "blockType": "ignored" } -->
-```http
-GET /applicationTemplates/{id}
+``` http
+GET /applicationTemplates/{applicationTemplate-id}
``` ## Optional query parameters
If successful, this method returns a `200 OK` response code and the requested [a
The following example shows a request.
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_applicationtemplate" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/applicationTemplates/00000007-0000-0000-c000-000000000000
+GET https://graph.microsoft.com/beta/applicationTemplates/006a06ef-9160-42cd-88bf-17a7588fc844
```
-# [C#](#tab/csharp)
-
-# [CLI](#tab/cli)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
-
-# [Python](#tab/python)
--- ### Response The following example shows the response.
HTTP/1.1 200 OK
Content-type: application/json {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#applicationTemplates/$entity",
- "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET applicationTemplates('<guid>')?$select=appCategory,categories",
- "id": "00000007-0000-0000-c000-000000000000",
- "displayName": "Dynamics CRM Online",
- "homePageUrl": "http://www.microsoft.com/dynamics/crm",
- "supportedSingleSignOnModes": [
- "oidc",
- "external"
- ],
- "supportedProvisioningTypes": [],
- "logoUrl": "https://az495088.vo.msecnd.net/app-logo/crm_215.png",
- "categories": [
- "crm",
- "productivity",
- "collaboration",
- "businessMgmt"
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#applicationTemplates/$entity",
+ "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET applicationTemplates('<guid>')?$select=appCategory,categories",
+ "id": "006a06ef-9160-42cd-88bf-17a7588fc844",
+ "displayName": "LinkedIn Lookup",
+ "homePageUrl": "www.linkedin.com",
+ "supportedSingleSignOnModes": [
+ "SAML",
+ "Password"
+ ],
+ "supportedProvisioningTypes": [],
+ "logoUrl": "https://images.microsoft.com",
+ "categories": [
+ "collaboration",
+ "social"
+ ],
+ "publisher": "LinkedIn",
+ "description": "LinkedIn Lookup is the easiest way to find coworkers and teams at your company. Lookup is a new people search tool that combines employees' LinkedIn profile information and Active Directory information, allowing you to quickly find and contact your coworkers, on desktop or mobile. Requires an existing Lookup company subscription.",
+ "supportedClaimConfiguration": {
+ "requiredClaims": [
+ {
+ "id": "first_name",
+ "namespace": "",
+ "source": "user",
+ "attribute": "firstname"
+ },
+ {
+ "id": "last_name",
+ "namespace": "",
+ "source": "user",
+ "attribute": "surname"
+ },
+ {
+ "id": "email_address",
+ "namespace": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/",
+ "source": "user",
+ "attribute": "mail"
+ }
],
- "publisher": "Microsoft Corporation",
- "description": null,
- "supportedClaimConfiguration": null,
- "informationalUrls": {
- "singleSignOnDocumentationUrl": null,
- "appSignUpUrl": "http://go.microsoft.com/fwlink/?LinkId=252780"
+ "groupMembershipClaims": "securityGroup",
+ "nameIdPolicyFormat": "urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress"
+ },
+ "informationalUrls": {
+ "singleSignOnDocumentationUrl": "https://go.microsoft.com/fwlink/?linkid=847714",
+ "provisioningDocumentationUrl": null,
+ "appSignUpUrl": null
+ },
+ "configurationUris": [
+ {
+ "usage": "redirectUri",
+ "examples": [
+ "https://www.linkedin.com/checkpoint/enterprise/<SUBDOMAIN>"
+ ],
+ "values": [
+ "https://www.linkedin.com/checkpoint/enterprise/*"
+ ],
+ "isRequired": false,
+ "appliesToSingleSignOnMode": "saml"
+ },
+ {
+ "usage": "identifierUri",
+ "examples": null,
+ "values": [
+ "linkedinlookup/primary",
+ "https://www.linkedin.com/lookup/*"
+ ],
+ "isRequired": true,
+ "appliesToSingleSignOnMode": "saml"
}
+ ]
} ```
v1.0 Applicationtemplate Instantiate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationtemplate-instantiate.md
Choose the permission or permissions marked as least privileged for this API. Us
<!-- { "blockType": "ignored" } --> ```http
-POST /applicationTemplates/{id}/instantiate
+POST /applicationTemplates/{applicationTemplate-id}/instantiate
``` To instantiate non-gallery apps, use the `8adf8e6e-67b2-4cf2-a259-e3dc5476c621` for the `{applicationTemplate-id}`.
v1.0 Applicationtemplate List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationtemplate-list.md
Retrieve a list of [applicationTemplate](../resources/applicationtemplate.md) ob
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
-<!-- { "blockType": "permissions", "name": "applicationtemplate_list" } -->
+<!-- {
+ "blockType": "permissions",
+ "name": "applicationtemplate-list-permissions"
+}
+-->
[!INCLUDE [permissions-table](../includes/permissions/applicationtemplate-list-permissions.md)] Additional permissions aren't required to call this API, as long as your application has a valid access token to call Microsoft Graph.
The following example shows the response.
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.applicationTemplate",
- "isCollection": true
+ "@odata.type": "Collection(microsoft.graph.applicationTemplate)"
} --> ```http
HTTP/1.1 200 OK
Content-type: application/json {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#applicationTemplates",
- "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET applicationTemplates?$select=appCategory,categories",
- "value": [
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#applicationTemplates",
+ "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET applicationTemplates?$select=appCategory,categories",
+ "value": [
+ {
+ "id": "006a06ef-9160-42cd-88bf-17a7588fc844",
+ "displayName": "LinkedIn Lookup",
+ "homePageUrl": "www.linkedin.com",
+ "supportedSingleSignOnModes": [
+ "SAML",
+ "Password"
+ ],
+ "supportedProvisioningTypes": [],
+ "logoUrl": "https://images.microsoft.com",
+ "categories": [
+ "collaboration",
+ "social"
+ ],
+ "publisher": "LinkedIn",
+ "description": "LinkedIn Lookup is the easiest way to find coworkers and teams at your company. Lookup is a new people search tool that combines employees' LinkedIn profile information and Active Directory information, allowing you to quickly find and contact your coworkers, on desktop or mobile. Requires an existing Lookup company subscription.",
+ "supportedClaimConfiguration": {
+ "requiredClaims": [
+ {
+ "id": "first_name",
+ "namespace": "",
+ "source": "user",
+ "attribute": "firstname"
+ },
+ {
+ "id": "last_name",
+ "namespace": "",
+ "source": "user",
+ "attribute": "surname"
+ },
+ {
+ "id": "email_address",
+ "namespace": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/",
+ "source": "user",
+ "attribute": "mail"
+ }
+ ],
+ "groupMembershipClaims": "securityGroup",
+ "nameIdPolicyFormat": "urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress"
+ },
+ "informationalUrls": {
+ "singleSignOnDocumentationUrl": "https://go.microsoft.com/fwlink/?linkid=847714",
+ "provisioningDocumentationUrl": null,
+ "appSignUpUrl": null
+ },
+ "configurationUris": [
+ {
+ "usage": "redirectUri",
+ "examples": [
+ "https://www.linkedin.com/checkpoint/enterprise/<SUBDOMAIN>"
+ ],
+ "values": [
+ "https://www.linkedin.com/checkpoint/enterprise/*"
+ ],
+ "isRequired": false,
+ "appliesToSingleSignOnMode": "saml"
+ },
{
- "id": "00000007-0000-0000-c000-000000000000",
- "displayName": "Dynamics CRM Online",
- "homePageUrl": "http://www.microsoft.com/dynamics/crm",
- "supportedSingleSignOnModes": [
- "oidc",
- "external"
- ],
- "supportedProvisioningTypes": [],
- "logoUrl": "https://az495088.vo.msecnd.net/app-logo/crm_215.png",
- "categories": [
- "crm",
- "productivity",
- "collaboration",
- "businessMgmt"
- ],
- "publisher": "Microsoft Corporation",
- "description": null,
- "supportedClaimConfiguration": null,
- "informationalUrls": {
- "singleSignOnDocumentationUrl": null,
- "appSignUpUrl": "http://go.microsoft.com/fwlink/?LinkId=252780"
- }
+ "usage": "identifierUri",
+ "examples": null,
+ "values": [
+ "linkedinlookup/primary",
+ "https://www.linkedin.com/lookup/*"
+ ],
+ "isRequired": true,
+ "appliesToSingleSignOnMode": "saml"
}
- ]
+ ]
+ }
+ ]
} ```
v1.0 Attachment Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/attachment-get.md
Use `$expand` to get the properties of an item attachment (contact, event, or me
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Audioroutinggroup Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/audioroutinggroup-update.md
PATCH /communications/calls/{id}/audioRoutingGroups/{id}
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type |Description| |:|:--|:-|
v1.0 Authentication Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authentication-get.md
Title: "Get authentication states"
-description: "Read the properties of a user's authentication method states, such as their sign-in preferences and per-user MFA state."
+description: "Read the properties of a user's authentication method states, such as their sign-in preferences (system-preferred MFA) and per-user MFA state."
ms.localizationpriority: medium
Namespace: microsoft.graph
Read the properties of a user's authentication states. Use this API to retrieve the following information: -- A user's [signInPreferences](../resources/signInPreferences.md)-- A user's [strongAuthenticationRequirements](../resources/strongauthenticationrequirements.md)
+- A user's [signInPreferences (system-preferred MFA)](../resources/signInPreferences.md)
+- A user's [strongAuthenticationRequirements (per-user MFA)](../resources/strongauthenticationrequirements.md)
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
+### Permissions to read system-preferred MFA
+ <!-- { "blockType": "permissions", "name": "authentication_get" } --> [!INCLUDE [permissions-table](../includes/permissions/authentication-get-permissions.md)] [!INCLUDE [rbac-authentication-methods-apis-read-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-read-others.md)]
+### Permissions to read per-user MFA state
+
+#### Permissions acting on self
+
+<!-- { "blockType": "permissions", "name": "authentication_get_2" } -->
+
+#### Permissions acting on others
+
+<!-- { "blockType": "permissions", "name": "authentication_get_3" } -->
++ ## HTTP request
-To retrieve the sign-in preferences for a user:
+To retrieve the sign-in preferences (system-preferred MFA) for a user:
<!-- { "blockType": "ignored" }
To retrieve the sign-in preferences for a user:
GET /users/{id | userPrincipalName}/authentication/signInPreferences ```
+To retrieve the per-user multifactor authentication state for the signed-in user:
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /me/authentication/requirements
+```
+ To retrieve the per-user multifactor authentication state for a user: <!-- { "blockType": "ignored"
For sign-in preferences: If successful, this method returns a `200 OK` response
## Examples
-### Example 1: Get a user's default MFA method
+### Example 1: Get a user's system-preferred MFA method
#### Request The following example shows a request.
v1.0 Authentication Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authentication-update.md
Title: "Update authentication method states"
-description: "Update the properties of a user's authentication states."
+description: "Update the properties of a user's authentication states, such as their sign-in preferences (system-preferred MFA) and per-user MFA state."
ms.localizationpriority: medium
Namespace: microsoft.graph
Update the properties of a user's authentication method states. Use this API to update the following information: -- A user's [signInPreferences](../resources/signInPreferences.md)-- A user's [strongAuthenticationRequirements](../resources/strongauthenticationrequirements.md)
+- A user's [signInPreferences (system-preferred MFA)](../resources/signInPreferences.md)
+- A user's [strongAuthenticationRequirements (per-user MFA)](../resources/strongauthenticationrequirements.md)
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
+### Permissions to update system-preferred MFA
+ <!-- { "blockType": "permissions", "name": "authentication_update" } --> [!INCLUDE [permissions-table](../includes/permissions/authentication-update-permissions.md)] [!INCLUDE [rbac-authentication-methods-apis-write-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-write-others.md)]
+### Permissions to update per-user MFA state
+
+#### Permissions acting on self
+
+<!-- { "blockType": "permissions", "name": "authentication_get_2" } -->
+
+#### Permissions acting on others
+
+<!-- { "blockType": "permissions", "name": "authentication_get_3" } -->
+ ## HTTP request
-To update the sign-in preferences for a user:
+To update the sign-in preferences (system-preferred MFA) for a user:
<!-- { "blockType": "ignored" }
To update the sign-in preferences for a user:
PATCH /users/{id | userPrincipalName}/authentication/signInPreferences ```
+To update the per-user multifactor authentication state for the signed-in user:
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /me/authentication/requirements
+```
+ To update the per-user multifactor authentication state for a user: <!-- { "blockType": "ignored"
If successful, this method returns a `204 No Content` response code.
## Examples
-### Example 1: Update a user's default MFA method
+### Example 1: Update a user's system-preferred MFA method
#### Request The following example shows a request.
v1.0 Authenticationoperation Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authenticationoperation-get.md
- Title: "Get authentication operation"
-description: "Retrieve the properties and relationships of an operation object."
---
-doc_type: "apiPageType"
--
-# Get authentication operation
-
-Namespace: microsoft.graph
--
-Retrieve the properties and relationships of an [operation](../resources/operation.md) object. Currently these operations are generated by initiating a password reset using the [reset password](authenticationmethod-resetpassword.md) method. An operation object tells the caller about the current state of that password reset operation. Possible states include:
-
-* NotStarted
-* Running
-* Succeeded
-* Failed
-
-`Succeeded` and `Failed` are terminal states.
--
-## Permissions
-
-Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
-
-<!-- { "blockType": "permissions", "name": "authenticationoperation_get" } -->
--
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-GET /users/{id | userPrincipalName}/authentication/operations/{id}
-```
-
-## Optional query parameters
-
-This method does not support optional query parameters to customize the response.
-
-## Request headers
-
-| Name |Description|
-|:-|:-|
-|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
-
-## Request body
-
-Don't supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and the requested [operation](../resources/operation.md) object in the response body.
-
-## Examples
-
-### Request
-
-The following example shows a request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_operation"
-}-->
-
-```msgraph-interactive
-GET /users/{id | userPrincipalName}/authentication/operations/{id}
-```
-
-# [C#](#tab/csharp)
-
-# [CLI](#tab/cli)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
-
-# [Python](#tab/python)
---
-### Response
-
-The following example shows the response.
-
-> **Note:** The response object shown here might be shortened for readability.
-
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.operation"
-} -->
-
-```http
-HTTP/1.1 200 OK
-Content-type: application/json
-
-{
- "status": "running",
- "createdDateTime": "2020-03-19T12-01-03.45Z",
- "lastActionDateTime": "2020-03-19T12-01-04.23Z",
- "id": "2d497bb-57bd-47a6-8749-5ccd0869f2bd"
-}
-```
-
-<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
-2019-02-04 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "Get operation",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
v1.0 Awsidentityaccessmanagementkeyagefinding Aggregatedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsidentityaccessmanagementkeyagefinding-aggregatedsummary.md
GET /identityGovernance/permissionsAnalytics/aws/findings/microsoft.graph.awsIde
## Function parameters In the request URL, provide the following query parameters with values.
-The following table lists the parameters that are required when you call this function.
|Parameter|Type|Description| |:|:|:|
v1.0 Awsidentityaccessmanagementkeyusagefinding Aggregatedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/awsidentityaccessmanagementkeyusagefinding-aggregatedsummary.md
GET /identityGovernance/permissionsAnalytics/aws/findings/microsoft.graph.awsIde
## Function parameters In the request URL, provide the following query parameters with values.
-The following table lists the parameters that are required when you call this function.
|Parameter|Type|Description| |:|:|:|
v1.0 Backuprestoreroot Delete Serviceapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-delete-serviceapps.md
DELETE https://graph.microsoft.com/beta/solutions/backupRestore/serviceApps/{716
[!INCLUDE [sample-code](../includes/snippets/php/delete-serviceapp-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-serviceapp-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot Enable https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-enable.md
POST https://graph.microsoft.com/beta/solutions/backupRestore/enable
[!INCLUDE [sample-code](../includes/snippets/php/backuprestoreroot-enable-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/backuprestoreroot-enable-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-get.md
GET https://graph.microsoft.com/beta/solutions/backupRestore
[!INCLUDE [sample-code](../includes/snippets/php/backuprestoreroot-get-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/backuprestoreroot-get-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot List Driveprotectionunits https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-driveprotectionunits.md
GET /solutions/backupRestore/driveProtectionUnits
[!INCLUDE [sample-code](../includes/snippets/php/list-all-driveprotectionunit-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-all-driveprotectionunit-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET /solutions/backupRestore/oneDriveForBusinessProtectionPolicies/845457dc-4bb2
[!INCLUDE [sample-code](../includes/snippets/php/list-driveprotectionunit-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-driveprotectionunit-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot List Mailboxprotectionunits https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-mailboxprotectionunits.md
GET https://graph.microsoft.com/beta/solutions/backupRestore/mailboxProtectionUn
[!INCLUDE [sample-code](../includes/snippets/php/list-all-mailboxprotectionunit-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-all-mailboxprotectionunit-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot List Protectionpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-protectionpolicies.md
GET https://graph.microsoft.com/beta/solutions/backupRestore/ProtectionPolicies
[!INCLUDE [sample-code](../includes/snippets/php/protectionpolicybase-list-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/protectionpolicybase-list-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot List Restorepoints https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-restorepoints.md
GET https://graph.microsoft.com/beta/solutions/backupRestore/restorePoints?$expa
[!INCLUDE [sample-code](../includes/snippets/php/list-restorepoint-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-restorepoint-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot List Restoresessions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-restoresessions.md
GET https://graph.microsoft.com/beta/solutions/backupRestore/restoreSessions
[!INCLUDE [sample-code](../includes/snippets/php/restoresession-list-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/restoresession-list-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot List Serviceapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-serviceapps.md
GET https://graph.microsoft.com/beta/solutions/backupRestore/serviceApps
[!INCLUDE [sample-code](../includes/snippets/php/serviceapps-list-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/serviceapps-list-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot List Siteprotectionunits https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-siteprotectionunits.md
GET https://graph.microsoft.com/beta/solutions/backupRestore/siteProtectionUnits
[!INCLUDE [sample-code](../includes/snippets/php/list-all-siteprotectionunit-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-all-siteprotectionunit-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/solutions/backupRestore/sharePointProtectio
[!INCLUDE [sample-code](../includes/snippets/php/list-siteprotectionunit-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-siteprotectionunit-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot Post Exchangeprotectionpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-exchangeprotectionpolicies.md
POST https://graph.microsoft.com/beta/solutions/backupRestore/exchangeProtection
[!INCLUDE [sample-code](../includes/snippets/php/exchangeprotectionpolicy-create-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/exchangeprotectionpolicy-create-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot Post Exchangerestoresessions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-exchangerestoresessions.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/exchangerestoresession-create-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/exchangerestoresession-create-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot Post Onedriveforbusinessprotectionpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessprotectionpolicies.md
POST https://graph.microsoft.com/beta/solutions/backupRestore/oneDriveForBusines
[!INCLUDE [sample-code](../includes/snippets/php/onedriveforbusinessprotectionpolicy-create-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/onedriveforbusinessprotectionpolicy-create-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot Post Onedriveforbusinessrestoresessions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-onedriveforbusinessrestoresession-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-onedriveforbusinessrestoresession-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot Post Serviceapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-serviceapps.md
POST /solutions/backupRestore/serviceApps
## Request body
-Do not supply a request body for this method.
+In the request body, supply an empty JSON object `{}` for this method.
## Response
If successful, this method returns a `201 Created` response code and a [serviceA
### Request The following example shows a request.+ # [HTTP](#tab/http) <!-- { "blockType": "request",
The following example shows a request.
--> ``` http POST https://graph.microsoft.com/beta/solutions/backupRestore/serviceApps
+Content-type: application/json
+
+{
+}
``` # [C#](#tab/csharp)
POST https://graph.microsoft.com/beta/solutions/backupRestore/serviceApps
[!INCLUDE [sample-code](../includes/snippets/php/create-serviceapp-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-serviceapp-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot Post Sharepointprotectionpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-sharepointprotectionpolicies.md
POST https://graph.microsoft.com/beta/solutions/backupRestore/sharePointProtecti
[!INCLUDE [sample-code](../includes/snippets/php/sharepointprotectionpolicy-create-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/sharepointprotectionpolicy-create-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Backuprestoreroot Post Sharepointrestoresessions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-sharepointrestoresessions.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/sharepointrestoresession-create-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/sharepointrestoresession-create-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Basetask Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/basetask-delta.md
includes the encoded, desired parameters.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer | string | odata.maxpagesize={x}. Optional. | ## Request body
v1.0 Basetasklist Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/basetasklist-delta.md
includes the encoded, desired parameters.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer | string | odata.maxpagesize={x}. Optional. | ## Request body
v1.0 Bookingstaffmember Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingstaffmember-update.md
PATCH /solutions/bookingbusinesses/{id}/staffMembers/{id}
| Authorization | Bearer {code}. Required.| ## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type |Description| |:|:--|:-|
v1.0 Businessscenarioplanner Post Tasks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/businessscenarioplanner-post-tasks.md
POST https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c68649
Content-Type: application/json {
- "@odata.type": "#microsoft.graph.businessScenarioTask",
"title": "Customer order #12010", "percentComplete": 0, "priority": 5,
v1.0 Businessscenariotask Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/businessscenariotask-update.md
PATCH https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864
Content-Type: application/json {
- "@odata.type": "#microsoft.graph.businessScenarioTask",
"title": "Customer order #12010", "percentComplete": 20, "priority": 1,
v1.0 Calendar Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendar-delete.md
DELETE /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}
## Request headers | Name | Type | Description| |:|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Calendar Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendar-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Calendar Getschedule https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendar-getschedule.md
POST /users/{id|userPrincipalName}/calendar/getSchedule
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity, which is application/json. Required. | | Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. |
v1.0 Calendar List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendar-list-calendarview.md
This method also supports some of the [OData Query Parameters](/graph/query-para
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | ## Request body
v1.0 Calendar List Events https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendar-list-events.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | ## Request body
v1.0 Calendargroup Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendargroup-delete.md
DELETE /users/{id | userPrincipalName}/calendarGroups/{id}
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Calendargroup Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendargroup-get.md
This method supports the [OData query parameters](/graph/query-parameters) to he
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Calendargroup List Calendars https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendargroup-list-calendars.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Callrecording Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/callrecording-delta.md
Content-type: application/json
"@odata.type": "#microsoft.graph.callRecording", "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
- "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
"createdDateTime": "2023-12-02T06:59:34.7411768Z", "recordingContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", "meetingOrganizer": {
Content-type: application/json
"@odata.type": "#microsoft.graph.callRecording", "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
- "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
"createdDateTime": "2023-12-02T06:59:34.7411768Z", "recordingContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", "meetingOrganizer": {
Content-type: application/json
"@odata.type": "#microsoft.graph.callRecording", "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
- "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
"createdDateTime": "2023-12-02T06:59:34.7411768Z", "recordingContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", "meetingOrganizer": {
Content-type: application/json
"@odata.type": "#microsoft.graph.callRecording", "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
- "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
"createdDateTime": "2023-12-02T06:59:34.7411768Z", "recordingContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", "meetingOrganizer": {
v1.0 Callrecording Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/callrecording-get.md
For a recording, this API returns the metadata of the single recording associate
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
-<!-- { "blockType": "permissions", "name": "callrecording_get" } -->
+<!-- { "blockType": "ignored", "name": "callrecording_get" } -->
+|Permission type|Least privileged permissions|Higher privileged permissions|
+|:|:|:|
+|Delegated (work or school account)|OnlineMeetingRecording.Read.All|Not available.|
+|Delegated (personal Microsoft account)|Not supported.|Not supported.|
+|Application|OnlineMeetingRecording.Read.All, OnlineMeetingRecording.Read.Chat|Not available|
> **Notes:** >
To use application permissions for this API, tenant administrators must create a
Get a single recording of an online meeting.
+<!-- { "blockType": "ignored" } -->
```http GET /me/onlineMeetings/{meetingId}/recordings/{recordingId} GET /users/{userId}/onlineMeetings/{meetingId}/recordings/{recordingId}
GET /users/{userId}/onlineMeetings/{meetingId}/recordings/{recordingId}
Get the content of a single recording of an online meeting.
+<!-- { "blockType": "ignored" } -->
```http GET /me/onlineMeetings/{meetingId}/recordings/{recordingId}/content GET /users/{userId}/onlineMeetings/{meetingId}/recordings/{recordingId}/content
Content-type: application/json
"id": "7e31db25-bc6e-4fd8-96c7-e01264e9b6fc", "meetingId": "MSpiOTM1ZTY3NS01ZTY3LTQ4YjktOGQ0NS0yNDlkNWY4OGU5NjQqMCoqMTk6bWVldGluZ19ZbU0zTnpJNU9USXRZakU0WlMwME1tUTNMVGt6TVRRdFkyWm1PRGRtWmpsaVptRTNAdGhyZWFkLnYy", "callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
- "meetingOrganizerId": "b935e675-5e67-48b9-8d45-249d5f88e964",
"createdDateTime": "2023-04-10T08:13:17.5990966Z", "endDateTime": "2024-01-29T09:27:25.2346000Z", "contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
Content-Type: video/mp4
<bytes of a recording> ```+
+### Example 3: Get a callRecording from a corresponding transcript using contentCorrelationId
+
+The following example shows how to get a single recording of an online meeting corresponding to a transcript using the **contentCorrelationId** property.
+
+#### Request
+
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_callRecording_using_contentCorrelationId",
+ "sampleKeys": ["MSoxMjczYTAxNi0yMDFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIqMCoqMTk6bWVldGluZ19OV1EwWm1GbFpEY3RORFJqTmkwMFlXRm1MV0U1WXpBdE9UZzJNMk0yTm1Nd1pERTNAdGhyZWFkLnYy"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/betFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIqMCoqMTk6bWVldGluZ19OV1EwWm1GbFpEY3RORFJqTmkwMFlXRm1MV0U1WXpBdE9UZzJNMk0yTm1Nd1pERTNAdGhyZWFkLnYy/recordings?$filter=contentcorrelationId+eq+'e87c8cf8-50f7-4252-8b9c-ad08ac0fa88d-0'
+```
+
+#### Response
+
+The following example shows the response.
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.callRecording"
+}
+-->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/betFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIqMCoqMTk6bWVldGluZ19OV1EwWm1GbFpEY3RORFJqTmkwMFlXRm1MV0U1WXpBdE9UZzJNMk0yTm1Nd1pERTNAdGhyZWFkLnYy')/recordings",
+ "@odata.count": 1,
+ "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET me/onlineMeetings('<key>')/recordings?$select=callId,content",
+ "value": [
+ {
+ "id": "VjIjIzExMjczYTAxNi0yMDFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIyNDMyYjU3Yi0wYWJkLTQzZGItYWE3Yi0xNmVhZGQxMTVkMzQwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODAwMDAwMDAwNDA3ZjYyNjg0ZmQ0ZGEwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDRiZWQ5YTIzZGMyZmZmNDY4OTc4OTg0NjU2ZjI3MjE5IyM5YzM3ZDZhMS1mNGJmLTRjZWMtOTFmYS0xNDc1MGUwNzFhMTg=",
+ "meetingId": "MSoxMjczYTAxNi0yMDFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIqMCoqMTk6bWVldGluZ19OV1EwWm1GbFpEY3RORFJqTmkwMFlXRm1MV0U1WXpBdE9UZzJNMk0yTm1Nd1pERTNAdGhyZWFkLnYy",
+ "callId": "26c38520-e74d-4391-8188-cb458d413825",
+ "contentCorrelationId": "e87c8cf8-50f7-4252-8b9c-ad08ac0fa88d-0",
+ "createdDateTime": "2024-07-12T11:37:59.0113199Z",
+ "endDateTime": "2024-07-12T11:38:11.3313199Z",
+ "recordingContentUrl": "https://graph.microsoft.com/betRiZWQ5YTIzZGMyZmZmNDY4OTc4OTg0NjU2ZjI3MjE5IyM5YzM3ZDZhMS1mNGJmLTRjZWMtOTFmYS0xNDc1MGUwNzFhMTg=/content",
+ "meetingOrganizer": {
+ "application": null,
+ "device": null,
+ "user": {
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "1273a016-201d-4f95-8083-1b7f99b3edeb",
+ "displayName": null,
+ "userIdentityType": "aadUser",
+ "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
+ }
+ }
+ }
+ ]
+}
+```
+
v1.0 Callrecords Cloudcommunications List Callrecords https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/callrecords-cloudcommunications-list-callrecords.md
Get the list of [callRecord](../resources/callrecords-callrecord.md) objects and
<!-- { "blockType": "ignored" } --> ## Permissions
v1.0 Calltranscript Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calltranscript-delta.md
Content-type: application/json
"@odata.type": "#microsoft.graph.callTranscript", "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
- "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
"createdDateTime": "2023-12-02T06:59:34.7411768Z", "transcriptContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", "meetingOrganizer": {
Content-type: application/json
"@odata.type": "#microsoft.graph.callTranscript", "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
- "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
"createdDateTime": "2023-12-02T06:59:34.7411768Z", "transcriptContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", "meetingOrganizer": {
Content-type: application/json
"@odata.type": "#microsoft.graph.callTranscript", "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
- "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
"createdDateTime": "2023-12-02T06:59:34.7411768Z", "transcriptContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", "meetingOrganizer": {
Content-type: application/json
"@odata.type": "#microsoft.graph.callTranscript", "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=", "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
- "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
"createdDateTime": "2023-12-02T06:59:34.7411768Z", "transcriptContentUrl": "https://graph.microsoft.com/betAtOWJiMy1jMTUzYzE4ODY4NGY=/content", "meetingOrganizer": {
v1.0 Calltranscript Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calltranscript-get.md
Retrieving the transcript returns the metadata of the single transcript associat
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
-<!-- { "blockType": "permissions", "name": "calltranscript_get" } -->
+<!-- { "blockType": "ignored", "name": "calltranscript_get" } -->
+| Permission type| Least privileged permissions|Higher privileged permissions|
+| :| :| : |
+|Delegated (work or school account)| OnlineMeetingTranscript.Read.All| Not available.|
+|Delegated (personal Microsoft account)|Not supported.|Not supported.|
+|Application|OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read.Chat|Not available.|
> **Note:** The application permission `OnlineMeetingTranscript.Read.Chat` uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
Content-type: application/json
"id": "MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4", "meetingId": "MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ", "callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
- "meetingOrganizerId": "ba321e0d-79ee-478d-8e28-85a19507f456",
"createdDateTime": "2021-09-17T06:09:24.8968037Z", "endDateTime": "2021-09-17T06:27:25.2346000Z", "contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
v1.0 Channel Archive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-archive.md
Title: "channel: archive"
-description: "Archive a channel in a team. "
+description: "Archive a channel in a team."
ms.localizationpriority: medium
Namespace: microsoft.graph
Archive a [channel](../resources/channel.md) in a team. When a channel is archived, users can't send new messages or react to existing messages in the channel, edit the channel settings, or make other changes to the channel.
-You can delete an archived channel, or add and remove members from it. If you archive a team, its channels are archived for you.
+You can delete an archived channel or add and remove members from it. If you archive a team, its channels are also archived.
-Archiving is asynchronous; a channel is archived after the asynchronous archiving operation completes successfully, which might occur after the response returns.
+Archiving is an asynchronous operation; a channel is archived after the asynchronous archiving operation completes successfully, which might occur after the response returns.
-A channel without an owner, or that belongs to a [group](../resources/group.md) that has no owner, can't be archived.
+A channel without an owner or that belongs to a [group](../resources/group.md) that has no owner, can't be archived.
-To restore a channel from its archived state, use the [unarchive](channel-unarchive.md) method. A channel canΓÇÖt be archived or unarchived if its team is archived.
+To restore a channel from its archived state, use the [channel: unarchive](channel-unarchive.md) method. A channel canΓÇÖt be archived or unarchived if its team is archived.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
Choose the permission or permissions marked as least privileged for this API. Us
<!-- { "blockType": "permissions", "name": "channel_archive" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-archive-permissions.md)]
-> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
+> **Note**: This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't members of.
## HTTP request <!-- { "blockType": "ignored" } -->
POST /groups/{team-id}/team/channels/{channel-id}/archive
## Request headers
-| Header | Value |
-|:|:--|
-| Authorization | Bearer {token}. Required. |
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+| Content-Type | application/json. Optional. |
## Request body
-In the request, you can optionally include the `shouldSetSpoSiteReadOnlyForMembers` parameter in a JSON body, as follows.
-```JSON
+In the request body, you can optionally provide a JSON object with the following parameter.
+
+| Parameter | Type |Description|
+|:|:--|:-|
+|shouldSetSpoSiteReadOnlyForMembers|Boolean|Defines whether to set permissions for channel members to read-only on the SharePoint Online site associated with the team. If you set it to `false` or omit the parameter, this step is skipped.|
+
+The following example shows the request body with **shouldSetSpoSiteReadOnlyForMembers** set to `true`.
+
+```json
{
- "shouldSetSpoSiteReadOnlyForMembers": true
+ "shouldSetSpoSiteReadOnlyForMembers": true
} ```
-This optional parameter defines whether to set permissions for channel members to read-only on the SharePoint Online site associated with the team. Setting it to false or omitting the body altogether results in this step being skipped.
## Response
-If archiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header, which contains the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle archiving of the channel in a team. Check the status of the archiving operation by making a GET request to this location.
+If archiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header that specifies the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle the archiving of the channel in a team. Check the status of the archiving operation by making a GET request to this location.
## Examples
The following example shows a request to archive a channel.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "archive_channel"
+ "name": "archive_channel",
+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]
}--> ```http
-POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/archive
+POST https://graph.microsoft.com/beta/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/archive
``` # [C#](#tab/csharp)
The following example shows the response.
}--> ```http HTTP/1.1 202 Accepted
-Location: /teams/{team-id}/operations/{operation-id}
+Location: /teams/16dc05c0-2259-4540-a970-3580ff459721/operations/b7ee702a-d87f-4cc6-82b9-e731c16d3aba
Content-Type: text/plain Content-Length: 0 ``` ### Example 2: Archive a channel when the team is archived
-The following example shows a request when the **team is archived**.
+The following example shows a request to archive a channel that fails because the team is archived; the team must be active to archive or unarchive a channel.
#### Request
-<!-- { "blockType": "ignored" } -->
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "archive_channel_on_archived_team",
+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]
+}-->
```http
-POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/archive
+POST https://graph.microsoft.com/beta/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/archive
```
-#### Response
-The following example shows the `400` error response.
+# [C#](#tab/csharp)
-<!-- { "blockType": "ignored" } -->
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++
+#### Response
+The following example shows the `400 Bad Request` response code with a corresponding error message.
+
+<!-- {
+ "blockType": "response",
+ "name": "archive_channel_on_archived_team",
+ "@odata.type": "microsoft.graph.publicError",
+ "truncated": true
+}-->
```http http/1.1 400 Bad Request Content-Type: application/json
Content-Length: 193
} } }- ``` <!-- uuid: e848414b-4669-4484-ac36-1504c58a3fb8
v1.0 Channel Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-get.md
This method supports federation. Only a user who is a member of the shared chann
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
-This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of.
-
+This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't a member of.
<!-- { "blockType": "permissions", "name": "channel_get" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-get-permissions.md)]
v1.0 Channel List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-list.md
Retrieve the list of [channels](../resources/channel.md) in this [team](../resou
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
-This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of.
+This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't a member of.
<!-- { "blockType": "permissions", "name": "channel_list" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-list-permissions.md)]
v1.0 Channel Unarchive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-unarchive.md
Title: "channel: unarchive"
-description: "Restore an archived channel in a team. Unarchiving restores the ability for users to send messages and edit the channel."
+description: "Restore an archived channel in a team."
ms.localizationpriority: medium
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Restore an archived [channel](../resources/channel.md). Unarchiving restores the ability for users to send messages and edit the channel. Channels are archived via the [archive](channel-archive.md) API.
+Restore an archived [channel](../resources/channel.md). Unarchiving restores the ability for users to send messages and edit the channel. Channels are archived via the [channel: archive](channel-archive.md) method.
-Unarchiving is an asynchronous operation; a channel is unarchived when the asynchronous unarchive operation completes successfully, which might occur after this method responds.
+Unarchiving is an asynchronous operation; a channel is unarchived when the asynchronous unarchiving operation completes successfully, which might occur after this method responds.
-> **Note**: An archived channel that belongs to an archived team cannot be unarchived. Unarchive the team before you unarchive the channel; otherwise, an error will occur.
+> **Note**: An archived channel that belongs to an archived team cannot be unarchived. Unarchive the team before you unarchive the channel; otherwise, the request fails.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
Choose the permission or permissions marked as least privileged for this API. Us
<!-- { "blockType": "permissions", "name": "channel_unarchive" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-unarchive-permissions.md)]
-> **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
+> **Note**: This API supports admin permissions. Users with the Global Administrator or Microsoft Teams service admin roles can access teams that they aren't a member of.
## HTTP request <!-- { "blockType": "ignored" } -->
POST /groups/{team-id}/team/channels/{channel-id}/unarchive
## Request headers
-| Header | Value |
-|:|:--|
-| Authorization | Bearer {token}. Required. |
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
Don't supply a request body for this method.
## Response
-If unarchiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header, which contains the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle unarchiving of the channel of the team. Check the status of the unarchiving operation by making a GET request to this location.
+If unarchiving is started successfully, this method returns a `202 Accepted` response code. The response contains a `Location` header that specifies the location of the [teamsAsyncOperation](../resources/teamsasyncoperation.md) that was created to handle the unarchiving of the channel in a team. Check the status of the unarchiving operation by making a GET request to this location.
-## Example
+## Examples
### Example 1: Unarchive a channel The following example shows a request to unarchive a channel.
The following example shows a request to unarchive a channel.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "unarchive_channel"
+ "name": "unarchive_channel",
+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]
}--> ```http
-POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/unarchive
+POST https://graph.microsoft.com/beta/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/unarchive
``` # [C#](#tab/csharp)
The following example shows the response.
}--> ```http HTTP/1.1 202 Accepted
-Location: /teams/{team-id}/operations/{operation-id}
+Location: /teams/16dc05c0-2259-4540-a970-3580ff459721/operations/b7ee702a-d87f-4cc6-82b9-e731c16d3aba
Content-Type: text/plain Content-Length: 0 ``` ### Example 2: Unarchive a channel when the team is archived
-The following example shows a request to unarchive a channel in an archived team.
+The following example shows a request to unarchive a channel that fails because the team is archived; the team must be active to archive or unarchive a channel.
#### Request
-<!-- { "blockType": "ignored" } -->
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "unarchive_channel_on_archived_team",
+ "sampleKeys": ["16dc05c0-2259-4540-a970-3580ff459721", "19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2"]
+}-->
```http
-POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/unarchive
+POST https://graph.microsoft.com/beta/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/unarchive
```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++ #### Response
-The following example shows the `400` error response.
+The following example shows the `400 Bad Request` response code with a corresponding error message.
-<!-- { "blockType": "ignored" } -->
+<!-- {
+ "blockType": "response",
+ "name": "unarchive_channel_on_archived_team",
+ "@odata.type": "microsoft.graph.publicError",
+ "truncated": true
+}-->
```http http/1.1 400 Bad Request Content-Type: application/json
Content-Length: 193
} } }- ```+ <!-- uuid: 9a9bb83f-6f35-4426-bb04-73ca43ad6cc8 2015-10-25 14:57:30 UTC --> <!--
v1.0 Chartaxis Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chartaxis-update.md
PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/a
## Request body In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintains their previous values or are recalculated based on changes to other property values. For best performance, you shouldn't include existing values that didn't change.+ | Property | Type |Description| |:|:--|:-| |majorUnit|Json|Represents the interval between two major tick marks. Can be set to a numeric value or an empty string. The returned value is always a number.|
In the request body, supply the values for relevant fields that should be update
If successful, this method returns a `200 OK` response code and updated [workbookChartAxis](../resources/workbookchartaxis.md) object in the response body. ## Example
-##### Request
+### Request
The following example shows a request. # [HTTP](#tab/http)
Content-type: application/json
-##### Response
-The following example shows the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Chatmessage Post Replies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessage-post-replies.md
POST /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body In the request body, supply a JSON representation of a [message](../resources/chatmessage.md) object. Only the body property is mandatory. Other properties are optional.
v1.0 Claimsmappingpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/claimsmappingpolicy-update.md
PATCH /policies/claimsMappingPolicies/{id}
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type | Description | |:-|:|:|
v1.0 Cloudclipboarditem Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudclipboarditem-get.md
This method doesn't support the OData query parameters to customize the respone.
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
In addition to [general errors](/graph/errors) that apply to Microsoft Graph, th
|400|Bad request|The request is malformed or incorrect, such as an invalid `cloudClipboardItemId`.| |403|Forbidden|The caller can't perform the action. It indicates that the user doesn't consent to sharing [cloudClipboardItem](../resources/cloudclipboarditem.md).| |409|Conflict|The current state conflicts with what the request expects. It usually indicates that the user isn't eligible for the cloud clipboard feature because they don't have at least two devices authenticated through multi-factor authentication during the sign-in process.|
-|429|Too many requests|The request rate limit has been exceeded. Wait for the time specified in the `Retry-After` header and try again.|ΓÇ»
+|429|Too many requests|The request rate limit has been exceeded. Wait for the time specified in the `Retry-After` header and try again.|
## Examples
v1.0 Cloudclipboardroot List Items https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudclipboardroot-list-items.md
This method supports `$skipToken` [OData query parameters](/graph/query-paramete
| Name | Description | |:--|:-|
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer | odata.maxpagesize={x}. Optional. Specifies a preferred integer {x} page size for paginated results. Acceptable values are 1 to 200, inclusive. If not specified in the header, the default page size is 110. | ## Request body
In addition to [general errors](/graph/errors) that apply to Microsoft Graph, so
|400|Bad request|The request is malformed or incorrect, such as invalid page size or invalid `$skipToken` value.| |403|Forbidden|The caller can't perform the action. It indicates that the user has not consented to share [cloudClipboardItem](../resources/cloudclipboarditem.md).| |409|Conflict|The current state conflicts with what the request expects. It usually indicates that the user isn't eligible for the cloud clipboard feature because they don't have at least two devices authenticated through multi-factor authentication during the sign-in process.|
-|429|Too many requests|The request rate limit has been exceeded. Wait for the time specified in the `Retry-After` header and try again.|ΓÇ»
+|429|Too many requests|The request rate limit has been exceeded. Wait for the time specified in the `Retry-After` header and try again.|
## Examples
v1.0 Cloudpc Bulkresize https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpc-bulkresize.md
Content-Type: application/json
"lastUpdatedDateTime": "2021-06-23T09:28:32.8260338Z", "cloudPcId": "30d0e128-de93-41dc-89ec-33d84bb662a0", "managedDeviceId": "bdc8e6dd-0455-4412-83d9-c818664fe1f1",
- "statusDetails": null
+ "statusDetails": null,
+ "statusDetail": null
}, { "@odata.type":"https://graph.microsoft.com/beta/$metadata#microsoft.graph.cloudPcRemoteActionResult",
Content-Type: application/json
"lastUpdatedDateTime": "2021-06-23T09:28:32.8260338Z", "cloudPcId": "7c82a3e3-9459-44e4-94d9-b92f93bf78dd", "managedDeviceId": "e87f50c7-fa7f-4687-aade-dd45f3d65970",
- "statusDetails": null
+ "statusDetails": null,
+ "statusDetail": null
} ] }
v1.0 Cloudpc Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpc-get.md
The following example shows a request.
--> ``` http
-GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/40cee9d2-03fb-4066-8d35-dbdf2875c33f?$select=id,displayName,imageDisplayName,lastModifiedDateTime,lastRemoteActionResult,lastLoginResult,connectivityResult,allotmentDisplayName
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/40cee9d2-03fb-4066-8d35-dbdf2875c33f?$select=id,displayName,imageDisplayName,lastModifiedDateTime,lastRemoteActionResult,lastLoginResult,connectivityResult,allotmentDisplayName,deviceRegionName
``` # [C#](#tab/csharp)
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/4
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php)
Content-Type: application/json
} ] },
- "allotmentDisplayName": null
+ "allotmentDisplayName": null,
+ "deviceRegionName": "eastus2"
} ```
Content-Type: application/json
"diskEncryptionState": "notAvailable" } ```+
+### Example 4: List Cloud PCs filtered by disaster recovery capability type
+
+The following example shows how to list Cloud PCs filtered by disaster recovery capability type and select specific parameters.
+
+#### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_cloudpc_disasterrecoverycapability"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs?$select=id,displayName,disasterRecoveryCapability&$filter=disasterRecoveryCapability/capabilityType eq 'failover'
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++
+#### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "name": "get_cloudpc_disasterrecoverycapability",
+ "@odata.type": "microsoft.graph.cloudPC"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#deviceManagement/virtualEndpoint/cloudPCs(id,displayName,disasterRecoveryCapability)",
+ "value": [
+ {
+ "id": "662009bc-7732-4f6f-8726-25883518b33e",
+ "displayName": "Demo-0",
+ "disasterRecoveryCapability": {
+ "primaryRegion": "eastus",
+ "secondaryRegion": "westus",
+ "capabilityType": "failover"
+ }
+ },
+ {
+ "id": "ac74ae8b-85f7-4272-88cc-5419267403ed",
+ "displayName": "Demo-1",
+ "disasterRecoveryCapability": {
+ "primaryRegion": "eastus",
+ "secondaryRegion": "westus",
+ "capabilityType": "failover"
+ }
+ }
+ ]
+}
+```
++
v1.0 Cloudpc Getprovisionedcloudpcs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpc-getprovisionedcloudpcs.md
Don't supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a [cloudPC](../resources/cloudPC.md) collection in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [cloudPC](../resources/cloudpc.md) objects in the response body.
## Examples
The following example shows the response.
<!-- { "blockType": "response", "@odata.type": "Collection(microsoft.graph.cloudPC)",
- "name": "cloudpc.getProvisionedCloudPCs"
+ "name": "cloudpc.getProvisionedCloudPCs",
+ "truncated": true
} -->
Content-Type: application/json
"statusDetails": null, "provisioningType": "dedicated", "allotmentDisplayName": null,
+ "deviceRegionName": "eastus2",
"connectivityResult": "", "gracePeriodEndDateTime": null, "lastLoginResult": "2020-07-23T10:29:57Z",
Content-Type: application/json
"statusDetails": null, "provisioningType": "dedicated", "allotmentDisplayName": null,
+ "deviceRegionName": "eastus2",
"connectivityResult": "", "gracePeriodEndDateTime": null, "lastLoginResult": "2020-07-23T10:29:57Z",
v1.0 Cloudpc Retrievecloudpcremoteactionresults https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpc-retrievecloudpcremoteactionresults.md
+
+ Title: "cloudPC: retrieveCloudPcRemoteActionResults"
+description: "Retrieve remote action results and check the status of a specific remote action performed on the associated Cloud PC device."
+
+ms.localizationpriority: medium
+++
+# cloudPC: retrieveCloudPcRemoteActionResults
+
+Namespace: microsoft.graph
++
+Retrieve [remote action results](../resources/cloudpcremoteactionresult.md) and check the status of a specific remote action performed on the associated Cloud PC device.
++
+## Permissions
+
+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
+
+<!-- { "blockType": "permissions", "name": "cloudpc-retrievecloudpcremoteactionresults" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET /deviceManagement/virtualEndpoint/cloudPCs/{id}/retrieveCloudPcRemoteActionResults
+```
+
+## Request headers
+
+| Name | Description |
+| : | : |
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [cloudPcRemoteActionResult](../resources/cloudpcremoteactionresult.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "cloudpc_retrievecloudpcremoteactionresults"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/46ed3acc-70f8-4978-a5ba-62945ecc5e4c/retrieveCloudPcRemoteActionResults
+```
+
+### Response
+
+The following example shows the response.
+
+> **Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.cloudPcRemoteActionResult)"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.cloudPcRemoteActionResult)",
+ "value": [
+ {
+ "actionName": "CloudPcPowerOn",
+ "actionState": "done",
+ "startDateTime": "2024-05-28T06:12:47.4100777Z",
+ "lastUpdatedDateTime": "2024-05-28T06:13:45.2270925Z",
+ "cloudPcId": "46ed3acc-70f8-4978-a5ba-62945ecc5e4c",
+ "managedDeviceId": null,
+ "statusDetail": null,
+ "statusDetails": null
+ }
+ ]
+}
+```
v1.0 Cloudpcauditevent Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcauditevent-get.md
Content-Type: application/json
"newValue": "new-adDomainUsername" } ],
- "type": "CloudPcOnPremisesConnection",
"resourceType": "CloudPcOnPremisesConnection", "resourceId": "a7508af8-d334-41ba-83a7-26cc88959724" }
v1.0 Cloudpcbulkaction Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcbulkaction-get.md
If successful, this method returns a `200 OK` response code and a [cloudPcBulkAc
### Request The following example shows a request.+ # [HTTP](#tab/http) <!-- { "blockType": "request",
The following example shows a request.
} --> ``` http
-GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/bulkActions/231ad98f-41b3-872b-dd37-c70bf22cbdac
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/bulkActions/0d76d02b-e0a0-4f58-baff-d1718cc2d144
``` # [C#](#tab/csharp)
Content-Type: application/json
{ "value": {
- "@odata.type": "#microsoft.graph.cloudPcBulkAction",
- "id": "231ad98f-41b3-872b-dd37-c70bf22cbdac",
- "displayName": "Bulk Power Off by Andy",
+ "@odata.type": "#microsoft.graph.cloudPcBulkPowerOn",
+ "displayName": "BulkPowerOn on 2024-6-14 17:05:43 GMT-0300 (French Guiana Time)",
+ "id": "0d76d02b-e0a0-4f58-baff-d1718cc2d144",
"cloudPcIds": [
- "d6e0b8ee-8836-4b8d-b038-6130a97a3a9d",
- "85994912-197b-4927-b569-447bd81350ec"
+ "a38fdc98-0861-4de6-9892-0c793dad36d4"
],
+ "scheduledDuringMaintenanceWindow": false,
+ "createdDateTime": "2024-06-14T20:05:44.5239567Z",
+ "status": "succeeded",
+ "initiatedByUserPrincipalName": "johnd@contoso.com",
"actionSummary": {
- "failedCount": 1,
- "inProgressCount": 0,
- "notSupportedCount": 0,
- "pendingCount": 1,
- "successfulCount": 0
- },
- "scheduledDuringMaintenanceWindow": true,
- "createdDateTime": "2024-02-05T10:29:57Z"
+ "failedCount": 0,
+ "inProgressCount": 0,
+ "notSupportedCount": 0,
+ "pendingCount": 0,
+ "successfulCount": 1
+ }
} } ```
v1.0 Cloudpcreports Getcloudpcrecommendationreports https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcreports-getcloudpcrecommendationreports.md
POST /deviceManagement/virtualEndpoint/reports/getCloudPcRecommendationReports
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Cloudpcreports Post Exportjobs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcreports-post-exportjobs.md
You can specify the following properties when you create a **cloudPcExportJob**.
|Property|Type|Description| |:|:|:| |filter|String|The filter applied on the report. Optional.|
-|reportName|cloudPcReportName|The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `sharedUseLicenseUsageReport`, `sharedUseLicenseUsageRealTimeReport`, `unknownFutureValue`, `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `inaccessibleCloudPcReports`.|
+|reportName|cloudPcReportName|The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `sharedUseLicenseUsageReport`, `sharedUseLicenseUsageRealTimeReport`, `unknownFutureValue`, `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`.|
|select|String collection|The selected columns of the report. Optional.| ## Response
v1.0 Cloudpcreports Retrievecrossregiondisasterrecoveryreport https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcreports-retrievecrossregiondisasterrecoveryreport.md
+
+ Title: "cloudPcReports: retrieveCrossRegionDisasterRecoveryReport"
+description: "Retrieve the Windows 365 cross-region disaster recovery report, including CloudPcId, UserId, DeviceId, CloudPCDeviceDisplayName, UserPrincipalName, IsCrossRegionEnabled, CrossRegionHealthStatus, LicenseType, DisasterRecoveryStatus, CurrentRestorePointDateTime, and ActivationExpirationDateTime."
+
+ms.localizationpriority: medium
+++
+# cloudPcReports: retrieveCrossregionDisasterRecoveryReport
+
+Namespace: microsoft.graph
++
+Retrieve the Windows 365 cross-region disaster recovery report, including CloudPcId, UserId, DeviceId, CloudPCDeviceDisplayName, UserPrincipalName, IsCrossRegionEnabled, CrossRegionHealthStatus, LicenseType, DisasterRecoveryStatus, CurrentRestorePointDateTime, and ActivationExpirationDateTime.
++
+## Permissions
+
+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
+
+<!-- { "blockType": "permissions", "name": "cloudpcreports_retrievecrossregiondisasterrecoveryreport" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/virtualEndpoint/reports/retrieveCrossRegionDisasterRecoveryReport
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
+| Content-Type | application/json. Required. |
+
+## Request body
+
+In the request body, supply a JSON representation of the parameters.
+
+The following table shows the parameters that you can use with this action.
+
+| Parameter | Type | Description |
+| : | :- | :- |
+| filter | String | OData `$filter` syntax. The supported filters are: `and`, `or`, `lt`, `le`, `gt`, `ge`, and `eq`. |
+| groupBy | String collection | Specifies how to group the reports. If used, must have the same content as the **select** parameter. |
+| orderBy | String collection | Specifies how to sort the reports. |
+| search | String | Specifies a String to search. |
+| select | String collection | OData `$select` syntax. The selected columns of the reports. |
+| skip | Int32 | The number of records to skip. |
+| top | Int32 | The number of top records to return. |
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a Stream in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "cloudpcreportsthis.retrievecrossregiondisasterrecoveryreport"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/retrievecrossregiondisasterrecoveryreport
+Content-Type: application/json
+Content-length: 199
+
+{
+ "filter": "DisasterRecoveryStatus eq 'Active outage'",
+ "select": [
+ "Id",
+ "CloudPcId",
+ "UserId",
+ "UserSettingId",
+ "DeviceId",
+ "CloudPCDeviceDisplayName",
+ "UserPrincipalName",
+ "IsCrossRegionEnabled",
+ "CrossRegionHealthStatus",
+ "LicenseType",
+ "DisasterRecoveryStatus",
+ "CurrentRestorePointDateTime",
+ "ActivationExpirationDateTime"
+ ],
+ "skip": 0,
+ "top": 50
+}
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++
+### Response
+
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Edm.Stream"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/octet-stream
+
+{
+ "TotalRowCount": 1,
+ "Schema": [
+ {
+ "Column": "Id",
+ "PropertyType": "String"
+ },
+ {
+ "Column": "CloudPcId",
+ "PropertyType": "String"
+ },
+ {
+ "Column": "UserId",
+ "PropertyType": "String"
+ },
+ {
+ "Column": "UserSettingId",
+ "PropertyType": "String"
+ },
+ {
+ "Column": "DeviceId",
+ "PropertyType": "String"
+ },
+ {
+ "Column": "CloudPcDeviceDisplayName",
+ "PropertyType": "String"
+ },
+ {
+ "Column": "UserPrincipalName",
+ "PropertyType": "String"
+ },
+ {
+ "Column": "IsCrossRegionEnabled",
+ "PropertyType": "Boolean"
+ },
+ {
+ "Column": "CrossRegionHealthStatus",
+ "PropertyType": "String"
+ },
+ {
+ "Column": "LicenseType",
+ "PropertyType": "String"
+ },
+ {
+ "Column": "DisasterRecoveryStatus",
+ "PropertyType": "String"
+ },
+ {
+ "Column": "CurrentRestorePointDateTime",
+ "PropertyType": "DateTime"
+ },
+ {
+ "Column": "ActivationExpirationDateTime",
+ "PropertyType": "DateTime"
+ }
+ ],
+ "Values": [
+ [
+ "7768debd-7955-4b32-a654-a02894bce953",
+ "69360332-619a-4b38-af5d-91ecef72f789",
+ "c939b389-979f-4687-945d-d1220b3d4d24",
+ "k739b389-979f-4j87-945d-d3220b3d4o24",
+ "9330ff50-0a1b-4038-8fe8-3c4a67ec4dc5",
+ "CPC-Cross-JG79E",
+ "john.doe@contoso.com",
+ true,
+ "Unhealthy:'ANC unhealthy', 'Network mismatch'",
+ "Cross Region",
+ "Active outage",
+ "2023-10-16 03:05:14.131 AM",
+ "2023-10-19 07:05:14.131 AM"
+ ]
+ ]
+}
+```
v1.0 Community Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/community-delete.md
+
+ Title: "Delete community"
+description: "Delete a community in Viva Engage."
+
+ms.localizationpriority: medium
+++
+# Delete community
+
+Namespace: microsoft.graph
++
+Delete a Viva Engage [community](../resources/community.md) along with all associated Microsoft 365 content, including the connected Microsoft 365 group, OneNote notebook, and Planner plans. For more information, see [What happens if I delete a Viva Engage community connected to Microsoft 365 groups](/viva/engage/engage-microsoft-365-groups#q-what-happens-if-i-delete-a-viva-engage-community-connected-to-microsoft-365-groups).
++
+## Permissions
+
+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
+
+<!-- { "blockType": "permissions", "name": "community_delete" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /employeeExperience/communities/{communityId}
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "delete_community",
+ "sampleKeys": ["eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0"]
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/employeeExperience/communities/eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Community Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/community-update.md
+
+ Title: "Update community"
+description: "Update the properties of an existing Viva Engage community."
+
+ms.localizationpriority: medium
+++
+# Update community
+
+Namespace: microsoft.graph
++
+Update the properties of an existing Viva Engage [community](../resources/community.md).
++
+## Permissions
+
+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
+
+<!-- { "blockType": "permissions", "name": "community_update" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /employeeExperience/communities/{communityId}
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+| description | String | The description of the community. Maximum length is 1024 characters. |
+| displayName | String | The name of the community. Maximum length is 255 characters. |
+| privacy | [communityPrivacy](../resources/community.md#communityprivacy-values) | Defines the privacy level of the community. The possible values are: `public`, `private`, `unknownFutureValue`. |
++
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_community",
+ "sampleKeys": ["eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0"]
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/employeeExperience/communities/eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0
+Content-Type: application/json
+
+{
+ "displayName": "Financial Advice for Software Engineers",
+ "description": "A community where financial advisors who represent customers from software engineering profession can discuss advice and suggestions for their clients.",
+ "privacy": "public"
+}
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Compliantnetworknamedlocation Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/compliantnetworknamedlocation-get.md
GET https://graph.microsoft.com/beta/identity/conditionalAccess/namedLocations/3
- ### Response The following example shows the response.
v1.0 Contact Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contact-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 Contactfolder Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contactfolder-delete.md
DELETE /users/{id | userPrincipalName}/contactFolders/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Contactfolder Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contactfolder-delta.md
_id_ property is always returned.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. |
v1.0 Contactfolder Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contactfolder-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Contactfolder List Childfolders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contactfolder-list-childfolders.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Contactfolder List Contacts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contactfolder-list-contacts.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Contentmodel Addtodrive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contentmodel-addtodrive.md
Namespace: microsoft.graph
Apply a [contentModel](../resources/contentmodel.md) to SharePoint document libraries. For an existing model that's already trained, this action automatically processes new documents that are added to the SharePoint libraries. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
v1.0 Contentmodel Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contentmodel-get.md
Namespace: microsoft.graph
Read the properties and relationships of a [contentModel](../resources/contentmodel.md) object. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
Content-Type: application/json
"name":"BenefitChangeNotice", "createdBy": { "user": {
- "displayName": "Travis Li",
- "email": "travisli@microsoft.com",
+ "displayName": "John Doe",
+ "email": "johnd@contoso.com",
"resourceVisualization": {
- "acronym": "TL",
+ "acronym": "JD",
"color": "#881798" } }
Content-Type: application/json
"createdDateTime": "2023-04-30T08:32:00Z", "lastModifiedBy": { "user": {
- "displayName": "Travis Li",
- "email": "travisli@microsoft.com",
+ "displayName": "John Doe",
+ "email": "johnd@contoso.com",
"resourceVisualization": {
- "acronym": "TL",
+ "acronym": "JD",
"color": "#881798" } }
v1.0 Contentmodel Getapplieddrives https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contentmodel-getapplieddrives.md
Namespace: microsoft.graph
List all the [contentModelUsage](../resources/contentmodel.md) information related to a [contentModel](../resources/contentmodel.md) applied to a SharePoint document library. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
v1.0 Contentmodel Removefromdrive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contentmodel-removefromdrive.md
Namespace: microsoft.graph
Remove a [contentModel](../resources/contentmodel.md) from a SharePoint document library. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
v1.0 Continuousaccessevaluationpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/continuousaccessevaluationpolicy-update.md
PATCH /identity/continuousAccessEvaluationPolicy
|Content-Type|application/json. Required.| ## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
|Property|Type|Description| |:|:|:|
v1.0 Conversation Post Threads https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/conversation-post-threads.md
POST /groups/{id}/conversations/{id}/threads
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body In the request body, supply a JSON representation of the [conversationThread](../resources/conversationthread.md) object.
v1.0 Conversationmembers Add https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/conversationmembers-add.md
Namespace: microsoft.graph
Add multiple members in a single request to a [team](../resources/team.md). The response provides details about which memberships could and couldn't be created.
+> [!NOTE]
+> Sometimes it takes time to reflect the addition of a member after they're added. Users can use [change notifications](../resources/change-notifications-api-overview.md) to subscribe to notifications for membership changes in a particular team.
+ [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions
Content-Type: application/json
#### Response
-The following is the response.
+The following example shows the response.
> **Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Countrynamedlocation Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/countrynamedlocation-update.md
PATCH /identity/conditionalAccess/namedLocations/{id}
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
You must specify the **@odata.type** as `#microsoft.graph.countryNamedLocation`.
v1.0 Crosstenantaccesspolicyconfigurationdefault Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/crosstenantaccesspolicyconfigurationdefault-update.md
PATCH /policies/crossTenantAccessPolicy/default
| b2bDirectConnectOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your default configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B direct connect. | | inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the default configuration for trusting other Conditional Access claims from external Microsoft Entra organizations. | | invitationRedemptionIdentityProviderConfiguration | [defaultInvitationRedemptionIdentityProviderConfiguration](../resources/defaultInvitationRedemptionIdentityProviderConfiguration.md) | Defines the priority order based on which an identity provider will be chosen during invitation redemption. |
-| tenantRestrictions |[crossTenantAccessPolicyTenantRestrictions](../resources/crosstenantaccesspolicytenantrestrictions.md) | Defines the default tenant restrictions configuration for your organization users accessing an external organization on your network or devices. |
+| tenantRestrictions |[crossTenantAccessPolicyTenantRestrictions](../resources/crosstenantaccesspolicytenantrestrictions.md) | Defines the default tenant restrictions configuration for users in your organization who access an external organization on your network or devices. |
## Response
v1.0 Crosstenantaccesspolicyconfigurationpartner Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/crosstenantaccesspolicyconfigurationpartner-update.md
PATCH /policies/crossTenantAccessPolicy/partners/{id}
| b2bDirectConnectInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users from other organizations accessing your resources via Microsoft Entra B2B direct connect. | | b2bDirectConnectOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users in your organization going outbound to access resources in another organization via Microsoft Entra B2B direct connect. | | inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the partner-specific configuration for trusting other Conditional Access claims from external Microsoft Entra organizations. |
+| tenantRestrictions |[crossTenantAccessPolicyTenantRestrictions](../resources/crosstenantaccesspolicytenantrestrictions.md) | Defines the default tenant restrictions configuration for users in your organization who access an external organization on your network or devices. |
## Response
HTTP/1.1 204 No Content
### Example 3: Configure tenant restrictions settings
+The following example shows how to configure tenant restrictions settings.
+ #### Request
+The following example shows a request.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
PATCH https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy/partners
Content-Type: application/json {
-"tenantRestrictions": {
- "usersAndGroups": {
- "accessType": "allowed",
- "targets": [
- {
- "target": "AllUsers",
- "targetType": "user"
- }
- ]
- },
- "applications": {
- "accessType": "allowed",
- "targets": [
- {
- "target": "Office365",
- "targetType": "application"
- }
- ]
+ "tenantRestrictions": {
+ "usersAndGroups": {
+ "accessType": "allowed",
+ "targets": [
+ {
+ "target": "AllUsers",
+ "targetType": "user"
}
+ ]
+ },
+ "applications": {
+ "accessType": "allowed",
+ "targets": [
+ {
+ "target": "Office365",
+ "targetType": "application"
+ }
+ ]
}
+ }
} ```
The following example shows the response.
``` http HTTP/1.1 204 No Content ```+
v1.0 Customappscope Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/customappscope-update.md
PATCH /roleManagement/exchange/customAppScopes/{id}
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
## Response
v1.0 Customclaimspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/customclaimspolicy-get.md
GET https://graph.microsoft.com/beta/servicePrincipals/{servicePrincipalsId}/cla
[!INCLUDE [sample-code](../includes/snippets/php/list-customclaimspolicy-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-customclaimspolicy-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Customclaimspolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/customclaimspolicy-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-customclaimspolicy-from--php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-customclaimspolicy-from--python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Directory Delete Externaluserprofiles https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-delete-externaluserprofiles.md
DELETE /directory/externalUserProfiles/{id}
|Name|Description| |:|:-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Directory Delete Pendingexternaluserprofiles https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-delete-pendingexternaluserprofiles.md
DELETE /directory/pendingExternalUserProfiles/{id}
|Name|Description| |:|:-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Directory List Externaluserprofiles https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-list-externaluserprofiles.md
For more information, see [OData query parameters](/graph/query-parameters).
|Name|Description| |:|:-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Directory List Pendingexternaluserprofile https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-list-pendingexternaluserprofile.md
This method supports the `$filter` OData query parameter to help customize the r
|Name|Description| |:|:-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Directory Post Pendingexternaluserprofile https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-post-pendingexternaluserprofile.md
POST /directory/pendingExternalUserProfiles
|Name|Description| |:|:-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Directoryobject Getmembergroups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directoryobject-getmembergroups.md
Namespace: microsoft.graph
Return all the group IDs for the groups that the specified [user](../resources/user.md), [group](../resources/group.md), [service principal](../resources/serviceprincipal.md), [organizational contact](../resources/orgcontact.md), [device](../resources/device.md), or [directory object](../resources/directoryobject.md) is a member of. This function is transitive.
-This API returns up to 11,000 group IDs. If more than 11,000 results are available, it returns a `400 Bad Request` error with the `Directory_ResultSizeLimitExceeded` error code. As a workaround, use the [List group transitive memberOf](../api/group-list-transitivememberof.md) API.
+This API returns up to 11,000 group IDs. If more than 11,000 results are available, it returns a `400 Bad Request` error with the `Directory_ResultSizeLimitExceeded` error code. If you get the `Directory_ResultSizeLimitExceeded` error code, use the [List group transitive memberOf](../api/group-list-transitivememberof.md) API instead.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
v1.0 Driveitem Copy https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-copy.md
The following example attempts to copy the children in a folder identified by `{
The destination already has the same name found at the source. The operation is accepted but it encounters a failure during processing. #### Request
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "copy-item-3", "scopes": "files.readwrite", "target": "action" } --> ```http
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++ #### Response The following example shows the response.
The optional query parameter @microsoft.graph.conflictBehavior is set to replace
The destination already has the same name found at the source. #### Request
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "copy-item-4", "scopes": "files.readwrite", "target": "action" } --> ```http
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++ #### Response The following example shows the response.
v1.0 Driveitem Discardcheckout https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-discardcheckout.md
+
+ Title: "driveItem: discardCheckout"
+description: "Discard a previously checked out driveItem."
+
+ms.localizationpriority: medium
+++
+# driveItem: discardCheckout
+
+Namespace: microsoft.graph
+++
+Discard the check out of a [driveItem](../resources/driveitem.md). This action releases a **driveItem** resource that was previously [checked out](driveitem-checkout.md). Any changes made to the item while it was checked out are discarded.
+
+The same user that performed the checkout must discard it. Another alternative is to use application permissions.
+++
+## Permissions
+
+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
++
+<!-- {
+ "blockType": "permissions",
+ "name": "driveitem-discardcheckout-permissions"
+}
+-->
++
+## HTTP request
+
+``` http
+POST /drive/root/discardCheckout
+POST /drives/{drivesId}/root/discardCheckout
+POST /shares/{sharesId}/root/discardCheckout
+POST /drive/items/{driveItemId}/discardCheckout
+POST /shares/{sharesId}/driveItem/discardCheckout
+POST /drive/bundles/{driveItemId}/discardCheckout
+POST /drive/special/{driveItemId}/discardCheckout
+POST /drive/following/{driveItemId}/discardCheckout
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a discard checkout request on a file identified by `{item-id}`.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "driveitemthis.discardcheckout"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/discardCheckout
+```
+
+# [JavaScript](#tab/javascript)
+++
+### Response
+
+The following example shows the response.
+
+<!-- { "blockType": "response" } -->
+
+```http
+HTTP/1.1 204 No content
+```
++
v1.0 Driveitem Move https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-move.md
-description: "To move a DriveItem to a new parent item, your app requests to update the parentReference of the DriveItem to move."
Previously updated : 09/10/2017 Title: Move a file or folder
+description: "Move a driveItem to a new parent folder."
+ Title: "driveItem: move"
ms.localizationpriority: medium doc_type: apiPageType
-# Move a DriveItem to a new folder
+# driveItem: move
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-To move a DriveItem to a new parent item, your app requests to update the **parentReference** of the DriveItem to move.
+Move a [driveItem](../resources/driveitem.md) to a new parent.
-This is a special case of the [Update](driveitem-update.md) method.
+To move a **driveItem** to a new parent item, your app requests an update to the **parentReference** of the **driveItem** to move. The move is a special type of [Update](driveitem-update.md) operation.
Your app can combine moving an item to a new container and updating other properties of the item into a single request.
-Items cannot be moved between [Drives](../resources/drive.md) using this request.
+When a **driveItem** is moved within the same site or container, all existing sharing links continue to work. If the **driveItem** is moved to a different site or container, existing sharing links no longer work.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /sites/{site-id}/drive/items/{item-id}
PATCH /users/{user-id}/drive/items/{item-id} ```
-## Optional request headers
+## Request headers
| Name | Type | Description | |:--|:-|:--|
-| if-match | String | If this request header is included and the eTag (or cTag) provided does not match the current eTag on the folder, a `412 Precondition Failed` response is returned. |
+|Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+| if-match | String | If this request header is included and the eTag (or cTag) provided doesn't match the current eTag on the folder, a `412 Precondition Failed` response is returned. Optional.|
## Request body In the request body, supply the new value for the **parentReference** property.
-Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values.
-For best performance you shouldn't include existing values that haven't changed.
+Existing properties that aren't included in the request body maintain their previous values or the properties are recalculated based on changes to other property values.
+For optimal performance, include only the values that change and omit the unchanged ones.
-**Note:** When moving items to the root of a drive your app cannot use the `"id:" "root"` syntax.
-Your app needs to provide the actual ID of the root folder for the parent reference.
+> [!NOTE]
+> When items are moved to the root of a drive, your application must use the actual ID of the root folder as the parent reference instead of the `"id: root"` syntax.
## Response
-If successful, this method returns a `200 OK` response code and updated [DriveItem](../resources/driveitem.md) resource in the response body.
+If successful, this method returns a `200 OK` response code and an updated [driveItem](../resources/driveitem.md) resource in the response body.
-## Example
+For information about how errors are returned, see [Error responses][error-response].
-This example moves an item specified by {item-id} into a folder in the user's drive with the ID `new-parent-folder-id`.
+## Examples
+### Request
+The following example moves an item specified by `{item-id}` into a folder in the user's drive with the ID `new-parent-folder-id`.
# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "move-item", "scopes": "files.readwrite" } -->
Content-type: application/json
} ```
-## Error responses
-
-See [Error Responses][error-response] for more info about
-how errors are returned.
- [error-response]: /graph/errors <!--
v1.0 Driveitem Permanentdelete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-permanentdelete.md
doc_type: apiPageType
Namespace: microsoft.graph
-Permanently delete a [driveItem](../resources/driveitem.md) by using its ID.
-If you delete items using this method, they're permanently removed and won't be sent to the recycle bin. Therefore, they can't be restored afterward.
+Permanently delete a [driveItem](../resources/driveitem.md) by using its ID. If you delete items using this method, they're permanently removed and aren't sent to the recycle bin, unlike the [Delete driveItem](../api/driveitem-delete.md) API, which sends the item to the recycle bin. Therefore, permanently deleted drive items can't be restored afterward.
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
v1.0 Driveitem Post Permissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-post-permissions.md
+
+ Title: "Create permission on a driveItem"
+description: "Create a new permission for a driveItem."
+
+ms.localizationpriority: medium
+++
+# Create permission on a driveItem
+Namespace: microsoft.graph
++
+Create a new [permission](../resources/permission.md) object on a [driveItem](../resources/permission.md).
+
+>**Note:** You can only use this method to create a new application permission. If you want to create a new user permission in a drive item, see [invite](./driveitem-invite.md).
++
+## Permissions
+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
+
+<!-- { "blockType": "permissions", "name": "driveitem_post_permissions" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /drives/{drive-id}/items/{item-id}/permissions
+POST /groups/{group-id}/drive/items/{item-id}/permissions
+POST /me/drive/items/{item-id}/permissions
+POST /sites/{siteId}/drive/items/{itemId}/permissions
+POST /users/{userId}/drive/items/{itemId}/permissions
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the [permission](../resources/permission.md) object.
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [permission](../resources/permission.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_permission_from_"
+}
+-->
+++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.permission"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "id": "1",
+ "@deprecated.GrantedToIdentities": "GrantedToIdentities has been deprecated. Refer to GrantedToIdentitiesV2",
+ "roles": [
+ "write"
+ ],
+ "grantedToIdentities": [
+ {
+ "application": {
+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",
+ "displayName": "Contoso Time Manager App"
+ }
+ }
+ ],
+ "grantedToIdentitiesV2": [
+ {
+ "application": {
+ "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",
+ "displayName": "Contoso Time Manager App"
+ }
+ }
+ ]
+}
+```
+
+<!-- {
+ "type": "#page.annotation",
+ "section": "documentation",
+ "tocPath": "Items/Permissions/Create driveitem permissions"
+} -->
v1.0 Ediscovery Case Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/ediscovery-case-update.md
PATCH /compliance/ediscovery/cases/{id}
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type | Description | |:-|:|:|
v1.0 Ediscovery Custodian Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/ediscovery-custodian-update.md
PATCH /compliance/ediscovery/cases/{caseId}/custodians/{custodianId}
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
|Property|Type|Description| |:|:|:|
v1.0 Ediscovery Legalhold Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/ediscovery-legalhold-update.md
PATCH /compliance/ediscovery/cases/{caseId}/legalHolds/{legalholdId}
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
|Property|Type|Description| |:|:|:|
v1.0 Ediscovery Reviewsetquery Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/ediscovery-reviewsetquery-update.md
PATCH /compliance/ediscovery/cases/{id}/reviewSets/{id}/queries/{id}
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type | Description | |:-|:|:|
v1.0 Ediscovery Sourcecollection Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/ediscovery-sourcecollection-update.md
PATCH /compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionI
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
|Property|Type|Description| |:|:|:|
v1.0 Ediscovery Tag Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/ediscovery-tag-update.md
PATCH /compliance/ediscovery/cases/{caseId}/tags/{tagId}
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
|Property|Type|Description| |:|:|:|
v1.0 Educationgradingcategory Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationgradingcategory-update.md
PATCH /education/classes/{classId}/assignmentSettings/gradingCategories/{grading
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type | Description | |:-|:|:|
v1.0 Educationmodule Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationmodule-update.md
PATCH /education/classes/{class-id}/modules/{module-id}
| Content-Type | application/json | ## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type |Description| |:-|:-|:-|
v1.0 Educationoutcome Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationoutcome-update.md
PATCH /education/classes/{id}/assignments/{id}/submissions/{id}/outcomes/{id}
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
The **educationOutcome** object will be one of the following derived types: **educationPointsOutcome**, **educationFeedbackOutcome**, or **educationRubricOutcome**. Supply the specific properties relevant to the type of outcome you're updating.
v1.0 Educationrubric Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationrubric-update.md
PATCH /education/classes/{id}/assignments/{id}/rubric
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type | Description | |:-|:|:|
v1.0 Educationschool Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationschool-update.md
PATCH /education/schools/{id}
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type | Description | | : | :- | : |
v1.0 Educationsynchronizationerrors Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationerrors-get.md
Title: "Get educationSynchronizationErrors"
+ Title: "Get educationSynchronizationErrors (deprecated)"
description: "Get the errors generated during validation and/or during a sync of a specific school data synchronization profile in the tenant. " ms.localizationpriority: medium
doc_type: apiPageType
-# Get educationSynchronizationErrors
+# Get educationSynchronizationErrors (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Get the errors generated during validation and/or during a sync of a specific school data [synchronization profile](../resources/educationsynchronizationprofile.md) in the tenant. [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
This method supports the following [OData Query Parameters](/graph/query-paramet
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationsynchronizationprofile Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-delete.md
Title: "Delete a educationSynchronizationProfile"
+ Title: "Delete a educationSynchronizationProfile (deprecated)"
description: "Delete a school data synchronization profile in the tenant based on the identifier." ms.localizationpriority: medium
doc_type: apiPageType
-# Delete a educationSynchronizationProfile
+# Delete a educationSynchronizationProfile (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Delete a school data [synchronization profile](../resources/educationsynchronizationprofile.md) in the tenant based on the identifier. [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
DELETE /education/synchronizationProfiles/{id}
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofile Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-get.md
Title: "Get an educationSynchronizationProfile"
+ Title: "Get an educationSynchronizationProfile (deprecated)"
description: "Retrieve a school data synchronization profile in the tenant based on the identifier." ms.localizationpriority: medium
doc_type: apiPageType
-# Get an educationSynchronizationProfile
+# Get an educationSynchronizationProfile (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Retrieve a school data [synchronization profile](../resources/educationsynchronizationprofile.md) in the tenant based on the identifier. [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
GET /education/synchronizationProfiles/{id}
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofile List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-list.md
Title: "List educationSynchronizationProfiles"
+ Title: "List educationSynchronizationProfiles (deprecated)"
description: "Retrieve the collection of school data synchronization profiles in the tenant." ms.localizationpriority: medium
doc_type: apiPageType
-# List educationSynchronizationProfiles
+# List educationSynchronizationProfiles (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Retrieve the collection of school data [synchronization profiles](../resources/educationsynchronizationprofile.md) in the tenant. [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
This method supports the following [OData Query Parameters](/graph/query-paramet
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofile Pause https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-pause.md
Title: "Pause sync on an educationSynchronizationProfile"
+ Title: "Pause sync on an educationSynchronizationProfile (deprecated)"
description: "Pause the sync of a specific school data synchronization profile in the tenant." ms.localizationpriority: medium
doc_type: apiPageType
-# Pause sync on an educationSynchronizationProfile
+# Pause sync on an educationSynchronizationProfile (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Pause the sync of a specific school data [synchronization profile](../resources/educationsynchronizationprofile.md) in the tenant. [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
POST /education/synchronizationProfiles/{id}/pause
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofile Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-post.md
Title: "Create an educationSynchronizationProfile"
+ Title: "Create an educationSynchronizationProfile (deprecated)"
description: "Create a request for a new school data synchronization profile in the tenant." ms.localizationpriority: medium
doc_type: apiPageType
-# Create an educationSynchronizationProfile
+# Create an educationSynchronizationProfile (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Create a request for a new school data [synchronization profile](../resources/educationsynchronizationprofile.md) in the tenant. [Query the status](educationsynchronizationprofilestatus-get.md) to get the status of the profile. [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
POST /education/synchronizationProfiles
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Application/json. Required. | ## Request body
v1.0 Educationsynchronizationprofile Put https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-put.md
Title: "Update an educationSynchronizationProfile"
+ Title: "Update an educationSynchronizationProfile (deprecated)"
description: "Update properties for an existing school data synchronization profile in the tenant." ms.localizationpriority: medium
doc_type: apiPageType
-# Update an educationSynchronizationProfile
+# Update an educationSynchronizationProfile (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Update properties for an existing school data [synchronization profile](../resources/educationsynchronizationprofile.md) in the tenant. ## Permissions
PUT /education/synchronizationProfiles
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | ## Request body
v1.0 Educationsynchronizationprofile Reset https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-reset.md
Title: "Reset sync on an educationSynchronizationProfile"
+ Title: "Reset sync on an educationSynchronizationProfile (deprecated)"
description: "Reset the sync of a specific school data synchronization profile in the tenant." ms.localizationpriority: medium
doc_type: apiPageType
-# Reset sync on an educationSynchronizationProfile
+# Reset sync on an educationSynchronizationProfile (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Reset the sync of a specific school data [synchronization profile](../resources/educationsynchronizationprofile.md) in the tenant. > **Note:** This operation will cause synchronization to restart. Any errors encountered will be deleted. No data will be deleted from Microsoft Entra ID.
POST /education/synchronizationProfiles/{id}/reset
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofile Resume https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-resume.md
Title: "Resume sync on an educationSynchronizationProfile"
+ Title: "Resume sync on an educationSynchronizationProfile (deprecated)"
description: "Resume the sync of a specific school data synchronization profile in the tenant." ms.localizationpriority: medium
doc_type: apiPageType
-# Resume sync on an educationSynchronizationProfile
+# Resume sync on an educationSynchronizationProfile (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Resume the sync of a specific school data [synchronization profile](../resources/educationsynchronizationprofile.md) in the tenant. [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
POST /education/synchronizationProfiles/{id}/resume
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofile Start https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-start.md
Title: "Start sync after uploading files to an educationSynchronizationProfile"
+ Title: "Start sync after uploading files to an educationSynchronizationProfile (deprecated)"
description: "Verify the files uploaded to a specific school data synchronization profile in the tenant. If the verification is successful, synchronization starts on the profile. Otherwise, the response contains errors and warnings. If the response contains errors, the synchronization won't start. If the response contains only warnings, synchronization starts." ms.localizationpriority: medium
doc_type: apiPageType
-# Start sync after uploading files to an educationSynchronizationProfile
+# Start sync after uploading files to an educationSynchronizationProfile (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Verify the files uploaded to a specific school data [synchronization profile](../resources/educationsynchronizationprofile.md) in the tenant. If the verification is successful, synchronization starts on the profile. Otherwise, the response contains errors and warnings. If the response contains errors, the synchronization won't start. If the response contains only warnings, synchronization starts. > **Note:** Use this method only when the data provider is of type [educationcsvdataprovider](../resources/educationcsvdataprovider.md). Also, the profile's state property needs to be provisioned before it can be started. Poll the profile object to check its state property.
POST /education/synchronizationProfiles/{id}/start
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
POST https://graph.microsoft.com/beta/education/synchronizationProfiles/{id}/sta
##### Response
-The following example shows the response.
+The following example shows the response.
>**Note:** The response object shown here might be shortened for readability.
Content-type: application/json
] } ```
-<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
2015-10-25 14:57:30 UTC --> <!-- { "type": "#page.annotation",
v1.0 Educationsynchronizationprofile Uploadurl https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofile-uploadurl.md
Title: "educationSynchronizationProfile: uploadUrl"
+ Title: "educationSynchronizationProfile: uploadUrl (deprecated)"
description: "Retrieve a shared access signature (SAS) for uploading source files to Azure blob storage for a specific school data synchronization profile in the tenant. The SAS token has a validity of one hour." ms.localizationpriority: medium
doc_type: apiPageType
-# educationSynchronizationProfile: uploadUrl
+# educationSynchronizationProfile: uploadUrl (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Retrieve a shared access signature (SAS) for uploading source files to Azure blob storage for a specific school data [synchronization profile](../resources/educationsynchronizationprofile.md) in the tenant. The SAS token has a validity of one hour. The upload URL is provided only for the [CSV data provider](../resources/educationcsvdataprovider.md).
GET /education/synchronizationProfiles/{id}/uploadUrl
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Educationsynchronizationprofilestatus Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsynchronizationprofilestatus-get.md
Title: "Get the status of an educationSynchronizationProfile"
+ Title: "Get the status of an educationSynchronizationProfile (deprecated)"
description: "Get the status of a specific school data synchronization profile in the tenant. The response will indicate the status of the sync." ms.localizationpriority: medium
doc_type: apiPageType
-# Get the status of an educationSynchronizationProfile
+# Get the status of an educationSynchronizationProfile (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Get the status of a specific school data [synchronization profile](../resources/educationsynchronizationprofile.md) in the tenant. The response will indicate the status of the sync. [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
GET /education/synchronizationProfiles/{id}/profileStatus
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Employeeexperience List Communities https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/employeeexperience-list-communities.md
+
+ Title: "List communities"
+description: "Get a list of the Viva Engage community objects and their properties."
+
+ms.localizationpriority: medium
+++
+# List communities
+
+Namespace: microsoft.graph
++
+Get a list of the Viva Engage [community](../resources/community.md) objects and their properties.
++
+## Permissions
+
+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
+
+<!-- { "blockType": "permissions", "name": "employeeexperience_list_communities" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /employeeExperience/communities
+```
+
+## Optional query parameters
+
+This method supports the `$top`, `$select`, and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response. It also supports the `$orderby` parameter for the **displayName** property.
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [community](../resources/community.md) objects in the response body.
+
+## Examples
+
+### Example 1: Get a list of communities
+
+The following example shows how to get a list of Viva Engage communities.
+
+#### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_community"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/employeeExperience/communities
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++
+#### Response
+
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.community)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#employeeExperience/communities",
+ "value": [
+ {
+ "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTEzMjYyODk5MjAifQ",
+ "displayName": "All Company",
+ "description": "This is the default group for everyone in the network",
+ "privacy": "public",
+ "groupId": "195d9ecd-f80e-4bab-af95-176eba253dfa"
+ },
+ {
+ "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTE0NzY2Mzc2OTYifQ",
+ "displayName": "TestCommunity5",
+ "description": "Test community created via API",
+ "privacy": "public",
+ "groupId": "0bed8b86-5026-4a93-ac7d-56750cc099f1"
+ }
+ ]
+}
+```
+
+### Example 2: Get a list of communities with pagination
+
+The following example shows how to get a list of Viva Engage communities using the `$top` query parameter to set the page size of results.
+
+#### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_community_top"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/employeeExperience/communities?$top=2
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++
+#### Response
+
+If the number of communities exceeds 20 or you use the `$top` query parameter to set the page size of results, multiple query requests might be necessary to retrieve all results. In this scenario, the API continues to return a reference to the next page of results in the **@odata.nextLink** property with each response until no more pages remain to be retrieved.
+
+The following example shows the response that includes the **@odata.nextLink** property.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.community)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#employeeExperience/communities",
+ "@odata.nextLink": "https://graph.microsoft.com/beta/employeeExperience/communities?$skiptoken=UVWlYzI7VjE7MTE2NDUzNDU3OTIwOzIwO0RlbW8tdGVzdC01OztEaXNwbGF5TmFtZTtmYWXYZTs",
+ "value": [
+ {
+ "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTEzMjYyODk5MjAifQ",
+ "displayName": "All Company",
+ "description": "This is the default group for everyone in the network",
+ "privacy": "public",
+ "groupId": "195d9ecd-f80e-4bab-af95-176eba253dfa"
+ },
+ {
+ "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTE0NzY2Mzc2OTYifQ",
+ "displayName": "TestCommunity5",
+ "description": "Test community created via API",
+ "privacy": "public",
+ "groupId": "0bed8b86-5026-4a93-ac7d-56750cc099f1"
+ }
+ ]
+}
+```
+
v1.0 Entitlementmanagement Post Accesspackageassignmentpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/entitlementmanagement-post-accesspackageassignmentpolicies.md
Content-type: application/json
} ```
-### Example 5: Create a policy and specify the stages to trigger pre-defined access package custom extensions
+### Example 5: Create a policy and specify the stages to trigger predefined access package custom extensions
-#### Request
+In the following example, the predefined **accessPackageCustomWorkflowExtension** object is triggered by the creation or approval of an access package assignment request. The identifier in the **customExtension** property corresponds to the ID of the **accessPackageCustomWorkflowExtension** object.
-In the following example, the pre-defined **accessPackageCustomWorkflowExtension** object is triggered when an access package assignment request is created and when it's granted. The identifier provided within the **customExtension** field is the **accessPackageCustomWorkflowExtension** object's ID.
+#### Request
+The following example shows a request.
# [HTTP](#tab/http) <!-- {
Content-type: application/json
#### Response
-The following example shows the response. The **customExtensionStageSettings** object isn't returned by default. To retrieve this object, use the **GET** method with `$expand`. For more information, see [Retrieve the custom extension stage settings for a policy](accesspackageassignmentpolicy-get.md#example-3-retrieve-the-custom-extension-stage-settings-for-a-policy)
+The following example shows the response. The **customExtensionStageSettings** object isn't returned by default. To retrieve this object, use the [GET accessPackageAssignmentPolicy](../api/accesspackageassignmentpolicy-get.md) method with `$expand`. For more information, see [Example 3: Retrieve the custom extension stage settings for a policy](../api/accesspackageassignmentpolicy-get.md#example-3-retrieve-the-custom-extension-stage-settings-for-a-policy).
> **Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Entitlementmanagement Post Assignmentrequests https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/entitlementmanagement-post-assignmentrequests.md
Content-type: application/json
- #### Response The following example shows the response.
v1.0 Event Accept https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-accept.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Cancel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-cancel.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Decline https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-decline.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
| Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-delete.md
DELETE /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Event Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-delta.md
includes the encoded, desired parameters.
## Request headers | Name | Type | Description | |:|:-|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | application/json. Required. | | Prefer | string | odata.maxpagesize={x}. Optional. | | Prefer | string | outlook.timezone={Time zone string}. Optional, UTC assumed if absent.|
v1.0 Event Dismissreminder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-dismissreminder.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
| Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Response
v1.0 Event Forward https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-forward.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-get.md
This method supports the [OData query parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header isn't specified, the **body** property is returned in HTML format. Optional. |
v1.0 Event List Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-list-attachments.md
GET https://graph.microsoft.com/beta/me/events/{id}?$expand=attachments
| Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Event List Instances https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-list-instances.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | ## Request body
v1.0 Event Post Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-post-attachments.md
POST /groups/{id}/events/{id}/attachments
| Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Snoozereminder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-snoozereminder.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Tentativelyaccept https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-tentativelyaccept.md
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Event Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-update.md
PATCH /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.
v1.0 Eventmessage Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/eventmessage-delete.md
DELETE /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Eventmessage Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/eventmessage-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Eventmessage List Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/eventmessage-list-attachments.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Eventmessage Post Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/eventmessage-post-attachments.md
POST /users/{id|userPrincipalName}/messages/{id}/attachments
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Eventmessage Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/eventmessage-update.md
PATCH /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}
## Request headers | Name | Type | Description| |:--|:|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed. Writable/Updatable properties are
v1.0 Exchangeprotectionpolicy List Mailboxinclusionrules https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/exchangeprotectionpolicy-list-mailboxinclusionrules.md
Authorization: Bearer <Access-Token>
[!INCLUDE [sample-code](../includes/snippets/php/exchangeprotectionpolicy-list-mailboxinclusionrule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/exchangeprotectionpolicy-list-mailboxinclusionrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Exchangeprotectionpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/exchangeprotectionpolicy-update.md
Authorization: Bearer <Access-Token>
[!INCLUDE [sample-code](../includes/snippets/php/exchangeprotectionpolicy-update-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/exchangeprotectionpolicy-update-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Exchangerestoresession List Mailboxrestoreartifacts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/exchangerestoresession-list-mailboxrestoreartifacts.md
GET https://graph.microsoft.com/beta/solutions/backupRestore/exchangeRestoreSess
[!INCLUDE [sample-code](../includes/snippets/php/mailboxrestoreartifact-list-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/mailboxrestoreartifact-list-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Exchangerestoresession Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/exchangerestoresession-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/exchangerestoresession-update-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/exchangerestoresession-update-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Externalconnectors Externalconnection Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalconnectors-externalconnection-update.md
PATCH /external/connections/{id}
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed. The following properties can be updated.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed. The following properties can be updated.
| Property | Type | Description | |:--|:--|:|
v1.0 Externalmeetingregistrant Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalmeetingregistrant-delete.md
doc_type: apiPageType
-# Delete externalMeetingRegistrant
+# Delete externalMeetingRegistrant (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+> [!CAUTION]
+> The external meeting registrant API is deprecated and will stop returning data on **December 31, 2024**. Please use the new [webinar APIs](../resources/virtualeventwebinar.md). For more information, see [Deprecation of the Microsoft Graph meeting registration beta APIs](https://devblogs.microsoft.com/microsoft365dev/deprecation-of-the-microsoft-graph-meeting-registration-beta-apis/).
+ The meeting organizer removes an [externalMeetingRegistrant](../resources/externalmeetingregistrant.md) from an online meeting which has [externalMeetingRegistration](../resources/externalmeetingregistration.md) enabled. [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
v1.0 Externalmeetingregistrant List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalmeetingregistrant-list.md
doc_type: apiPageType
-# List externalMeetingRegistrants
+# List externalMeetingRegistrants (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+> [!CAUTION]
+> The external meeting registrant API is deprecated and will stop returning data on **December 31, 2024**. Please use the new [webinar APIs](../resources/virtualeventwebinar.md). For more information, see [Deprecation of the Microsoft Graph meeting registration beta APIs](https://devblogs.microsoft.com/microsoft365dev/deprecation-of-the-microsoft-graph-meeting-registration-beta-apis/).
+ Get a list of the [externalMeetingRegistrants](../resources/externalmeetingregistrant.md) of an [onlineMeeting](../resources/onlinemeeting.md). [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
v1.0 Externalmeetingregistrant Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalmeetingregistrant-post.md
doc_type: apiPageType
-# Create externalMeetingRegistrant
+# Create externalMeetingRegistrant (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+> [!CAUTION]
+> The external meeting registrant API is deprecated and will stop returning data on **December 31, 2024**. Please use the new [webinar APIs](../resources/virtualeventwebinar.md). For more information, see [Deprecation of the Microsoft Graph meeting registration beta APIs](https://devblogs.microsoft.com/microsoft365dev/deprecation-of-the-microsoft-graph-meeting-registration-beta-apis/).
+ Enroll an [externalMeetingRegistrant](../resources/externalmeetingregistrant.md) in an online meeting which has [externalMeetingRegistration](../resources/externalmeetingregistration.md) enabled. The meeting organizer enrolls someone by providing a unique **id** in the external registration system and gets the unique **joinWebUrl** of this registrant. [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
v1.0 Externalmeetingregistration Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalmeetingregistration-delete.md
doc_type: apiPageType
-# Delete externalMeetingRegistration
+# Delete externalMeetingRegistration (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+> [!CAUTION]
+> The external meeting registration API is deprecated and will stop returning data on **December 31, 2024**. Please use the new [webinar APIs](../resources/virtualeventwebinar.md). For more information, see [Deprecation of the Microsoft Graph meeting registration beta APIs](https://devblogs.microsoft.com/microsoft365dev/deprecation-of-the-microsoft-graph-meeting-registration-beta-apis/).
+ Disable and delete the [externalMeetingRegistration](../resources/externalmeetingregistration.md) of an [onlineMeeting](../resources/onlinemeeting.md). [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
v1.0 Externalmeetingregistration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalmeetingregistration-get.md
doc_type: apiPageType
-# Get externalMeetingRegistration
+# Get externalMeetingRegistration (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+> [!CAUTION]
+> The external meeting registration API is deprecated and will stop returning data on **December 31, 2024**. Please use the new [webinar APIs](../resources/virtualeventwebinar.md). For more information, see [Deprecation of the Microsoft Graph meeting registration beta APIs](https://devblogs.microsoft.com/microsoft365dev/deprecation-of-the-microsoft-graph-meeting-registration-beta-apis/).
+ Get the [externalMeetingRegistration](../resources/externalmeetingregistration.md) details associated with an [onlineMeeting](../resources/onlinemeeting.md). [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
v1.0 Externalmeetingregistration Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalmeetingregistration-post.md
doc_type: apiPageType
-# Create externalMeetingRegistration
+# Create externalMeetingRegistration (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+> [!CAUTION]
+> The external meeting registration API is deprecated and will stop returning data on **December 31, 2024**. Please use the new [webinar APIs](../resources/virtualeventwebinar.md). For more information, see [Deprecation of the Microsoft Graph meeting registration beta APIs](https://devblogs.microsoft.com/microsoft365dev/deprecation-of-the-microsoft-graph-meeting-registration-beta-apis/).
+ Enable registration for an [onlineMeeting](../resources/onlinemeeting.md) using an external registration system. An online meeting can only have one registration enabled. ## Permissions
v1.0 Externaluserprofile Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externaluserprofile-get.md
GET /directory/externalUserProfiles/{id}
|Name|Description| |:|:-|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Externaluserprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externaluserprofile-update.md
PATCH /directory/externalUserProfiles/{id}
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Federatedidentitycredential Upsert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/federatedidentitycredential-upsert.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a new [federatedIdentityCredential](../resources/federatedidentitycredential.md) object for an application if it does exist, or update the properties of an existing [federatedIdentityCredential](../resources/federatedidentitycredential.md) object. By [configuring a trust relationship](/azure/active-directory/develop/workload-identity-federation-create-trust) between your Microsoft Entra application registration and the identity provider for your compute platform, you can use tokens issued by that platform to authenticate with Microsoft identity platform and call APIs in the Microsoft ecosystem. Maximum of 20 objects can be added to an application.
+Create a new [federatedIdentityCredential](../resources/federatedidentitycredential.md) object for an application if it doesn't exist, or update the properties of an existing [federatedIdentityCredential](../resources/federatedidentitycredential.md) object. By [configuring a trust relationship](/azure/active-directory/develop/workload-identity-federation-create-trust) between your Microsoft Entra application registration and the identity provider for your compute platform, you can use tokens issued by that platform to authenticate with Microsoft identity platform and call APIs in the Microsoft ecosystem. Maximum of 20 objects can be added to an application.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
-<!-- { "blockType": "permissions", "name": "application_post_federatedidentitycredentials" } -->
+<!-- { "blockType": "permissions", "name": "federatedidentitycredential-upsert" } -->
## HTTP request
v1.0 Group Addfavorite https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-addfavorite.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Add the group to the list of the current user's favorite groups. Supported for Microsoft 365 groups only.
+Add the group to the list of the current user's favorite groups. The group shows up in Outlook and Teams favorites. Supported for Microsoft 365 groups only.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
v1.0 Group Deletepasswordsinglesignoncredentials https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-deletepasswordsinglesignoncredentials.md
POST /groups/{groupsId}/deletePasswordSingleSignOnCredentials
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.| ## Request body
v1.0 Group Get Event https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-get-event.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Name | Type | Description | | :-- | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header isn't specified, the **body** property is returned in HTML format. Optional. |
v1.0 Group Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-get.md
For more information on OData query options, see [OData Query Parameters](/graph
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Getpasswordsinglesignoncredentials https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-getpasswordsinglesignoncredentials.md
POST /groups/{groupsId}/getPasswordSingleSignOnCredentials
|Name|Description| |:|:|
-|Authorization|Bearer {token}. Required.|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-list-calendarview.md
This method also supports some of the [OData Query Parameters](/graph/query-para
| Name | Type | Description | | :-- | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header isn't specified, the **body** property is returned in HTML format. Optional. |
v1.0 Group List Events https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-list-events.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name | Type | Description | |:|:--|:--|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: outlook.timezone | string | Use this header to specify the time zone for start and end times in the response. If not specified, those time values are returned in UTC. Optional. | | Prefer: outlook.body-content-type | string | The format of the **body** property to be returned in. Values can be "text" or "html". A `Preference-Applied` header is returned as confirmation if this `Prefer` header is specified. If the header is not specified, the **body** property is returned in HTML format. Optional. |
v1.0 Group List Owners https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-list-owners.md
Some queries are supported only when you use the **ConsistencyLevel** header set
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group List Photos https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-list-photos.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Post Members https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-post-members.md
To add members to a role-assignable group, the app must also be assigned the *Ro
```http POST /groups/{group-id}/members/$ref
+POST /groups/{group-id}/members/
``` ## Request headers
POST /groups/{group-id}/members/$ref
| Name | Description | | : | : | |Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+| Content-type | application/json. Required. |
## Request body
-In the request body, supply a JSON representation of a [directoryObject](../resources/directoryobject.md), [user](../resources/user.md), or [group](../resources/group.md) object to be added.
+When using the `/groups/{group-id}/members/$ref` syntax, supply a JSON object that contains an **@odata.id** property with a reference by ID to a supported group member object type.
+
+When using the `/groups/{group-id}/members` syntax, supply a JSON object that contains a **members@odata.bind** property with one or more references by IDs to a supported group member object type.
+
+If using the **directoryObjects** reference, that is, `https://graph.microsoft.com/v1.0/directoryObjects/{id}`, the object type must still be a supported group member object type.
## Response
-If successful, this method returns a `204 No Content` response code. It doesn't return anything in the response body. This method returns a `400 Bad Request` response code when the object is already a member of the group. This method returns a `404 Not Found` response code when the object being added doesn't exist.
+If successful, this method returns a `204 No Content` response code. It returns a `400 Bad Request` response code when the object is already a member of the group or is unsupported as a group member. It returns a `404 Not Found` response code when the object being added doesn't exist.
## Example
v1.0 Group Update Event https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-update-event.md
PATCH /groups/{id}/calendar/events/{id}
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Update Thread https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-update-thread.md
PATCH /groups/{id}/threads/{id}
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-update.md
PATCH /groups/{id}
| Name | Type | Description | | : | :-- | : |
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Group Upsert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-upsert.md
You can create or update the following types of group:
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
-<!-- { "blockType": "permissions", "name": "group_post_groups" } -->
+<!-- { "blockType": "permissions", "name": "group_upsert" } -->
In order for an app with Group.Create permission to create a group with owners or members, it must have the privileges to read the object type that it wants to assign as the group owner or member. Therefore:
PATCH /groups/(uniqueName='uniqueName')
| Name | Description | |:--|:|
-| Authorization | Bearer {token}. Required.|
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required.| | Prefer | `create-if-missing`. Required for upsert behavior, otherwise the request is treated as an update operation. |
v1.0 Homerealmdiscoverypolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/homerealmdiscoverypolicy-update.md
PATCH /policies/homeRealmDiscoveryPolicies/{id}
## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type | Description | |:-|:|:|
v1.0 Icon Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/icon-update.md
PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/tables/{id|name
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
| Property | Type |Description| |:|:--|:-|
v1.0 Identitygovernance Insights Toptasksprocessedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-insights-toptasksprocessedsummary.md
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/insig
[!INCLUDE [sample-code](../includes/snippets/php/insightsthistoptasksprocessedsummary-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/insightsthistoptasksprocessedsummary-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identitygovernance Insights Topworkflowsprocessedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-insights-topworkflowsprocessedsummary.md
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/insig
[!INCLUDE [sample-code](../includes/snippets/php/insightsthistopworkflowsprocessedsummary-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/insightsthistopworkflowsprocessedsummary-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identitygovernance Insights Workflowsprocessedbycategory https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-insights-workflowsprocessedbycategory.md
GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedByCategory
## Function parameters In the request URL, provide the following query parameters with values.
-The following table lists the parameters that are required when you call this function.
|Parameter|Type|Description| |:|:|:|
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/insig
[!INCLUDE [sample-code](../includes/snippets/php/insightsthisworkflowsprocessedbycategory-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/insightsthisworkflowsprocessedbycategory-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identitygovernance Insights Workflowsprocessedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-insights-workflowsprocessedsummary.md
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/insig
[!INCLUDE [sample-code](../includes/snippets/php/insightsthisworkflowsprocessedsummary-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/insightsthisworkflowsprocessedsummary-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identitygovernance Run Summary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-run-summary.md
GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/summary(s
## Function parameters In the request URL, provide the following query parameters with values.
-The following table lists the parameters that are required when you call this function.
|Parameter|Type|Description| |:|:|:|
v1.0 Inactiveawsresourcefinding Aggregatedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveawsresourcefinding-aggregatedsummary.md
GET /identityGovernance/permissionsAnalytics/aws/findings/microsoft.graph.inacti
## Function parameters In the request URL, provide the following query parameters with values.
-The following table lists the parameters that are required when you call this function.
|Parameter|Type|Description| |:|:|:|
v1.0 Inactiveawsrolefinding Aggregatedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveawsrolefinding-aggregatedsummary.md
GET /identityGovernance/permissionsAnalytics/aws/findings/microsoft.graph.inacti
## Function parameters In the request URL, provide the following query parameters with values.
-The following table lists the parameters that are required when you call this function.
|Parameter|Type|Description| |:|:|:|
v1.0 Inactiveazureserviceprincipalfinding Aggregatedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveazureserviceprincipalfinding-aggregatedsummary.md
GET /identityGovernance/permissionsAnalytics/azure/findings/microsoft.graph.inac
## Function parameters In the request URL, provide the following query parameters with values.
-The following table lists the parameters that are required when you call this function.
|Parameter|Type|Description| |:|:|:|
v1.0 Inactivegcpserviceaccountfinding Aggregatedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactivegcpserviceaccountfinding-aggregatedsummary.md
GET /identityGovernance/permissionsAnalytics/gcp/findings/microsoft.graph.inacti
## Function parameters In the request URL, provide the following query parameters with values.
-The following table lists the parameters that are required when you call this function.
|Parameter|Type|Description| |:|:|:|
v1.0 Inactiveserverlessfunctionfinding Aggregatedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveserverlessfunctionfinding-aggregatedsummary.md
GET /identityGovernance/permissionsAnalytics/gcp/findings/microsoft.graph.inacti
## Function parameters In the request URL, provide the following query parameters with values.
-The following table lists the parameters that are required when you call this function.
|Parameter|Type|Description| |:|:|:|
v1.0 Inactiveuserfinding Aggregatedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inactiveuserfinding-aggregatedsummary.md
GET https://graph.microsoft.com/beta/identityGovernance/permissionsAnalytics/gcp
## Function parameters In the request URL, provide the following query parameters with values.
-The following table lists the parameters that are required when you call this function.
|Parameter|Type|Description| |:|:|:|
v1.0 Industrydata Administrativeunitprovisioningflow Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-administrativeunitprovisioningflow-delete.md
DELETE /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlow
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Administrativeunitprovisioningflow Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-administrativeunitprovisioningflow-get.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Administrativeunitprovisioningflow Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-administrativeunitprovisioningflow-update.md
PATCH /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Industrydata Azuredatalakeconnector Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-azuredatalakeconnector-update.md
Content-type: application/json
- ### Response The following example shows the response.
v1.0 Industrydata Classgroupprovisioningflow Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-classgroupprovisioningflow-delete.md
DELETE /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlow
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Classgroupprovisioningflow Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-classgroupprovisioningflow-get.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Classgroupprovisioningflow Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-classgroupprovisioningflow-update.md
PATCH /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Industrydata Inboundapiflow Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-inboundapiflow-post.md
Content-Type: application/json
- ### Response The following example shows the response.
v1.0 Industrydata Inboundapiflow Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-inboundapiflow-update.md
Content-length: 246
- ### Response The following example shows the response.
v1.0 Industrydata Industrydataconnector Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-industrydataconnector-delete.md
DELETE https://graph.microsoft.com/beta/external/industryData/dataConnectors/8c0
-- ### Response The following example shows the response.
v1.0 Industrydata Industrydataconnector Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-industrydataconnector-get.md
GET https://graph.microsoft.com/beta/external/industryData/dataConnectors/51dca0
- ### Response The following example shows the response.
v1.0 Industrydata Industrydataroot Delete Outboundprovisioningflowsets https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-industrydataroot-delete-outboundprovisioningflowsets.md
DELETE /external/industryData/outboundProvisioningFlowSets/{id}
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Industrydataroot List Outboundprovisioningflowsets https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-industrydataroot-list-outboundprovisioningflowsets.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Industrydataroot Post Outboundprovisioningflowsets https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-industrydataroot-post-outboundprovisioningflowsets.md
POST /external/industryData/OutboundProvisioningFlowSets
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Industrydata Onerosterapidataconnector Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-onerosterapidataconnector-post.md
Content-Type: application/json
- ### Response The following example shows the response.
v1.0 Industrydata Onerosterapidataconnector Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-onerosterapidataconnector-update.md
Content-type: application/json
- ### Response The following example shows the response.
v1.0 Industrydata Outboundprovisioningflowset Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-outboundprovisioningflowset-get.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Outboundprovisioningflowset List Provisioningflows https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-outboundprovisioningflowset-list-provisioningflows.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Outboundprovisioningflowset Post Provisioningflows https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-outboundprovisioningflowset-post-provisioningflows.md
POST /external/industryData/outboundProvisioningFlowSets/{id}/provisioningFlows
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Industrydata Outboundprovisioningflowset Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-outboundprovisioningflowset-update.md
PATCH /external/industryData/outboundProvisioningFlowSets/{id}
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Industrydata Provisioningflow Reset https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-provisioningflow-reset.md
POST /external/industryData/outboundProvisioningFlowSets/{outboundProvisioningFl
| Name | Description | | :-- | : |
-| Authorization| Bearer {token}. Required. |
+| Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
POST https://graph.microsoft.com/beta/external/industryData/outboundProvisioning
[!INCLUDE [sample-code](../includes/snippets/php/provisioningflowthisreset-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/provisioningflowthisreset-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Industrydata Referencedefinition Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-referencedefinition-delete.md
Perform a soft delete of a [referenceDefinition](../resources/industrydata-refer
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
-<!-- {
- "blockType": "permissions",
- "name": "industrydata-referencedefinition-delete-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "industrydata_referencedefinition_delete" } -->
[!INCLUDE [permissions-table](../includes/permissions/industrydata-referencedefinition-delete-permissions.md)] ## HTTP request
DELETE https://graph.microsoft.com/beta/external/industryData/referenceDefinitio
- ### Response The following example shows the response.
v1.0 Industrydata Referencedefinition Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-referencedefinition-post.md
You can extend the following reference types with other codes that better align
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
-<!-- {
- "blockType": "permissions",
- "name": "industrydata-referencedefinition-post-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "industrydata_referencedefinition_post" } -->
[!INCLUDE [permissions-table](../includes/permissions/industrydata-referencedefinition-post-permissions.md)] ## HTTP request
Content-Type: application/json
- ### Response The following example shows the response.
v1.0 Industrydata Referencedefinition Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-referencedefinition-update.md
Update the properties of a [referenceDefinition](../resources/industrydata-refer
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
-<!-- {
- "blockType": "permissions",
- "name": "industrydata-referencedefinition-update-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "industrydata_referencedefinition_update" } -->
[!INCLUDE [permissions-table](../includes/permissions/industrydata-referencedefinition-update-permissions.md)] ## HTTP request
Content-Type: application/json
- ### Response The following example shows the response.
v1.0 Industrydata Securitygroupprovisioningflow Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-securitygroupprovisioningflow-delete.md
DELETE /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlow
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Securitygroupprovisioningflow Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-securitygroupprovisioningflow-get.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Securitygroupprovisioningflow Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-securitygroupprovisioningflow-update.md
PATCH /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Industrydata Userprovisioningflow Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-userprovisioningflow-delete.md
DELETE /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlow
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Userprovisioningflow Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-userprovisioningflow-get.md
This method supports some of the OData query parameters to help customize the re
| Name | Description | | : | : |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Industrydata Userprovisioningflow Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/industrydata-userprovisioningflow-update.md
PATCH /external/industryData/OutboundProvisioningFlowSets/{id}/provisioningFlows
| Name | Description | | : | :-- |
-| Authorization | Bearer {token}. Required. |
+| Authorization |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json. Required. | ## Request body
v1.0 Inferenceclassification List Overrides https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inferenceclassification-list-overrides.md
GET /users/{id}/inferenceClassification/overrides
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Inferenceclassification Post Overrides https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inferenceclassification-post-overrides.md
POST /users/{id}/inferenceClassification/overrides
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Inferenceclassificationoverride Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inferenceclassificationoverride-delete.md
DELETE /users/{id}/inferenceClassification/overrides/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Inferenceclassificationoverride Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/inferenceclassificationoverride-update.md
PATCH /users/{id}/inferenceClassification/overrides/{id}
## Request headers | Name | Type | Description| |:|:--|:-|
-| Authorization | string | Bearer {token}. Required. |
+| Authorization | string |Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | string | Nature of the data in the body of an entity. Required. | ## Request body
v1.0 Intune Androidforwork Androiddeviceownerenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-create.md
The following table shows the properties that are required when you create the a
|tokenCreationDateTime|DateTimeOffset|Date time the most recently created token was created.| |tokenExpirationDateTime|DateTimeOffset|Date time the most recently created token will expire.| |enrolledDeviceCount|Int32|Total number of Android devices that have enrolled using this enrollment profile.|
-|enrollmentTokenUsageCount|Int32|Total number of AOSP devices that have enrolled using the current token.|
+|enrollmentTokenUsageCount|Int32|Total number of AOSP devices that have enrolled using the current token. Valid values 0 to 20000|
|qrCodeContent|String|String used to generate a QR code for the token.| |qrCodeImage|[mimeContent](../resources/intune-shared-mimecontent.md)|String used to generate a QR code for the token.| |roleScopeTagIds|String collection|List of Scope Tags for this Entity instance.|
v1.0 Intune Androidforwork Androiddeviceownerenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-update.md
The following table shows the properties that are required when you create the [
|tokenCreationDateTime|DateTimeOffset|Date time the most recently created token was created.| |tokenExpirationDateTime|DateTimeOffset|Date time the most recently created token will expire.| |enrolledDeviceCount|Int32|Total number of Android devices that have enrolled using this enrollment profile.|
-|enrollmentTokenUsageCount|Int32|Total number of AOSP devices that have enrolled using the current token.|
+|enrollmentTokenUsageCount|Int32|Total number of AOSP devices that have enrolled using the current token. Valid values 0 to 20000|
|qrCodeContent|String|String used to generate a QR code for the token.| |qrCodeImage|[mimeContent](../resources/intune-shared-mimecontent.md)|String used to generate a QR code for the token.| |roleScopeTagIds|String collection|List of Scope Tags for this Entity instance.|
v1.0 Intune Apps Deviceappmanagement Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-deviceappmanagement-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.
+Read properties and relationships of the [deviceAppManagement](../resources/intune-apps-deviceappmanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-apps-deviceappmanagement.md) object in the response body.
## Example
v1.0 Intune Apps Deviceappmanagement Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-deviceappmanagement-update.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.
+Update the properties of a [deviceAppManagement](../resources/intune-apps-deviceappmanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /deviceAppManagement
|Accept|application/json| ## Request body
-In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.
+In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-apps-deviceappmanagement.md) object.
-The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md).
+The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-apps-deviceappmanagement.md).
|Property|Type|Description| |:|:|:|
The following table shows the properties that are required when you create the [
## Response
-If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-apps-deviceappmanagement.md) object in the response body.
## Example
v1.0 Intune Apps Devicemanagement Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-devicemanagement-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+Read properties and relationships of the [deviceManagement](../resources/intune-apps-devicemanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-apps-devicemanagement.md) object in the response body.
## Example
v1.0 Intune Apps Devicemanagement Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-devicemanagement-update.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+Update the properties of a [deviceManagement](../resources/intune-apps-devicemanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /deviceManagement
|Accept|application/json| ## Request body
-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-apps-devicemanagement.md) object.
-The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md).
+The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-apps-devicemanagement.md).
|Property|Type|Description| |:|:|:|
The following table shows the properties that are required when you create the [
## Response
-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-apps-devicemanagement.md) object in the response body.
## Example
v1.0 Intune Apps Ioslobappprovisioningconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfiguration-create.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Create a new [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object.
+Create a new [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
The following table shows the properties that are required when you create the i
## Response
-If successful, this method returns a `201 Created` response code and a [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object in the response body.
+If successful, this method returns a `201 Created` response code and a [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object in the response body.
## Example
v1.0 Intune Apps Ioslobappprovisioningconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfiguration-delete.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Deletes a [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md).
+Deletes a [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md).
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
v1.0 Intune Apps Ioslobappprovisioningconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfiguration-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object.
+Read properties and relationships of the [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object in the response body.
## Example
v1.0 Intune Apps Ioslobappprovisioningconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfiguration-list.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-List properties and relationships of the [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) objects.
+List properties and relationships of the [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) objects.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
GET /deviceAppManagement/iosLobAppProvisioningConfigurations
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and a collection of [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) objects in the response body.
## Example
v1.0 Intune Apps Ioslobappprovisioningconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfiguration-update.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Update the properties of a [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object.
+Update the properties of a [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /deviceAppManagement/iosLobAppProvisioningConfigurations/{iosLobAppProvisi
|Accept|application/json| ## Request body
-In the request body, supply a JSON representation for the [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object.
+In the request body, supply a JSON representation for the [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object.
-The following table shows the properties that are required when you create the [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md).
+The following table shows the properties that are required when you create the [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md).
|Property|Type|Description| |:|:|:|
The following table shows the properties that are required when you create the [
## Response
-If successful, this method returns a `200 OK` response code and an updated [iosLobAppProvisioningConfiguration](../resources/intune-shared-ioslobappprovisioningconfiguration.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an updated [iosLobAppProvisioningConfiguration](../resources/intune-apps-ioslobappprovisioningconfiguration.md) object in the response body.
## Example
v1.0 Intune Apps Iosvppapp Revokealllicenses https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppapp-revokealllicenses.md
Content-length: 36
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Apps Iosvppapp Revokedevicelicense https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppapp-revokedevicelicense.md
Content-length: 85
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Apps Iosvppapp Revokeuserlicense https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppapp-revokeuserlicense.md
Content-length: 66
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Apps Iosvppappassigneddevicelicense Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-create.md
Content-Length: 376
"managedDeviceId": "Managed Device Id value", "deviceName": "Device Name value" }
-```
+```
v1.0 Intune Apps Iosvppappassigneddevicelicense Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-delete.md
DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Apps Iosvppappassigneddevicelicense Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-get.md
Content-Length: 411
"deviceName": "Device Name value" } }
-```
+```
v1.0 Intune Apps Iosvppappassigneddevicelicense List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-list.md
Content-Length: 441
} ] }
-```
+```
v1.0 Intune Apps Iosvppappassigneddevicelicense Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-update.md
Content-Length: 376
"managedDeviceId": "Managed Device Id value", "deviceName": "Device Name value" }
-```
+```
v1.0 Intune Apps Iosvppappassignedlicense Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-create.md
Content-Length: 283
"userName": "User Name value", "userPrincipalName": "User Principal Name value" }
-```
+```
v1.0 Intune Apps Iosvppappassignedlicense Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-delete.md
DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Apps Iosvppappassignedlicense Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-get.md
Content-Length: 314
"userPrincipalName": "User Principal Name value" } }
-```
+```
v1.0 Intune Apps Iosvppappassignedlicense List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-list.md
Content-Length: 340
} ] }
-```
+```
v1.0 Intune Apps Iosvppappassignedlicense Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-update.md
Content-Length: 283
"userName": "User Name value", "userPrincipalName": "User Principal Name value" }
-```
+```
v1.0 Intune Apps Iosvppappassigneduserlicense Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-create.md
Content-Length: 287
"userName": "User Name value", "userPrincipalName": "User Principal Name value" }
-```
+```
v1.0 Intune Apps Iosvppappassigneduserlicense Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-delete.md
DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Apps Iosvppappassigneduserlicense Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-get.md
Content-Length: 318
"userPrincipalName": "User Principal Name value" } }
-```
+```
v1.0 Intune Apps Iosvppappassigneduserlicense List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-list.md
Content-Length: 344
} ] }
-```
+```
v1.0 Intune Apps Iosvppappassigneduserlicense Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-update.md
Content-Length: 287
"userName": "User Name value", "userPrincipalName": "User Principal Name value" }
-```
+```
v1.0 Intune Apps Macosvppappassignedlicense Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-create.md
Content-Length: 285
"userName": "User Name value", "userPrincipalName": "User Principal Name value" }
-```
+```
v1.0 Intune Apps Macosvppappassignedlicense Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-delete.md
DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Apps Macosvppappassignedlicense Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-get.md
Content-Length: 316
"userPrincipalName": "User Principal Name value" } }
-```
+```
v1.0 Intune Apps Macosvppappassignedlicense List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-list.md
Content-Length: 342
} ] }
-```
+```
v1.0 Intune Apps Macosvppappassignedlicense Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-update.md
Content-Length: 285
"userName": "User Name value", "userPrincipalName": "User Principal Name value" }
-```
+```
v1.0 Intune Apps Microsoftstoreforbusinesscontainedapp Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-create.md
Content-Length: 176
"id": "bf1d79df-79df-bf1d-df79-1dbfdf791dbf", "appUserModelId": "App User Model Id value" }
-```
+```
v1.0 Intune Apps Microsoftstoreforbusinesscontainedapp Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-delete.md
DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Apps Microsoftstoreforbusinesscontainedapp Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-get.md
Content-Length: 201
"appUserModelId": "App User Model Id value" } }
-```
+```
v1.0 Intune Apps Microsoftstoreforbusinesscontainedapp List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-list.md
Content-Length: 221
} ] }
-```
+```
v1.0 Intune Apps Microsoftstoreforbusinesscontainedapp Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-update.md
Content-Length: 176
"id": "bf1d79df-79df-bf1d-df79-1dbfdf791dbf", "appUserModelId": "App User Model Id value" }
-```
+```
v1.0 Intune Apps Mobileapp Createcatalogapp https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileapp-createcatalogapp.md
Content-Length: 1010
"supersededAppCount": 2 } }
-```
+```
v1.0 Intune Apps Mobileapp Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileapp-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [mobileApp](../resources/intune-shared-mobileapp.md) object.
+Read properties and relationships of the [mobileApp](../resources/intune-apps-mobileapp.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [mobileApp](../resources/intune-shared-mobileapp.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [mobileApp](../resources/intune-apps-mobileapp.md) object in the response body.
## Example
v1.0 Intune Apps Mobileapp Getpublishingconstraints https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileapp-getpublishingconstraints.md
Content-Length: 245
} } }
-```
+```
v1.0 Intune Apps Mobileapp List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileapp-list.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-List properties and relationships of the [mobileApp](../resources/intune-shared-mobileapp.md) objects.
+List properties and relationships of the [mobileApp](../resources/intune-apps-mobileapp.md) objects.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
GET /deviceAppManagement/mobileApps
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and a collection of [mobileApp](../resources/intune-shared-mobileapp.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [mobileApp](../resources/intune-apps-mobileapp.md) objects in the response body.
## Example
v1.0 Intune Apps Mobileappcontent Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontent-create.md
Content-Length: 107
"@odata.type": "#microsoft.graph.mobileAppContent", "id": "fe0bb9a9-b9a9-fe0b-a9b9-0bfea9b90bfe" }
-```
+```
v1.0 Intune Apps Mobileappcontent Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontent-delete.md
DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Apps Mobileappcontent Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontent-get.md
Content-Length: 130
"id": "fe0bb9a9-b9a9-fe0b-a9b9-0bfea9b90bfe" } }
-```
+```
v1.0 Intune Apps Mobileappcontent List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontent-list.md
Content-Length: 148
} ] }
-```
+```
v1.0 Intune Apps Mobileappcontent Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontent-update.md
Content-Length: 107
"@odata.type": "#microsoft.graph.mobileAppContent", "id": "fe0bb9a9-b9a9-fe0b-a9b9-0bfea9b90bfe" }
-```
+```
v1.0 Intune Apps Mobileappcontentfile Commit https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-commit.md
Content-length: 399
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Apps Mobileappcontentfile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-create.md
Content-Length: 555
"isFrameworkFile": true, "isDependency": true }
-```
+```
v1.0 Intune Apps Mobileappcontentfile Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-delete.md
DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Apps Mobileappcontentfile Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-get.md
Content-Length: 604
"isDependency": true } }
-```
+```
v1.0 Intune Apps Mobileappcontentfile List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-list.md
Content-Length: 648
} ] }
-```
+```
v1.0 Intune Apps Mobileappcontentfile Renewupload https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-renewupload.md
POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppI
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Apps Mobileappcontentfile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappcontentfile-update.md
Content-Length: 555
"isFrameworkFile": true, "isDependency": true }
-```
+```
v1.0 Intune Apps Mobilecontainedapp Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobilecontainedapp-get.md
Content-Length: 132
"id": "3c02d875-d875-3c02-75d8-023c75d8023c" } }
-```
+```
v1.0 Intune Apps Mobilecontainedapp List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobilecontainedapp-list.md
Content-Length: 150
} ] }
-```
+```
v1.0 Intune Apps Windowsuniversalappxcontainedapp Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-windowsuniversalappxcontainedapp-create.md
Content-Length: 171
"id": "2d03284a-284a-2d03-4a28-032d4a28032d", "appUserModelId": "App User Model Id value" }
-```
+```
v1.0 Intune Apps Windowsuniversalappxcontainedapp Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-windowsuniversalappxcontainedapp-delete.md
DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAp
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Apps Windowsuniversalappxcontainedapp Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-windowsuniversalappxcontainedapp-get.md
Content-Length: 196
"appUserModelId": "App User Model Id value" } }
-```
+```
v1.0 Intune Apps Windowsuniversalappxcontainedapp List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-windowsuniversalappxcontainedapp-list.md
Content-Length: 216
} ] }
-```
+```
v1.0 Intune Apps Windowsuniversalappxcontainedapp Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-windowsuniversalappxcontainedapp-update.md
Content-Length: 171
"id": "2d03284a-284a-2d03-4a28-032d4a28032d", "appUserModelId": "App User Model Id value" }
-```
+```
v1.0 Intune Auditing Auditevent Getauditactivitytypes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-auditing-auditevent-getauditactivitytypes.md
Content-Length: 61
"Get Audit Activity Types value" ] }
-```
+```
v1.0 Intune Auditing Devicemanagement Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-auditing-devicemanagement-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+Read properties and relationships of the [deviceManagement](../resources/intune-auditing-devicemanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-auditing-devicemanagement.md) object in the response body.
## Example
v1.0 Intune Auditing Devicemanagement Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-auditing-devicemanagement-update.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+Update the properties of a [deviceManagement](../resources/intune-auditing-devicemanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /deviceManagement
|Accept|application/json| ## Request body
-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-auditing-devicemanagement.md) object.
-The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md).
+The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-auditing-devicemanagement.md).
|Property|Type|Description| |:|:|:|
The following table shows the properties that are required when you create the [
## Response
-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-auditing-devicemanagement.md) object in the response body.
## Example
v1.0 Intune Books Deviceappmanagement Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-books-deviceappmanagement-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.
+Read properties and relationships of the [deviceAppManagement](../resources/intune-books-deviceappmanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [deviceAppManagement](../resources/intune-books-deviceappmanagement.md) object in the response body.
## Example
v1.0 Intune Books Deviceappmanagement Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-books-deviceappmanagement-update.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Update the properties of a [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.
+Update the properties of a [deviceAppManagement](../resources/intune-books-deviceappmanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /deviceAppManagement
|Accept|application/json| ## Request body
-In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object.
+In the request body, supply a JSON representation for the [deviceAppManagement](../resources/intune-books-deviceappmanagement.md) object.
-The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md).
+The following table shows the properties that are required when you create the [deviceAppManagement](../resources/intune-books-deviceappmanagement.md).
|Property|Type|Description| |:|:|:|
The following table shows the properties that are required when you create the [
## Response
-If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-shared-deviceappmanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an updated [deviceAppManagement](../resources/intune-books-deviceappmanagement.md) object in the response body.
## Example
v1.0 Intune Chromebooksync Devicemanagement Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-devicemanagement-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+Read properties and relationships of the [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md) object in the response body.
## Example
v1.0 Intune Chromebooksync Devicemanagement Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-devicemanagement-update.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+Update the properties of a [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /deviceManagement
|Accept|application/json| ## Request body
-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md) object.
-The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md).
+The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md).
|Property|Type|Description| |:|:|:|
The following table shows the properties that are required when you create the [
## Response
-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-chromebooksync-devicemanagement.md) object in the response body.
## Example
v1.0 Intune Cloudpkigraphservice Devicemanagement Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-cloudpkigraphservice-devicemanagement-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+Read properties and relationships of the [deviceManagement](../resources/intune-cloudpkigraphservice-devicemanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-cloudpkigraphservice-devicemanagement.md) object in the response body.
## Example
v1.0 Intune Cloudpkigraphservice Devicemanagement Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-cloudpkigraphservice-devicemanagement-update.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+Update the properties of a [deviceManagement](../resources/intune-cloudpkigraphservice-devicemanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /deviceManagement
|Accept|application/json| ## Request body
-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-cloudpkigraphservice-devicemanagement.md) object.
-The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md).
+The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-cloudpkigraphservice-devicemanagement.md).
|Property|Type|Description| |:|:|:|
The following table shows the properties that are required when you create the [
## Response
-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-cloudpkigraphservice-devicemanagement.md) object in the response body.
## Example
v1.0 Intune Companyterms Devicemanagement Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-companyterms-devicemanagement-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+Read properties and relationships of the [deviceManagement](../resources/intune-companyterms-devicemanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-companyterms-devicemanagement.md) object in the response body.
## Example
v1.0 Intune Companyterms Devicemanagement Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-companyterms-devicemanagement-update.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+Update the properties of a [deviceManagement](../resources/intune-companyterms-devicemanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /deviceManagement
|Accept|application/json| ## Request body
-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-companyterms-devicemanagement.md) object.
-The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md).
+The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-companyterms-devicemanagement.md).
|Property|Type|Description| |:|:|:|
The following table shows the properties that are required when you create the [
## Response
-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-companyterms-devicemanagement.md) object in the response body.
## Example
v1.0 Intune Deviceconfig Androidcertificateprofilebase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidcertificateprofilebase-get.md
Content-Length: 1723
] } }
-```
+```
v1.0 Intune Deviceconfig Androiddeviceownercertificateprofilebase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownercertificateprofilebase-get.md
Content-Length: 1734
"subjectAlternativeNameType": "emailAddress" } }
-```
+```
v1.0 Intune Deviceconfig Androiddeviceownerimportedpfxcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownerimportedpfxcertificateprofile-create.md
The following table shows the properties that are required when you create the a
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.| |certificateAccessType|[androidDeviceOwnerCertificateAccessType](../resources/intune-deviceconfig-androiddeviceownercertificateaccesstype.md)|Certificate access type. Possible values are: `userApproval`, `specificApps`, `unknownFutureValue`.|
v1.0 Intune Deviceconfig Androiddeviceownerimportedpfxcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownerimportedpfxcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.| |certificateAccessType|[androidDeviceOwnerCertificateAccessType](../resources/intune-deviceconfig-androiddeviceownercertificateaccesstype.md)|Certificate access type. Possible values are: `userApproval`, `specificApps`, `unknownFutureValue`.|
v1.0 Intune Deviceconfig Androiddeviceownerpkcscertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownerpkcscertificateprofile-create.md
The following table shows the properties that are required when you create the a
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name|
v1.0 Intune Deviceconfig Androiddeviceownerpkcscertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownerpkcscertificateprofile-update.md
The following table shows the properties that are required when you create the [
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name|
v1.0 Intune Deviceconfig Androiddeviceownerscepcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownerscepcertificateprofile-create.md
The following table shows the properties that are required when you create the a
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US|
v1.0 Intune Deviceconfig Androiddeviceownerscepcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownerscepcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-androiddeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US|
v1.0 Intune Deviceconfig Androiddeviceownertrustedrootcertificate Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownertrustedrootcertificate-create.md
Content-Length: 1323
"trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }
-```
+```
v1.0 Intune Deviceconfig Androiddeviceownertrustedrootcertificate Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownertrustedrootcertificate-delete.md
DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Deviceconfig Androiddeviceownertrustedrootcertificate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownertrustedrootcertificate-get.md
Content-Length: 1410
"certFileName": "Cert File Name value" } }
-```
+```
v1.0 Intune Deviceconfig Androiddeviceownertrustedrootcertificate List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownertrustedrootcertificate-list.md
Content-Length: 1492
} ] }
-```
+```
v1.0 Intune Deviceconfig Androiddeviceownertrustedrootcertificate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownertrustedrootcertificate-update.md
Content-Length: 1323
"trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }
-```
+```
v1.0 Intune Deviceconfig Androidforworkcertificateprofilebase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkcertificateprofilebase-get.md
Content-Length: 1730
"subjectAlternativeNameType": "emailAddress" } }
-```
+```
v1.0 Intune Deviceconfig Androidforworkimportedpfxcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkimportedpfxcertificateprofile-create.md
The following table shows the properties that are required when you create the a
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
|intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.|
v1.0 Intune Deviceconfig Androidforworkimportedpfxcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkimportedpfxcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
|intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.|
v1.0 Intune Deviceconfig Androidforworkpkcscertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkpkcscertificateprofile-create.md
The following table shows the properties that are required when you create the a
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name|
v1.0 Intune Deviceconfig Androidforworkpkcscertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkpkcscertificateprofile-update.md
The following table shows the properties that are required when you create the [
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name|
v1.0 Intune Deviceconfig Androidforworkscepcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkscepcertificateprofile-create.md
The following table shows the properties that are required when you create the a
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US|
v1.0 Intune Deviceconfig Androidforworkscepcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworkscepcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidForWorkCertificateProfileBase](../resources/intune-deviceconfig-androidforworkcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US|
v1.0 Intune Deviceconfig Androidforworktrustedrootcertificate Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworktrustedrootcertificate-delete.md
DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Deviceconfig Androidforworktrustedrootcertificate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworktrustedrootcertificate-get.md
Content-Length: 1406
"certFileName": "Cert File Name value" } }
-```
+```
v1.0 Intune Deviceconfig Androidforworktrustedrootcertificate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidforworktrustedrootcertificate-update.md
Content-Length: 1319
"trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }
-```
+```
v1.0 Intune Deviceconfig Androidimportedpfxcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidimportedpfxcertificateprofile-create.md
The following table shows the properties that are required when you create the a
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
|intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.|
v1.0 Intune Deviceconfig Androidimportedpfxcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidimportedpfxcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
|intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.|
v1.0 Intune Deviceconfig Androidpkcscertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidpkcscertificateprofile-create.md
The following table shows the properties that are required when you create the a
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
|certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| |certificateTemplateName|String|PKCS Certificate Template Name|
v1.0 Intune Deviceconfig Androidpkcscertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidpkcscertificateprofile-update.md
The following table shows the properties that are required when you create the [
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
|certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name| |certificateTemplateName|String|PKCS Certificate Template Name|
v1.0 Intune Deviceconfig Androidscepcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidscepcertificateprofile-create.md
The following table shows the properties that are required when you create the a
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
|scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.|
v1.0 Intune Deviceconfig Androidscepcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidscepcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidCertificateProfileBase](../resources/intune-deviceconfig-androidcertificateprofilebase.md)|
|scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.|
v1.0 Intune Deviceconfig Androidtrustedrootcertificate Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidtrustedrootcertificate-delete.md
DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Deviceconfig Androidtrustedrootcertificate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidtrustedrootcertificate-get.md
Content-Length: 1399
"certFileName": "Cert File Name value" } }
-```
+```
v1.0 Intune Deviceconfig Androidtrustedrootcertificate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidtrustedrootcertificate-update.md
Content-Length: 1312
"trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }
-```
+```
v1.0 Intune Deviceconfig Androidworkprofilecertificateprofilebase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofilecertificateprofilebase-get.md
Content-Length: 1734
"subjectAlternativeNameType": "emailAddress" } }
-```
+```
v1.0 Intune Deviceconfig Androidworkprofilepkcscertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofilepkcscertificateprofile-create.md
The following table shows the properties that are required when you create the a
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name|
v1.0 Intune Deviceconfig Androidworkprofilepkcscertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofilepkcscertificateprofile-update.md
The following table shows the properties that are required when you create the [
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name|
v1.0 Intune Deviceconfig Androidworkprofilescepcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofilescepcertificateprofile-create.md
The following table shows the properties that are required when you create the a
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US|
v1.0 Intune Deviceconfig Androidworkprofilescepcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofilescepcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [androidWorkProfileCertificateProfileBase](../resources/intune-deviceconfig-androidworkprofilecertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US|
v1.0 Intune Deviceconfig Androidworkprofiletrustedrootcertificate Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofiletrustedrootcertificate-delete.md
DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Deviceconfig Androidworkprofiletrustedrootcertificate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofiletrustedrootcertificate-get.md
Content-Length: 1410
"certFileName": "Cert File Name value" } }
-```
+```
v1.0 Intune Deviceconfig Androidworkprofiletrustedrootcertificate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-androidworkprofiletrustedrootcertificate-update.md
Content-Length: 1323
"trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }
-```
+```
v1.0 Intune Deviceconfig Aospdeviceownercertificateprofilebase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownercertificateprofilebase-get.md
Content-Length: 1731
"subjectAlternativeNameType": "emailAddress" } }
-```
+```
v1.0 Intune Deviceconfig Aospdeviceownerpkcscertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownerpkcscertificateprofile-create.md
The following table shows the properties that are required when you create the a
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name|
v1.0 Intune Deviceconfig Aospdeviceownerpkcscertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownerpkcscertificateprofile-update.md
The following table shows the properties that are required when you create the [
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificationAuthority|String|PKCS Certification Authority| |certificationAuthorityName|String|PKCS Certification Authority Name|
v1.0 Intune Deviceconfig Aospdeviceownerscepcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownerscepcertificateprofile-create.md
The following table shows the properties that are required when you create the a
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US|
v1.0 Intune Deviceconfig Aospdeviceownerscepcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownerscepcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md)|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. This collection can contain a maximum of 500 elements. Inherited from [aospDeviceOwnerCertificateProfileBase](../resources/intune-deviceconfig-aospdeviceownercertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |scepServerUrls|String collection|SCEP Server Url(s)| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US|
v1.0 Intune Deviceconfig Aospdeviceownertrustedrootcertificate Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownertrustedrootcertificate-delete.md
DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Deviceconfig Aospdeviceownertrustedrootcertificate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownertrustedrootcertificate-get.md
Content-Length: 1407
"certFileName": "Cert File Name value" } }
-```
+```
v1.0 Intune Deviceconfig Aospdeviceownertrustedrootcertificate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-aospdeviceownertrustedrootcertificate-update.md
Content-Length: 1320
"trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }
-```
+```
v1.0 Intune Deviceconfig Devicecompliancepolicy Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-devicecompliancepolicy-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [deviceCompliancePolicy](../resources/intune-shared-devicecompliancepolicy.md) object.
+Read properties and relationships of the [deviceCompliancePolicy](../resources/intune-deviceconfig-devicecompliancepolicy.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [deviceCompliancePolicy](../resources/intune-shared-devicecompliancepolicy.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [deviceCompliancePolicy](../resources/intune-deviceconfig-devicecompliancepolicy.md) object in the response body.
## Example
v1.0 Intune Deviceconfig Devicecompliancepolicy List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-devicecompliancepolicy-list.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-List properties and relationships of the [deviceCompliancePolicy](../resources/intune-shared-devicecompliancepolicy.md) objects.
+List properties and relationships of the [deviceCompliancePolicy](../resources/intune-deviceconfig-devicecompliancepolicy.md) objects.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
GET /deviceManagement/deviceCompliancePolicies
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and a collection of [deviceCompliancePolicy](../resources/intune-shared-devicecompliancepolicy.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [deviceCompliancePolicy](../resources/intune-deviceconfig-devicecompliancepolicy.md) objects in the response body.
## Example
v1.0 Intune Deviceconfig Deviceconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-deviceconfiguration-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) object.
+Read properties and relationships of the [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md) object in the response body.
## Example
v1.0 Intune Deviceconfig Deviceconfiguration Getomasettingplaintextvalue https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-deviceconfiguration-getomasettingplaintextvalue.md
Content-Length: 57
{ "value": "Get Oma Setting Plain Text Value value" }
-```
+```
v1.0 Intune Deviceconfig Deviceconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-deviceconfiguration-list.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-List properties and relationships of the [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) objects.
+List properties and relationships of the [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md) objects.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
GET /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.gra
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and a collection of [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md) objects in the response body.
## Example
v1.0 Intune Deviceconfig Devicemanagement Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-devicemanagement-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+Read properties and relationships of the [deviceManagement](../resources/intune-deviceconfig-devicemanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-deviceconfig-devicemanagement.md) object in the response body.
## Example
v1.0 Intune Deviceconfig Devicemanagement Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-devicemanagement-update.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Update the properties of a [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+Update the properties of a [deviceManagement](../resources/intune-deviceconfig-devicemanagement.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /deviceManagement
|Accept|application/json| ## Request body
-In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-shared-devicemanagement.md) object.
+In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-deviceconfig-devicemanagement.md) object.
-The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-shared-devicemanagement.md).
+The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-deviceconfig-devicemanagement.md).
|Property|Type|Description| |:|:|:|
The following table shows the properties that are required when you create the [
## Response
-If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-shared-devicemanagement.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-deviceconfig-devicemanagement.md) object in the response body.
## Example
v1.0 Intune Deviceconfig Devicemanagementderivedcredentialsettings Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-devicemanagementderivedcredentialsettings-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object.
+Read properties and relationships of the [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md) object in the response body.
## Example
Content-Length: 155
"id": "bc650741-0741-bc65-4107-65bc410765bc" } }
-```
+```
v1.0 Intune Deviceconfig Devicemanagementderivedcredentialsettings Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-devicemanagementderivedcredentialsettings-update.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Update the properties of a [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object.
+Update the properties of a [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.g
|Accept|application/json| ## Request body
-In the request body, supply a JSON representation for the [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object.
+In the request body, supply a JSON representation for the [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md) object.
-The following table shows the properties that are required when you create the [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md).
+The following table shows the properties that are required when you create the [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md).
|Property|Type|Description| |:|:|:|
The following table shows the properties that are required when you create the [
## Response
-If successful, this method returns a `200 OK` response code and an updated [deviceManagementDerivedCredentialSettings](../resources/intune-shared-devicemanagementderivedcredentialsettings.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an updated [deviceManagementDerivedCredentialSettings](../resources/intune-deviceconfig-devicemanagementderivedcredentialsettings.md) object in the response body.
## Example
Content-Length: 132
"@odata.type": "#microsoft.graph.deviceManagementDerivedCredentialSettings", "id": "bc650741-0741-bc65-4107-65bc410765bc" }
-```
+```
v1.0 Intune Deviceconfig Hardwarepassworddetail Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-hardwarepassworddetail-create.md
+
+ Title: "Create hardwarePasswordDetail"
+description: "Create a new hardwarePasswordDetail object."
+
+localization_priority: Normal
+++
+# Create hardwarePasswordDetail
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Create a new [hardwarePasswordDetail](../resources/intune-deviceconfig-hardwarepassworddetail.md) object.
++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|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|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/hardwarePasswordDetails
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+In the request body, supply a JSON representation for the hardwarePasswordDetail object.
+
+The following table shows the properties that are required when you create the hardwarePasswordDetail.
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|The unique identifier for the managed device. This ID is assigned at enrollment time. This is different than the Entra device ID, this one is for the managedDevice object itself. Supports: $filter, $select, $top, $OrderBy, $skip. This property is read-only.|
+|serialNumber|String|The device serial number as defined by the device manufacturer. Supports: $filter, $select, $top, $OrderBy, $skip. This property is read-only.|
+|currentPassword|String|The current device's BIOS password. Supports: $filter, $select, $top, $OrderBy, $skip. This property is read-only.|
+|previousPasswords|String collection|The list of all the previous device BIOS passwords. Supports: $filter, $select, $top, $skip. This property is read-only.|
+++
+## Response
+If successful, this method returns a `201 Created` response code and a [hardwarePasswordDetail](../resources/intune-deviceconfig-hardwarepassworddetail.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/hardwarePasswordDetails
+Content-type: application/json
+Content-length: 218
+
+{
+ "@odata.type": "#microsoft.graph.hardwarePasswordDetail",
+ "serialNumber": "Serial Number value",
+ "currentPassword": "Current Password value",
+ "previousPasswords": [
+ "Previous Passwords value"
+ ]
+}
+```
+
+### 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
+HTTP/1.1 201 Created
+Content-Type: application/json
+Content-Length: 267
+
+{
+ "@odata.type": "#microsoft.graph.hardwarePasswordDetail",
+ "id": "e3ef8349-8349-e3ef-4983-efe34983efe3",
+ "serialNumber": "Serial Number value",
+ "currentPassword": "Current Password value",
+ "previousPasswords": [
+ "Previous Passwords value"
+ ]
+}
+```
v1.0 Intune Deviceconfig Hardwarepassworddetail Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-hardwarepassworddetail-delete.md
+
+ Title: "Delete hardwarePasswordDetail"
+description: "Deletes a hardwarePasswordDetail."
+
+localization_priority: Normal
+++
+# Delete hardwarePasswordDetail
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Deletes a [hardwarePasswordDetail](../resources/intune-deviceconfig-hardwarepassworddetail.md).
++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|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|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /deviceManagement/hardwarePasswordDetails/{hardwarePasswordDetailId}
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+DELETE https://graph.microsoft.com/beta/deviceManagement/hardwarePasswordDetails/{hardwarePasswordDetailId}
+```
+
+### 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
+HTTP/1.1 204 No Content
+```
v1.0 Intune Deviceconfig Hardwarepassworddetail Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-hardwarepassworddetail-get.md
+
+ Title: "Get hardwarePasswordDetail"
+description: "Read properties and relationships of the hardwarePasswordDetail object."
+
+localization_priority: Normal
+++
+# Get hardwarePasswordDetail
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Read properties and relationships of the [hardwarePasswordDetail](../resources/intune-deviceconfig-hardwarepassworddetail.md) object.
++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceManagement/hardwarePasswordDetails/{hardwarePasswordDetailId}
+```
+
+## Optional query parameters
+This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and [hardwarePasswordDetail](../resources/intune-deviceconfig-hardwarepassworddetail.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/hardwarePasswordDetails/{hardwarePasswordDetailId}
+```
+
+### 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
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 300
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.hardwarePasswordDetail",
+ "id": "e3ef8349-8349-e3ef-4983-efe34983efe3",
+ "serialNumber": "Serial Number value",
+ "currentPassword": "Current Password value",
+ "previousPasswords": [
+ "Previous Passwords value"
+ ]
+ }
+}
+```
v1.0 Intune Deviceconfig Hardwarepassworddetail List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-hardwarepassworddetail-list.md
+
+ Title: "List hardwarePasswordDetails"
+description: "List properties and relationships of the hardwarePasswordDetail objects."
+
+localization_priority: Normal
+++
+# List hardwarePasswordDetails
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+List properties and relationships of the [hardwarePasswordDetail](../resources/intune-deviceconfig-hardwarepassworddetail.md) objects.
++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceManagement/hardwarePasswordDetails
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and a collection of [hardwarePasswordDetail](../resources/intune-deviceconfig-hardwarepassworddetail.md) objects in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/hardwarePasswordDetails
+```
+
+### 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
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 328
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.hardwarePasswordDetail",
+ "id": "e3ef8349-8349-e3ef-4983-efe34983efe3",
+ "serialNumber": "Serial Number value",
+ "currentPassword": "Current Password value",
+ "previousPasswords": [
+ "Previous Passwords value"
+ ]
+ }
+ ]
+}
+```
v1.0 Intune Deviceconfig Hardwarepassworddetail Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-hardwarepassworddetail-update.md
+
+ Title: "Update hardwarePasswordDetail"
+description: "Update the properties of a hardwarePasswordDetail object."
+
+localization_priority: Normal
+++
+# Update hardwarePasswordDetail
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Update the properties of a [hardwarePasswordDetail](../resources/intune-deviceconfig-hardwarepassworddetail.md) object.
++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|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|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /deviceManagement/hardwarePasswordDetails/{hardwarePasswordDetailId}
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+In the request body, supply a JSON representation for the [hardwarePasswordDetail](../resources/intune-deviceconfig-hardwarepassworddetail.md) object.
+
+The following table shows the properties that are required when you create the [hardwarePasswordDetail](../resources/intune-deviceconfig-hardwarepassworddetail.md).
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|The unique identifier for the managed device. This ID is assigned at enrollment time. This is different than the Entra device ID, this one is for the managedDevice object itself. Supports: $filter, $select, $top, $OrderBy, $skip. This property is read-only.|
+|serialNumber|String|The device serial number as defined by the device manufacturer. Supports: $filter, $select, $top, $OrderBy, $skip. This property is read-only.|
+|currentPassword|String|The current device's BIOS password. Supports: $filter, $select, $top, $OrderBy, $skip. This property is read-only.|
+|previousPasswords|String collection|The list of all the previous device BIOS passwords. Supports: $filter, $select, $top, $skip. This property is read-only.|
+++
+## Response
+If successful, this method returns a `200 OK` response code and an updated [hardwarePasswordDetail](../resources/intune-deviceconfig-hardwarepassworddetail.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+PATCH https://graph.microsoft.com/beta/deviceManagement/hardwarePasswordDetails/{hardwarePasswordDetailId}
+Content-type: application/json
+Content-length: 218
+
+{
+ "@odata.type": "#microsoft.graph.hardwarePasswordDetail",
+ "serialNumber": "Serial Number value",
+ "currentPassword": "Current Password value",
+ "previousPasswords": [
+ "Previous Passwords value"
+ ]
+}
+```
+
+### 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
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 267
+
+{
+ "@odata.type": "#microsoft.graph.hardwarePasswordDetail",
+ "id": "e3ef8349-8349-e3ef-4983-efe34983efe3",
+ "serialNumber": "Serial Number value",
+ "currentPassword": "Current Password value",
+ "previousPasswords": [
+ "Previous Passwords value"
+ ]
+}
+```
v1.0 Intune Deviceconfig Hardwarepasswordinfo Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-hardwarepasswordinfo-create.md
The following table shows the properties that are required when you create the h
|Property|Type|Description| |:|:|:|
-|id|String|Unique Identifier for the hardware password info|
-|serialNumber|String|Device serial number|
-|currentPassword|String|Current device password|
-|previousPasswords|String collection|List of previous device passwords|
+|id|String|A unique string Id that is based on associated Intune Device Id. This property is read-only.|
+|serialNumber|String|Associated device's serial number . This property is read-only.|
+|currentPassword|String|Current device password. This property is read-only.|
+|previousPasswords|String collection|List of previous device passwords. This property is read-only.|
v1.0 Intune Deviceconfig Hardwarepasswordinfo Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-hardwarepasswordinfo-update.md
The following table shows the properties that are required when you create the [
|Property|Type|Description| |:|:|:|
-|id|String|Unique Identifier for the hardware password info|
-|serialNumber|String|Device serial number|
-|currentPassword|String|Current device password|
-|previousPasswords|String collection|List of previous device passwords|
+|id|String|A unique string Id that is based on associated Intune Device Id. This property is read-only.|
+|serialNumber|String|Associated device's serial number . This property is read-only.|
+|currentPassword|String|Current device password. This property is read-only.|
+|previousPasswords|String collection|List of previous device passwords. This property is read-only.|
v1.0 Intune Deviceconfig Ioscertificateprofile Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-ioscertificateprofile-get.md
Content-Length: 1279
"version": 7 } }
-```
+```
v1.0 Intune Deviceconfig Ioscertificateprofilebase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-ioscertificateprofilebase-get.md
Content-Length: 1512
"certificateValidityPeriodScale": "months" } }
-```
+```
v1.0 Intune Deviceconfig Iosscepcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iosscepcertificateprofile-create.md
The following table shows the properties that are required when you create the i
|subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |keySize|[keySize](../resources/intune-shared-keysize.md)|SCEP Key Size. Possible values are: `size1024`, `size2048`, `size4096`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.|
|subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. The OnPremisesUserPrincipalName variable is support as well as others documented here: https://go.microsoft.com/fwlink/?LinkId=2027630. This collection can contain a maximum of 500 elements.|
v1.0 Intune Deviceconfig Iosscepcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iosscepcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |keySize|[keySize](../resources/intune-shared-keysize.md)|SCEP Key Size. Possible values are: `size1024`, `size2048`, `size4096`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.|
|subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. The OnPremisesUserPrincipalName variable is support as well as others documented here: https://go.microsoft.com/fwlink/?LinkId=2027630. This collection can contain a maximum of 500 elements.|
v1.0 Intune Deviceconfig Iostrustedrootcertificate Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iostrustedrootcertificate-create.md
Content-Length: 1308
"trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }
-```
+```
v1.0 Intune Deviceconfig Iostrustedrootcertificate Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iostrustedrootcertificate-delete.md
DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Deviceconfig Iostrustedrootcertificate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iostrustedrootcertificate-get.md
Content-Length: 1395
"certFileName": "Cert File Name value" } }
-```
+```
v1.0 Intune Deviceconfig Iostrustedrootcertificate List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iostrustedrootcertificate-list.md
Content-Length: 1477
} ] }
-```
+```
v1.0 Intune Deviceconfig Iostrustedrootcertificate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-iostrustedrootcertificate-update.md
Content-Length: 1308
"trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }
-```
+```
v1.0 Intune Deviceconfig Macoscertificateprofilebase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macoscertificateprofilebase-get.md
Content-Length: 1514
"certificateValidityPeriodScale": "months" } }
-```
+```
v1.0 Intune Deviceconfig Macoscustomconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macoscustomconfiguration-create.md
The following table shows the properties that are required when you create the m
|payloadName|String|Name that is displayed to the user.| |payloadFileName|String|Payload file name (*.mobileconfig | *.xml).| |payload|Binary|Payload. (UTF8 encoded byte array)|
-|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the channel used to deploy the configuration profile. Available choices are DeviceChannel, UserChannel. Possible values are: `deviceChannel`, `userChannel`.|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the channel used to deploy the configuration profile. Available choices are DeviceChannel, UserChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
v1.0 Intune Deviceconfig Macoscustomconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macoscustomconfiguration-update.md
The following table shows the properties that are required when you create the [
|payloadName|String|Name that is displayed to the user.| |payloadFileName|String|Payload file name (*.mobileconfig | *.xml).| |payload|Binary|Payload. (UTF8 encoded byte array)|
-|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the channel used to deploy the configuration profile. Available choices are DeviceChannel, UserChannel. Possible values are: `deviceChannel`, `userChannel`.|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the channel used to deploy the configuration profile. Available choices are DeviceChannel, UserChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
v1.0 Intune Deviceconfig Macosenterprisewificonfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosenterprisewificonfiguration-create.md
The following table shows the properties that are required when you create the m
|proxyManualAddress|String|IP Address or DNS hostname of the proxy server when manual configuration is selected. Inherited from [macOSWiFiConfiguration](../resources/intune-deviceconfig-macoswificonfiguration.md)| |proxyManualPort|Int32|Port of the proxy server when manual configuration is selected. Inherited from [macOSWiFiConfiguration](../resources/intune-deviceconfig-macoswificonfiguration.md)| |proxyAutomaticConfigurationUrl|String|URL of the proxy server automatic configuration script when automatic configuration is selected. This URL is typically the location of PAC (Proxy Auto Configuration) file. Inherited from [macOSWiFiConfiguration](../resources/intune-deviceconfig-macoswificonfiguration.md)|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Inherited from [macOSWiFiConfiguration](../resources/intune-deviceconfig-macoswificonfiguration.md). Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
|preSharedKey|String|This is the pre-shared key for WPA Personal Wi-Fi network. Inherited from [macOSWiFiConfiguration](../resources/intune-deviceconfig-macoswificonfiguration.md)| |eapType|[eapType](../resources/intune-deviceconfig-eaptype.md)|Extensible Authentication Protocol (EAP). Indicates the type of EAP protocol set on the Wi-Fi endpoint (router). Possible values are: `eapTls`, `leap`, `eapSim`, `eapTtls`, `peap`, `eapFast`, `teap`.| |eapFastConfiguration|[eapFastConfiguration](../resources/intune-deviceconfig-eapfastconfiguration.md)|EAP-FAST Configuration Option when EAP-FAST is the selected EAP Type. Possible values are: `noProtectedAccessCredential`, `useProtectedAccessCredential`, `useProtectedAccessCredentialAndProvision`, `useProtectedAccessCredentialAndProvisionAnonymously`.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations Content-type: application/json
-Content-length: 1858
+Content-length: 1897
{ "@odata.type": "#microsoft.graph.macOSEnterpriseWiFiConfiguration",
Content-length: 1858
"proxyManualAddress": "Proxy Manual Address value", "proxyManualPort": 15, "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
+ "deploymentChannel": "userChannel",
"preSharedKey": "Pre Shared Key value", "eapType": "leap", "eapFastConfiguration": "useProtectedAccessCredential",
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 2030
+Content-Length: 2069
{ "@odata.type": "#microsoft.graph.macOSEnterpriseWiFiConfiguration",
Content-Length: 2030
"proxyManualAddress": "Proxy Manual Address value", "proxyManualPort": 15, "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
+ "deploymentChannel": "userChannel",
"preSharedKey": "Pre Shared Key value", "eapType": "leap", "eapFastConfiguration": "useProtectedAccessCredential",
v1.0 Intune Deviceconfig Macosenterprisewificonfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosenterprisewificonfiguration-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2149
+Content-Length: 2190
{ "value": {
Content-Length: 2149
"proxyManualAddress": "Proxy Manual Address value", "proxyManualPort": 15, "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
+ "deploymentChannel": "userChannel",
"preSharedKey": "Pre Shared Key value", "eapType": "leap", "eapFastConfiguration": "useProtectedAccessCredential",
v1.0 Intune Deviceconfig Macosenterprisewificonfiguration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosenterprisewificonfiguration-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2263
+Content-Length: 2306
{ "value": [
Content-Length: 2263
"proxyManualAddress": "Proxy Manual Address value", "proxyManualPort": 15, "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
+ "deploymentChannel": "userChannel",
"preSharedKey": "Pre Shared Key value", "eapType": "leap", "eapFastConfiguration": "useProtectedAccessCredential",
v1.0 Intune Deviceconfig Macosenterprisewificonfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosenterprisewificonfiguration-update.md
The following table shows the properties that are required when you create the [
|proxyManualAddress|String|IP Address or DNS hostname of the proxy server when manual configuration is selected. Inherited from [macOSWiFiConfiguration](../resources/intune-deviceconfig-macoswificonfiguration.md)| |proxyManualPort|Int32|Port of the proxy server when manual configuration is selected. Inherited from [macOSWiFiConfiguration](../resources/intune-deviceconfig-macoswificonfiguration.md)| |proxyAutomaticConfigurationUrl|String|URL of the proxy server automatic configuration script when automatic configuration is selected. This URL is typically the location of PAC (Proxy Auto Configuration) file. Inherited from [macOSWiFiConfiguration](../resources/intune-deviceconfig-macoswificonfiguration.md)|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Inherited from [macOSWiFiConfiguration](../resources/intune-deviceconfig-macoswificonfiguration.md). Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
|preSharedKey|String|This is the pre-shared key for WPA Personal Wi-Fi network. Inherited from [macOSWiFiConfiguration](../resources/intune-deviceconfig-macoswificonfiguration.md)| |eapType|[eapType](../resources/intune-deviceconfig-eaptype.md)|Extensible Authentication Protocol (EAP). Indicates the type of EAP protocol set on the Wi-Fi endpoint (router). Possible values are: `eapTls`, `leap`, `eapSim`, `eapTtls`, `peap`, `eapFast`, `teap`.| |eapFastConfiguration|[eapFastConfiguration](../resources/intune-deviceconfig-eapfastconfiguration.md)|EAP-FAST Configuration Option when EAP-FAST is the selected EAP Type. Possible values are: `noProtectedAccessCredential`, `useProtectedAccessCredential`, `useProtectedAccessCredentialAndProvision`, `useProtectedAccessCredentialAndProvisionAnonymously`.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId} Content-type: application/json
-Content-length: 1858
+Content-length: 1897
{ "@odata.type": "#microsoft.graph.macOSEnterpriseWiFiConfiguration",
Content-length: 1858
"proxyManualAddress": "Proxy Manual Address value", "proxyManualPort": 15, "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
+ "deploymentChannel": "userChannel",
"preSharedKey": "Pre Shared Key value", "eapType": "leap", "eapFastConfiguration": "useProtectedAccessCredential",
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2030
+Content-Length: 2069
{ "@odata.type": "#microsoft.graph.macOSEnterpriseWiFiConfiguration",
Content-Length: 2030
"proxyManualAddress": "Proxy Manual Address value", "proxyManualPort": 15, "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
+ "deploymentChannel": "userChannel",
"preSharedKey": "Pre Shared Key value", "eapType": "leap", "eapFastConfiguration": "useProtectedAccessCredential",
v1.0 Intune Deviceconfig Macosimportedpfxcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosimportedpfxcertificateprofile-create.md
The following table shows the properties that are required when you create the m
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [macOSCertificateProfileBase](../resources/intune-deviceconfig-macoscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [macOSCertificateProfileBase](../resources/intune-deviceconfig-macoscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.| |intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations Content-type: application/json
-Content-length: 1297
+Content-length: 1336
{ "@odata.type": "#microsoft.graph.macOSImportedPFXCertificateProfile",
Content-length: 1297
"subjectAlternativeNameType": "emailAddress", "certificateValidityPeriodValue": 14, "certificateValidityPeriodScale": "months",
- "intendedPurpose": "smimeEncryption"
+ "intendedPurpose": "smimeEncryption",
+ "deploymentChannel": "userChannel"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 1469
+Content-Length: 1508
{ "@odata.type": "#microsoft.graph.macOSImportedPFXCertificateProfile",
Content-Length: 1469
"subjectAlternativeNameType": "emailAddress", "certificateValidityPeriodValue": 14, "certificateValidityPeriodScale": "months",
- "intendedPurpose": "smimeEncryption"
+ "intendedPurpose": "smimeEncryption",
+ "deploymentChannel": "userChannel"
} ```
v1.0 Intune Deviceconfig Macosimportedpfxcertificateprofile Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosimportedpfxcertificateprofile-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1564
+Content-Length: 1605
{ "value": {
Content-Length: 1564
"subjectAlternativeNameType": "emailAddress", "certificateValidityPeriodValue": 14, "certificateValidityPeriodScale": "months",
- "intendedPurpose": "smimeEncryption"
+ "intendedPurpose": "smimeEncryption",
+ "deploymentChannel": "userChannel"
} } ```
v1.0 Intune Deviceconfig Macosimportedpfxcertificateprofile List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosimportedpfxcertificateprofile-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1654
+Content-Length: 1697
{ "value": [
Content-Length: 1654
"subjectAlternativeNameType": "emailAddress", "certificateValidityPeriodValue": 14, "certificateValidityPeriodScale": "months",
- "intendedPurpose": "smimeEncryption"
+ "intendedPurpose": "smimeEncryption",
+ "deploymentChannel": "userChannel"
} ] }
v1.0 Intune Deviceconfig Macosimportedpfxcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosimportedpfxcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period. Inherited from [macOSCertificateProfileBase](../resources/intune-deviceconfig-macoscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [macOSCertificateProfileBase](../resources/intune-deviceconfig-macoscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.| |intendedPurpose|[intendedPurpose](../resources/intune-deviceconfig-intendedpurpose.md)|Intended Purpose of the Certificate Profile - which could be Unassigned, SmimeEncryption, SmimeSigning etc. Possible values are: `unassigned`, `smimeEncryption`, `smimeSigning`, `vpn`, `wifi`.|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId} Content-type: application/json
-Content-length: 1297
+Content-length: 1336
{ "@odata.type": "#microsoft.graph.macOSImportedPFXCertificateProfile",
Content-length: 1297
"subjectAlternativeNameType": "emailAddress", "certificateValidityPeriodValue": 14, "certificateValidityPeriodScale": "months",
- "intendedPurpose": "smimeEncryption"
+ "intendedPurpose": "smimeEncryption",
+ "deploymentChannel": "userChannel"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1469
+Content-Length: 1508
{ "@odata.type": "#microsoft.graph.macOSImportedPFXCertificateProfile",
Content-Length: 1469
"subjectAlternativeNameType": "emailAddress", "certificateValidityPeriodValue": 14, "certificateValidityPeriodScale": "months",
- "intendedPurpose": "smimeEncryption"
+ "intendedPurpose": "smimeEncryption",
+ "deploymentChannel": "userChannel"
} ```
v1.0 Intune Deviceconfig Macospkcscertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macospkcscertificateprofile-create.md
The following table shows the properties that are required when you create the m
|certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements.| |allowAllAppsAccess|Boolean|AllowAllAppsAccess setting|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations Content-type: application/json
-Content-length: 1857
+Content-length: 1896
{ "@odata.type": "#microsoft.graph.macOSPkcsCertificateProfile",
Content-length: 1857
"name": "Name value" } ],
- "allowAllAppsAccess": true
+ "allowAllAppsAccess": true,
+ "deploymentChannel": "userChannel"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 2029
+Content-Length: 2068
{ "@odata.type": "#microsoft.graph.macOSPkcsCertificateProfile",
Content-Length: 2029
"name": "Name value" } ],
- "allowAllAppsAccess": true
+ "allowAllAppsAccess": true,
+ "deploymentChannel": "userChannel"
} ```
v1.0 Intune Deviceconfig Macospkcscertificateprofile Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macospkcscertificateprofile-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2150
+Content-Length: 2191
{ "value": {
Content-Length: 2150
"name": "Name value" } ],
- "allowAllAppsAccess": true
+ "allowAllAppsAccess": true,
+ "deploymentChannel": "userChannel"
} } ```
v1.0 Intune Deviceconfig Macospkcscertificateprofile List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macospkcscertificateprofile-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2266
+Content-Length: 2309
{ "value": [
Content-Length: 2266
"name": "Name value" } ],
- "allowAllAppsAccess": true
+ "allowAllAppsAccess": true,
+ "deploymentChannel": "userChannel"
} ] }
v1.0 Intune Deviceconfig Macospkcscertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macospkcscertificateprofile-update.md
The following table shows the properties that are required when you create the [
|certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements.| |allowAllAppsAccess|Boolean|AllowAllAppsAccess setting|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId} Content-type: application/json
-Content-length: 1857
+Content-length: 1896
{ "@odata.type": "#microsoft.graph.macOSPkcsCertificateProfile",
Content-length: 1857
"name": "Name value" } ],
- "allowAllAppsAccess": true
+ "allowAllAppsAccess": true,
+ "deploymentChannel": "userChannel"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2029
+Content-Length: 2068
{ "@odata.type": "#microsoft.graph.macOSPkcsCertificateProfile",
Content-Length: 2029
"name": "Name value" } ],
- "allowAllAppsAccess": true
+ "allowAllAppsAccess": true,
+ "deploymentChannel": "userChannel"
} ```
v1.0 Intune Deviceconfig Macosscepcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosscepcertificateprofile-create.md
The following table shows the properties that are required when you create the m
|keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |keySize|[keySize](../resources/intune-shared-keysize.md)|SCEP Key Size. Possible values are: `size1024`, `size2048`, `size4096`.| |hashAlgorithm|[hashAlgorithms](../resources/intune-shared-hashalgorithms.md)|SCEP Hash Algorithm. Possible values are: `sha1`, `sha2`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.|
|subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements.| |allowAllAppsAccess|Boolean|AllowAllAppsAccess setting|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations Content-type: application/json
-Content-length: 1993
+Content-length: 2032
{ "@odata.type": "#microsoft.graph.macOSScepCertificateProfile",
Content-length: 1993
"name": "Name value" } ],
- "allowAllAppsAccess": true
+ "allowAllAppsAccess": true,
+ "deploymentChannel": "userChannel"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 2165
+Content-Length: 2204
{ "@odata.type": "#microsoft.graph.macOSScepCertificateProfile",
Content-Length: 2165
"name": "Name value" } ],
- "allowAllAppsAccess": true
+ "allowAllAppsAccess": true,
+ "deploymentChannel": "userChannel"
} ```
v1.0 Intune Deviceconfig Macosscepcertificateprofile Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosscepcertificateprofile-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2306
+Content-Length: 2347
{ "value": {
Content-Length: 2306
"name": "Name value" } ],
- "allowAllAppsAccess": true
+ "allowAllAppsAccess": true,
+ "deploymentChannel": "userChannel"
} } ```
v1.0 Intune Deviceconfig Macosscepcertificateprofile List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosscepcertificateprofile-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2442
+Content-Length: 2485
{ "value": [
Content-Length: 2442
"name": "Name value" } ],
- "allowAllAppsAccess": true
+ "allowAllAppsAccess": true,
+ "deploymentChannel": "userChannel"
} ] }
v1.0 Intune Deviceconfig Macosscepcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosscepcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |keySize|[keySize](../resources/intune-shared-keysize.md)|SCEP Key Size. Possible values are: `size1024`, `size2048`, `size4096`.| |hashAlgorithm|[hashAlgorithms](../resources/intune-shared-hashalgorithms.md)|SCEP Hash Algorithm. Possible values are: `sha1`, `sha2`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.|
|subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements.| |allowAllAppsAccess|Boolean|AllowAllAppsAccess setting|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId} Content-type: application/json
-Content-length: 1993
+Content-length: 2032
{ "@odata.type": "#microsoft.graph.macOSScepCertificateProfile",
Content-length: 1993
"name": "Name value" } ],
- "allowAllAppsAccess": true
+ "allowAllAppsAccess": true,
+ "deploymentChannel": "userChannel"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2165
+Content-Length: 2204
{ "@odata.type": "#microsoft.graph.macOSScepCertificateProfile",
Content-Length: 2165
"name": "Name value" } ],
- "allowAllAppsAccess": true
+ "allowAllAppsAccess": true,
+ "deploymentChannel": "userChannel"
} ```
v1.0 Intune Deviceconfig Macostrustedrootcertificate Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macostrustedrootcertificate-create.md
The following table shows the properties that are required when you create the m
|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |trustedRootCertificate|Binary|Trusted Root Certificate.| |certFileName|String|File name to display in UI.|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.macOSWiredNetworkConfiguration/rootCertificatesForServerValidation Content-type: application/json
-Content-length: 1138
+Content-length: 1177
{ "@odata.type": "#microsoft.graph.macOSTrustedRootCertificate",
Content-length: 1138
"displayName": "Display Name value", "version": 7, "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==",
- "certFileName": "Cert File Name value"
+ "certFileName": "Cert File Name value",
+ "deploymentChannel": "userChannel"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 1310
+Content-Length: 1349
{ "@odata.type": "#microsoft.graph.macOSTrustedRootCertificate",
Content-Length: 1310
"displayName": "Display Name value", "version": 7, "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==",
- "certFileName": "Cert File Name value"
+ "certFileName": "Cert File Name value",
+ "deploymentChannel": "userChannel"
}
-```
+```
v1.0 Intune Deviceconfig Macostrustedrootcertificate Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macostrustedrootcertificate-delete.md
DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Deviceconfig Macostrustedrootcertificate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macostrustedrootcertificate-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1397
+Content-Length: 1438
{ "value": {
Content-Length: 1397
"displayName": "Display Name value", "version": 7, "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==",
- "certFileName": "Cert File Name value"
+ "certFileName": "Cert File Name value",
+ "deploymentChannel": "userChannel"
} }
-```
+```
v1.0 Intune Deviceconfig Macostrustedrootcertificate List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macostrustedrootcertificate-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1479
+Content-Length: 1522
{ "value": [
Content-Length: 1479
"displayName": "Display Name value", "version": 7, "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==",
- "certFileName": "Cert File Name value"
+ "certFileName": "Cert File Name value",
+ "deploymentChannel": "userChannel"
} ] }
-```
+```
v1.0 Intune Deviceconfig Macostrustedrootcertificate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macostrustedrootcertificate-update.md
The following table shows the properties that are required when you create the [
|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |trustedRootCertificate|Binary|Trusted Root Certificate.| |certFileName|String|File name to display in UI.|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.macOSWiredNetworkConfiguration/rootCertificateForServerValidation Content-type: application/json
-Content-length: 1138
+Content-length: 1177
{ "@odata.type": "#microsoft.graph.macOSTrustedRootCertificate",
Content-length: 1138
"displayName": "Display Name value", "version": 7, "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==",
- "certFileName": "Cert File Name value"
+ "certFileName": "Cert File Name value",
+ "deploymentChannel": "userChannel"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1310
+Content-Length: 1349
{ "@odata.type": "#microsoft.graph.macOSTrustedRootCertificate",
Content-Length: 1310
"displayName": "Display Name value", "version": 7, "trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==",
- "certFileName": "Cert File Name value"
+ "certFileName": "Cert File Name value",
+ "deploymentChannel": "userChannel"
}
-```
+```
v1.0 Intune Deviceconfig Macosvpnconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosvpnconfiguration-create.md
The following table shows the properties that are required when you create the m
|disconnectOnIdleTimerInSeconds|Int32|The length of time in seconds to wait before disconnecting an on-demand connection. Valid values 0 to 65535 Inherited from [appleVpnConfiguration](../resources/intune-deviceconfig-applevpnconfiguration.md)| |proxyServer|[vpnProxyServer](../resources/intune-deviceconfig-vpnproxyserver.md)|Proxy Server. Inherited from [appleVpnConfiguration](../resources/intune-deviceconfig-applevpnconfiguration.md)| |optInToDeviceIdSharing|Boolean|Opt-In to sharing the device's Id to third-party vpn clients for use during network access control validation. Inherited from [appleVpnConfiguration](../resources/intune-deviceconfig-applevpnconfiguration.md)|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations Content-type: application/json
-Content-length: 3022
+Content-length: 3061
{ "@odata.type": "#microsoft.graph.macOSVpnConfiguration",
Content-length: 3022
"address": "Address value", "port": 4 },
- "optInToDeviceIdSharing": true
+ "optInToDeviceIdSharing": true,
+ "deploymentChannel": "userChannel"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 3194
+Content-Length: 3233
{ "@odata.type": "#microsoft.graph.macOSVpnConfiguration",
Content-Length: 3194
"address": "Address value", "port": 4 },
- "optInToDeviceIdSharing": true
+ "optInToDeviceIdSharing": true,
+ "deploymentChannel": "userChannel"
} ```
v1.0 Intune Deviceconfig Macosvpnconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosvpnconfiguration-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 3419
+Content-Length: 3460
{ "value": {
Content-Length: 3419
"address": "Address value", "port": 4 },
- "optInToDeviceIdSharing": true
+ "optInToDeviceIdSharing": true,
+ "deploymentChannel": "userChannel"
} } ```
v1.0 Intune Deviceconfig Macosvpnconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosvpnconfiguration-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 3639
+Content-Length: 3682
{ "value": [
Content-Length: 3639
"address": "Address value", "port": 4 },
- "optInToDeviceIdSharing": true
+ "optInToDeviceIdSharing": true,
+ "deploymentChannel": "userChannel"
} ] }
v1.0 Intune Deviceconfig Macosvpnconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macosvpnconfiguration-update.md
The following table shows the properties that are required when you create the [
|disconnectOnIdleTimerInSeconds|Int32|The length of time in seconds to wait before disconnecting an on-demand connection. Valid values 0 to 65535 Inherited from [appleVpnConfiguration](../resources/intune-deviceconfig-applevpnconfiguration.md)| |proxyServer|[vpnProxyServer](../resources/intune-deviceconfig-vpnproxyserver.md)|Proxy Server. Inherited from [appleVpnConfiguration](../resources/intune-deviceconfig-applevpnconfiguration.md)| |optInToDeviceIdSharing|Boolean|Opt-In to sharing the device's Id to third-party vpn clients for use during network access control validation. Inherited from [appleVpnConfiguration](../resources/intune-deviceconfig-applevpnconfiguration.md)|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId} Content-type: application/json
-Content-length: 3022
+Content-length: 3061
{ "@odata.type": "#microsoft.graph.macOSVpnConfiguration",
Content-length: 3022
"address": "Address value", "port": 4 },
- "optInToDeviceIdSharing": true
+ "optInToDeviceIdSharing": true,
+ "deploymentChannel": "userChannel"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 3194
+Content-Length: 3233
{ "@odata.type": "#microsoft.graph.macOSVpnConfiguration",
Content-Length: 3194
"address": "Address value", "port": 4 },
- "optInToDeviceIdSharing": true
+ "optInToDeviceIdSharing": true,
+ "deploymentChannel": "userChannel"
} ```
v1.0 Intune Deviceconfig Macoswificonfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macoswificonfiguration-create.md
The following table shows the properties that are required when you create the m
|proxyManualAddress|String|IP Address or DNS hostname of the proxy server when manual configuration is selected.| |proxyManualPort|Int32|Port of the proxy server when manual configuration is selected.| |proxyAutomaticConfigurationUrl|String|URL of the proxy server automatic configuration script when automatic configuration is selected. This URL is typically the location of PAC (Proxy Auto Configuration) file.|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
|preSharedKey|String|This is the pre-shared key for WPA Personal Wi-Fi network.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations Content-type: application/json
-Content-length: 1450
+Content-length: 1489
{ "@odata.type": "#microsoft.graph.macOSWiFiConfiguration",
Content-length: 1450
"proxyManualAddress": "Proxy Manual Address value", "proxyManualPort": 15, "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
+ "deploymentChannel": "userChannel",
"preSharedKey": "Pre Shared Key value" } ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 1622
+Content-Length: 1661
{ "@odata.type": "#microsoft.graph.macOSWiFiConfiguration",
Content-Length: 1622
"proxyManualAddress": "Proxy Manual Address value", "proxyManualPort": 15, "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
+ "deploymentChannel": "userChannel",
"preSharedKey": "Pre Shared Key value" } ```
v1.0 Intune Deviceconfig Macoswificonfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macoswificonfiguration-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1725
+Content-Length: 1766
{ "value": {
Content-Length: 1725
"proxyManualAddress": "Proxy Manual Address value", "proxyManualPort": 15, "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
+ "deploymentChannel": "userChannel",
"preSharedKey": "Pre Shared Key value" } }
v1.0 Intune Deviceconfig Macoswificonfiguration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macoswificonfiguration-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1823
+Content-Length: 1866
{ "value": [
Content-Length: 1823
"proxyManualAddress": "Proxy Manual Address value", "proxyManualPort": 15, "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
+ "deploymentChannel": "userChannel",
"preSharedKey": "Pre Shared Key value" } ]
v1.0 Intune Deviceconfig Macoswificonfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macoswificonfiguration-update.md
The following table shows the properties that are required when you create the [
|proxyManualAddress|String|IP Address or DNS hostname of the proxy server when manual configuration is selected.| |proxyManualPort|Int32|Port of the proxy server when manual configuration is selected.| |proxyAutomaticConfigurationUrl|String|URL of the proxy server automatic configuration script when automatic configuration is selected. This URL is typically the location of PAC (Proxy Auto Configuration) file.|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
|preSharedKey|String|This is the pre-shared key for WPA Personal Wi-Fi network.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId} Content-type: application/json
-Content-length: 1450
+Content-length: 1489
{ "@odata.type": "#microsoft.graph.macOSWiFiConfiguration",
Content-length: 1450
"proxyManualAddress": "Proxy Manual Address value", "proxyManualPort": 15, "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
+ "deploymentChannel": "userChannel",
"preSharedKey": "Pre Shared Key value" } ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1622
+Content-Length: 1661
{ "@odata.type": "#microsoft.graph.macOSWiFiConfiguration",
Content-Length: 1622
"proxyManualAddress": "Proxy Manual Address value", "proxyManualPort": 15, "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
+ "deploymentChannel": "userChannel",
"preSharedKey": "Pre Shared Key value" } ```
v1.0 Intune Deviceconfig Macoswirednetworkconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macoswirednetworkconfiguration-create.md
The following table shows the properties that are required when you create the m
|authenticationMethod|[wiFiAuthenticationMethod](../resources/intune-deviceconfig-wifiauthenticationmethod.md)|Authentication Method when EAP Type is configured to PEAP or EAP-TTLS. Possible values are: `certificate`, `usernameAndPassword`, `derivedCredential`.| |nonEapAuthenticationMethodForEapTtls|[nonEapAuthenticationMethodForEapTtlsType](../resources/intune-deviceconfig-noneapauthenticationmethodforeapttlstype.md)|Non-EAP Method for Authentication (Inner Identity) when EAP Type is EAP-TTLS and Authenticationmethod is Username and Password. Possible values are: `unencryptedPassword`, `challengeHandshakeAuthenticationProtocol`, `microsoftChap`, `microsoftChapVersionTwo`.| |enableOuterIdentityPrivacy|String|Enable identity privacy (Outer Identity) when EAP Type is configured to EAP-TTLS, EAP-FAST or PEAP. This property masks usernames with the text you enter. For example, if you use 'anonymous', each user that authenticates with this wired network using their real username is displayed as 'anonymous'.|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations Content-type: application/json
-Content-length: 1499
+Content-length: 1538
{ "@odata.type": "#microsoft.graph.macOSWiredNetworkConfiguration",
Content-length: 1499
], "authenticationMethod": "usernameAndPassword", "nonEapAuthenticationMethodForEapTtls": "challengeHandshakeAuthenticationProtocol",
- "enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value"
+ "enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value",
+ "deploymentChannel": "userChannel"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 1671
+Content-Length: 1710
{ "@odata.type": "#microsoft.graph.macOSWiredNetworkConfiguration",
Content-Length: 1671
], "authenticationMethod": "usernameAndPassword", "nonEapAuthenticationMethodForEapTtls": "challengeHandshakeAuthenticationProtocol",
- "enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value"
+ "enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value",
+ "deploymentChannel": "userChannel"
} ```
v1.0 Intune Deviceconfig Macoswirednetworkconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macoswirednetworkconfiguration-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1774
+Content-Length: 1815
{ "value": {
Content-Length: 1774
], "authenticationMethod": "usernameAndPassword", "nonEapAuthenticationMethodForEapTtls": "challengeHandshakeAuthenticationProtocol",
- "enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value"
+ "enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value",
+ "deploymentChannel": "userChannel"
} } ```
v1.0 Intune Deviceconfig Macoswirednetworkconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macoswirednetworkconfiguration-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1872
+Content-Length: 1915
{ "value": [
Content-Length: 1872
], "authenticationMethod": "usernameAndPassword", "nonEapAuthenticationMethodForEapTtls": "challengeHandshakeAuthenticationProtocol",
- "enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value"
+ "enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value",
+ "deploymentChannel": "userChannel"
} ] }
v1.0 Intune Deviceconfig Macoswirednetworkconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-macoswirednetworkconfiguration-update.md
The following table shows the properties that are required when you create the [
|authenticationMethod|[wiFiAuthenticationMethod](../resources/intune-deviceconfig-wifiauthenticationmethod.md)|Authentication Method when EAP Type is configured to PEAP or EAP-TTLS. Possible values are: `certificate`, `usernameAndPassword`, `derivedCredential`.| |nonEapAuthenticationMethodForEapTtls|[nonEapAuthenticationMethodForEapTtlsType](../resources/intune-deviceconfig-noneapauthenticationmethodforeapttlstype.md)|Non-EAP Method for Authentication (Inner Identity) when EAP Type is EAP-TTLS and Authenticationmethod is Username and Password. Possible values are: `unencryptedPassword`, `challengeHandshakeAuthenticationProtocol`, `microsoftChap`, `microsoftChapVersionTwo`.| |enableOuterIdentityPrivacy|String|Enable identity privacy (Outer Identity) when EAP Type is configured to EAP-TTLS, EAP-FAST or PEAP. This property masks usernames with the text you enter. For example, if you use 'anonymous', each user that authenticates with this wired network using their real username is displayed as 'anonymous'.|
+|deploymentChannel|[appleDeploymentChannel](../resources/intune-deviceconfig-appledeploymentchannel.md)|Indicates the deployment channel type used to deploy the configuration profile. Possible values are deviceChannel, userChannel. Possible values are: `deviceChannel`, `userChannel`, `unknownFutureValue`.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId} Content-type: application/json
-Content-length: 1499
+Content-length: 1538
{ "@odata.type": "#microsoft.graph.macOSWiredNetworkConfiguration",
Content-length: 1499
], "authenticationMethod": "usernameAndPassword", "nonEapAuthenticationMethodForEapTtls": "challengeHandshakeAuthenticationProtocol",
- "enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value"
+ "enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value",
+ "deploymentChannel": "userChannel"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1671
+Content-Length: 1710
{ "@odata.type": "#microsoft.graph.macOSWiredNetworkConfiguration",
Content-Length: 1671
], "authenticationMethod": "usernameAndPassword", "nonEapAuthenticationMethodForEapTtls": "challengeHandshakeAuthenticationProtocol",
- "enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value"
+ "enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value",
+ "deploymentChannel": "userChannel"
} ```
v1.0 Intune Deviceconfig Managedalldevicecertificatestate Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-managedalldevicecertificatestate-create.md
The following table shows the properties that are required when you create the m
|Property|Type|Description| |:|:|:| |id|String|Key of the entity.|
-|certificateRevokeStatus|[certificateRevocationStatus](../resources/intune-shared-certificaterevocationstatus.md)|Revoke status. Possible values are: `none`, `pending`, `issued`, `failed`, `revoked`.|
+|certificateRevokeStatus|[certificateRevocationStatus](../resources/intune-deviceconfig-certificaterevocationstatus.md)|Revoke status. Possible values are: `none`, `pending`, `issued`, `failed`, `revoked`.|
|certificateRevokeStatusLastChangeDateTime|DateTimeOffset|The time the revoke status was last changed| |managedDeviceDisplayName|String|Device display name| |userPrincipalName|String|User principal name|
v1.0 Intune Deviceconfig Managedalldevicecertificatestate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-managedalldevicecertificatestate-update.md
The following table shows the properties that are required when you create the [
|Property|Type|Description| |:|:|:| |id|String|Key of the entity.|
-|certificateRevokeStatus|[certificateRevocationStatus](../resources/intune-shared-certificaterevocationstatus.md)|Revoke status. Possible values are: `none`, `pending`, `issued`, `failed`, `revoked`.|
+|certificateRevokeStatus|[certificateRevocationStatus](../resources/intune-deviceconfig-certificaterevocationstatus.md)|Revoke status. Possible values are: `none`, `pending`, `issued`, `failed`, `revoked`.|
|certificateRevokeStatusLastChangeDateTime|DateTimeOffset|The time the revoke status was last changed| |managedDeviceDisplayName|String|Device display name| |userPrincipalName|String|User principal name|
v1.0 Intune Deviceconfig Manageddevicecertificatestate Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-manageddevicecertificatestate-create.md
The following table shows the properties that are required when you create the m
|devicePlatform|[devicePlatformType](../resources/intune-deviceconfig-deviceplatformtype.md)|Device platform. Possible values are: `android`, `androidForWork`, `iOS`, `macOS`, `windowsPhone81`, `windows81AndLater`, `windows10AndLater`, `androidWorkProfile`, `unknown`, `androidAOSP`, `androidMobileApplicationManagement`, `iOSMobileApplicationManagement`, `unknownFutureValue`, `windowsMobileApplicationManagement`.| |certificateKeyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|Key usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |certificateValidityPeriodUnits|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Validity period units. Possible values are: `days`, `months`, `years`.|
-|certificateIssuanceState|[certificateIssuanceStates](../resources/intune-shared-certificateissuancestates.md)|Issuance State. Possible values are: `unknown`, `challengeIssued`, `challengeIssueFailed`, `requestCreationFailed`, `requestSubmitFailed`, `challengeValidationSucceeded`, `challengeValidationFailed`, `issueFailed`, `issuePending`, `issued`, `responseProcessingFailed`, `responsePending`, `enrollmentSucceeded`, `enrollmentNotNeeded`, `revoked`, `removedFromCollection`, `renewVerified`, `installFailed`, `installed`, `deleteFailed`, `deleted`, `renewalRequested`, `requested`.|
+|certificateIssuanceState|[certificateIssuanceStates](../resources/intune-deviceconfig-certificateissuancestates.md)|Issuance State. Possible values are: `unknown`, `challengeIssued`, `challengeIssueFailed`, `requestCreationFailed`, `requestSubmitFailed`, `challengeValidationSucceeded`, `challengeValidationFailed`, `issueFailed`, `issuePending`, `issued`, `responseProcessingFailed`, `responsePending`, `enrollmentSucceeded`, `enrollmentNotNeeded`, `revoked`, `removedFromCollection`, `renewVerified`, `installFailed`, `installed`, `deleteFailed`, `deleted`, `renewalRequested`, `requested`.|
|certificateKeyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider. Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
-|certificateSubjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Subject name format. Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|certificateSubjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Subject name format. Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateSubjectAlternativeNameFormat|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Subject alternative name format. Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.|
-|certificateRevokeStatus|[certificateRevocationStatus](../resources/intune-shared-certificaterevocationstatus.md)|Revoke status. Possible values are: `none`, `pending`, `issued`, `failed`, `revoked`.|
+|certificateRevokeStatus|[certificateRevocationStatus](../resources/intune-deviceconfig-certificaterevocationstatus.md)|Revoke status. Possible values are: `none`, `pending`, `issued`, `failed`, `revoked`.|
|certificateProfileDisplayName|String|Certificate profile display name| |deviceDisplayName|String|Device display name| |userDisplayName|String|User display name|
Content-Length: 1566
"certificateIssuanceDateTime": "2016-12-31T23:59:41.5044473-08:00", "certificateErrorCode": 4 }
-```
+```
v1.0 Intune Deviceconfig Manageddevicecertificatestate Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-manageddevicecertificatestate-delete.md
DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Deviceconfig Manageddevicecertificatestate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-manageddevicecertificatestate-get.md
Content-Length: 1637
"certificateErrorCode": 4 } }
-```
+```
v1.0 Intune Deviceconfig Manageddevicecertificatestate List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-manageddevicecertificatestate-list.md
Content-Length: 1703
} ] }
-```
+```
v1.0 Intune Deviceconfig Manageddevicecertificatestate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-manageddevicecertificatestate-update.md
The following table shows the properties that are required when you create the [
|devicePlatform|[devicePlatformType](../resources/intune-deviceconfig-deviceplatformtype.md)|Device platform. Possible values are: `android`, `androidForWork`, `iOS`, `macOS`, `windowsPhone81`, `windows81AndLater`, `windows10AndLater`, `androidWorkProfile`, `unknown`, `androidAOSP`, `androidMobileApplicationManagement`, `iOSMobileApplicationManagement`, `unknownFutureValue`, `windowsMobileApplicationManagement`.| |certificateKeyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|Key usage. Possible values are: `keyEncipherment`, `digitalSignature`.| |certificateValidityPeriodUnits|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Validity period units. Possible values are: `days`, `months`, `years`.|
-|certificateIssuanceState|[certificateIssuanceStates](../resources/intune-shared-certificateissuancestates.md)|Issuance State. Possible values are: `unknown`, `challengeIssued`, `challengeIssueFailed`, `requestCreationFailed`, `requestSubmitFailed`, `challengeValidationSucceeded`, `challengeValidationFailed`, `issueFailed`, `issuePending`, `issued`, `responseProcessingFailed`, `responsePending`, `enrollmentSucceeded`, `enrollmentNotNeeded`, `revoked`, `removedFromCollection`, `renewVerified`, `installFailed`, `installed`, `deleteFailed`, `deleted`, `renewalRequested`, `requested`.|
+|certificateIssuanceState|[certificateIssuanceStates](../resources/intune-deviceconfig-certificateissuancestates.md)|Issuance State. Possible values are: `unknown`, `challengeIssued`, `challengeIssueFailed`, `requestCreationFailed`, `requestSubmitFailed`, `challengeValidationSucceeded`, `challengeValidationFailed`, `issueFailed`, `issuePending`, `issued`, `responseProcessingFailed`, `responsePending`, `enrollmentSucceeded`, `enrollmentNotNeeded`, `revoked`, `removedFromCollection`, `renewVerified`, `installFailed`, `installed`, `deleteFailed`, `deleted`, `renewalRequested`, `requested`.|
|certificateKeyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider. Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
-|certificateSubjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Subject name format. Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|certificateSubjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Subject name format. Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|certificateSubjectAlternativeNameFormat|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Subject alternative name format. Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.|
-|certificateRevokeStatus|[certificateRevocationStatus](../resources/intune-shared-certificaterevocationstatus.md)|Revoke status. Possible values are: `none`, `pending`, `issued`, `failed`, `revoked`.|
+|certificateRevokeStatus|[certificateRevocationStatus](../resources/intune-deviceconfig-certificaterevocationstatus.md)|Revoke status. Possible values are: `none`, `pending`, `issued`, `failed`, `revoked`.|
|certificateProfileDisplayName|String|Certificate profile display name| |deviceDisplayName|String|Device display name| |userDisplayName|String|User display name|
Content-Length: 1566
"certificateIssuanceDateTime": "2016-12-31T23:59:41.5044473-08:00", "certificateErrorCode": 4 }
-```
+```
v1.0 Intune Deviceconfig Reportroot Deviceconfigurationdeviceactivity https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-reportroot-deviceconfigurationdeviceactivity.md
GET /reports/deviceConfigurationDeviceActivity
Do not supply a request body for this method. ## Response
-If successful, this function returns a `200 OK` response code and a [report](../resources/intune-shared-report.md) in the response body.
+If successful, this function returns a `200 OK` response code and a [report](../resources/intune-deviceconfig-report.md) in the response body.
## Example
v1.0 Intune Deviceconfig Reportroot Deviceconfigurationuseractivity https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-reportroot-deviceconfigurationuseractivity.md
GET /reports/deviceConfigurationUserActivity
Do not supply a request body for this method. ## Response
-If successful, this function returns a `200 OK` response code and a [report](../resources/intune-shared-report.md) in the response body.
+If successful, this function returns a `200 OK` response code and a [report](../resources/intune-deviceconfig-report.md) in the response body.
## Example
v1.0 Intune Deviceconfig Reportroot Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-reportroot-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [reportRoot](../resources/intune-shared-reportroot.md) object.
+Read properties and relationships of the [reportRoot](../resources/intune-deviceconfig-reportroot.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [reportRoot](../resources/intune-shared-reportroot.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [reportRoot](../resources/intune-deviceconfig-reportroot.md) object in the response body.
## Example
v1.0 Intune Deviceconfig Reportroot Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-reportroot-update.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Update the properties of a [reportRoot](../resources/intune-shared-reportroot.md) object.
+Update the properties of a [reportRoot](../resources/intune-deviceconfig-reportroot.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /reports
|Accept|application/json| ## Request body
-In the request body, supply a JSON representation for the [reportRoot](../resources/intune-shared-reportroot.md) object.
+In the request body, supply a JSON representation for the [reportRoot](../resources/intune-deviceconfig-reportroot.md) object.
-The following table shows the properties that are required when you create the [reportRoot](../resources/intune-shared-reportroot.md).
+The following table shows the properties that are required when you create the [reportRoot](../resources/intune-deviceconfig-reportroot.md).
|Property|Type|Description| |:|:|:|
The following table shows the properties that are required when you create the [
## Response
-If successful, this method returns a `200 OK` response code and an updated [reportRoot](../resources/intune-shared-reportroot.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an updated [reportRoot](../resources/intune-deviceconfig-reportroot.md) object in the response body.
## Example
v1.0 Intune Deviceconfig Softwareupdatestatussummary Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-softwareupdatestatussummary-update.md
Content-Length: 567
"conflictUserCount": 1, "notApplicableUserCount": 6 }
-```
+```
v1.0 Intune Deviceconfig Windows10importedpfxcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows10importedpfxcertificateprofile-create.md
The following table shows the properties that are required when you create the w
|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider (KSP) Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
v1.0 Intune Deviceconfig Windows10importedpfxcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows10importedpfxcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider (KSP) Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
v1.0 Intune Deviceconfig Windows10pkcscertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows10pkcscertificateprofile-create.md
The following table shows the properties that are required when you create the w
|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider (KSP) Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
The following table shows the properties that are required when you create the w
|certificationAuthorityName|String|PKCS Certification Authority Name| |certificateTemplateName|String|PKCS Certificate Template Name| |subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.|
|subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements.|
v1.0 Intune Deviceconfig Windows10pkcscertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows10pkcscertificateprofile-update.md
The following table shows the properties that are required when you create the [
|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider (KSP) Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
The following table shows the properties that are required when you create the [
|certificationAuthorityName|String|PKCS Certification Authority Name| |certificateTemplateName|String|PKCS Certificate Template Name| |subjectAlternativeNameFormatString|String|Custom String that defines the AAD Attribute.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements.|
|subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |certificateStore|[certificateStore](../resources/intune-shared-certificatestore.md)|Target store certificate. Possible values are: `user`, `machine`.| |customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements.|
v1.0 Intune Deviceconfig Windows10vpnconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows10vpnconfiguration-create.md
The following table shows the properties that are required when you create the w
|rememberUserCredentials|Boolean|Remember user credentials.| |enableConditionalAccess|Boolean|Enable conditional access.| |enableSingleSignOnWithAlternateCertificate|Boolean|Enable single sign-on (SSO) with alternate certificate.|
-|singleSignOnEku|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md)|Single sign-on Extended Key Usage (EKU).|
+|singleSignOnEku|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md)|Single sign-on Extended Key Usage (EKU).|
|singleSignOnIssuerHash|String|Single sign-on issuer hash.| |eapXml|Binary|Extensible Authentication Protocol (EAP) XML. (UTF8 encoded byte array)| |proxyServer|[windows10VpnProxyServer](../resources/intune-deviceconfig-windows10vpnproxyserver.md)|Proxy Server.|
v1.0 Intune Deviceconfig Windows10vpnconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows10vpnconfiguration-update.md
The following table shows the properties that are required when you create the [
|rememberUserCredentials|Boolean|Remember user credentials.| |enableConditionalAccess|Boolean|Enable conditional access.| |enableSingleSignOnWithAlternateCertificate|Boolean|Enable single sign-on (SSO) with alternate certificate.|
-|singleSignOnEku|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md)|Single sign-on Extended Key Usage (EKU).|
+|singleSignOnEku|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md)|Single sign-on Extended Key Usage (EKU).|
|singleSignOnIssuerHash|String|Single sign-on issuer hash.| |eapXml|Binary|Extensible Authentication Protocol (EAP) XML. (UTF8 encoded byte array)| |proxyServer|[windows10VpnProxyServer](../resources/intune-deviceconfig-windows10vpnproxyserver.md)|Proxy Server.|
v1.0 Intune Deviceconfig Windows81scepcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81scepcertificateprofile-create.md
The following table shows the properties that are required when you create the w
|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider (KSP) Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)|
|customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)| |scepServerUrls|String collection|SCEP Server Url(s).| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US|
v1.0 Intune Deviceconfig Windows81scepcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81scepcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider (KSP) Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)|
|customSubjectAlternativeNames|[customSubjectAlternativeName](../resources/intune-deviceconfig-customsubjectalternativename.md) collection|Custom Subject Alternative Name Settings. This collection can contain a maximum of 500 elements. Inherited from [windows81CertificateProfileBase](../resources/intune-deviceconfig-windows81certificateprofilebase.md)| |scepServerUrls|String collection|SCEP Server Url(s).| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US|
v1.0 Intune Deviceconfig Windows81trustedrootcertificate Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81trustedrootcertificate-create.md
Content-Length: 1370
"certFileName": "Cert File Name value", "destinationStore": "computerCertStoreIntermediate" }
-```
+```
v1.0 Intune Deviceconfig Windows81trustedrootcertificate Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81trustedrootcertificate-delete.md
DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Deviceconfig Windows81trustedrootcertificate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81trustedrootcertificate-get.md
Content-Length: 1459
"destinationStore": "computerCertStoreIntermediate" } }
-```
+```
v1.0 Intune Deviceconfig Windows81trustedrootcertificate List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81trustedrootcertificate-list.md
Content-Length: 1543
} ] }
-```
+```
v1.0 Intune Deviceconfig Windows81trustedrootcertificate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windows81trustedrootcertificate-update.md
Content-Length: 1370
"certFileName": "Cert File Name value", "destinationStore": "computerCertStoreIntermediate" }
-```
+```
v1.0 Intune Deviceconfig Windowscertificateprofilebase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowscertificateprofilebase-get.md
Content-Length: 1576
"certificateValidityPeriodScale": "months" } }
-```
+```
v1.0 Intune Deviceconfig Windowsdomainjoinconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsdomainjoinconfiguration-create.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Create a new [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object.
+Create a new [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
The following table shows the properties that are required when you create the w
|Property|Type|Description| |:|:|:|
-|id|String|Key of the entity. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|lastModifiedDateTime|DateTimeOffset|DateTime the object was last modified. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|supportsScopeTags|Boolean|Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. This property is read-only. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|deviceManagementApplicabilityRuleOsEdition|[deviceManagementApplicabilityRuleOsEdition](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosedition.md)|The OS edition applicability for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|deviceManagementApplicabilityRuleOsVersion|[deviceManagementApplicabilityRuleOsVersion](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosversion.md)|The OS version applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|deviceManagementApplicabilityRuleDeviceMode|[deviceManagementApplicabilityRuleDeviceMode](../resources/intune-deviceconfig-devicemanagementapplicabilityruledevicemode.md)|The device mode applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|createdDateTime|DateTimeOffset|DateTime the object was created. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|description|String|Admin provided description of the Device Configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
+|id|String|Key of the entity. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|lastModifiedDateTime|DateTimeOffset|DateTime the object was last modified. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|supportsScopeTags|Boolean|Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. This property is read-only. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|deviceManagementApplicabilityRuleOsEdition|[deviceManagementApplicabilityRuleOsEdition](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosedition.md)|The OS edition applicability for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|deviceManagementApplicabilityRuleOsVersion|[deviceManagementApplicabilityRuleOsVersion](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosversion.md)|The OS version applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|deviceManagementApplicabilityRuleDeviceMode|[deviceManagementApplicabilityRuleDeviceMode](../resources/intune-deviceconfig-devicemanagementapplicabilityruledevicemode.md)|The device mode applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|createdDateTime|DateTimeOffset|DateTime the object was created. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|description|String|Admin provided description of the Device Configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
|computerNameStaticPrefix|String|Fixed prefix to be used for computer name.| |computerNameSuffixRandomCharCount|Int32|Dynamically generated characters used as suffix for computer name. Valid values 3 to 14| |activeDirectoryDomainName|String|Active Directory domain name to join.|
The following table shows the properties that are required when you create the w
## Response
-If successful, this method returns a `201 Created` response code and a [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object in the response body.
+If successful, this method returns a `201 Created` response code and a [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object in the response body.
## Example
v1.0 Intune Deviceconfig Windowsdomainjoinconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsdomainjoinconfiguration-delete.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Deletes a [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md).
+Deletes a [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md).
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
v1.0 Intune Deviceconfig Windowsdomainjoinconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsdomainjoinconfiguration-get.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Read properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object.
+Read properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object in the response body.
+If successful, this method returns a `200 OK` response code and [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object in the response body.
## Example
v1.0 Intune Deviceconfig Windowsdomainjoinconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsdomainjoinconfiguration-list.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-List properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) objects.
+List properties and relationships of the [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) objects.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
GET /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.gra
Do not supply a request body for this method. ## Response
-If successful, this method returns a `200 OK` response code and a collection of [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) objects in the response body.
## Example
v1.0 Intune Deviceconfig Windowsdomainjoinconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsdomainjoinconfiguration-update.md
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Update the properties of a [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object.
+Update the properties of a [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.g
|Accept|application/json| ## Request body
-In the request body, supply a JSON representation for the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object.
+In the request body, supply a JSON representation for the [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object.
-The following table shows the properties that are required when you create the [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md).
+The following table shows the properties that are required when you create the [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md).
|Property|Type|Description| |:|:|:|
-|id|String|Key of the entity. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|lastModifiedDateTime|DateTimeOffset|DateTime the object was last modified. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|supportsScopeTags|Boolean|Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. This property is read-only. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|deviceManagementApplicabilityRuleOsEdition|[deviceManagementApplicabilityRuleOsEdition](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosedition.md)|The OS edition applicability for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|deviceManagementApplicabilityRuleOsVersion|[deviceManagementApplicabilityRuleOsVersion](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosversion.md)|The OS version applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|deviceManagementApplicabilityRuleDeviceMode|[deviceManagementApplicabilityRuleDeviceMode](../resources/intune-deviceconfig-devicemanagementapplicabilityruledevicemode.md)|The device mode applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|createdDateTime|DateTimeOffset|DateTime the object was created. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|description|String|Admin provided description of the Device Configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
+|id|String|Key of the entity. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|lastModifiedDateTime|DateTimeOffset|DateTime the object was last modified. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|supportsScopeTags|Boolean|Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. This property is read-only. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|deviceManagementApplicabilityRuleOsEdition|[deviceManagementApplicabilityRuleOsEdition](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosedition.md)|The OS edition applicability for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|deviceManagementApplicabilityRuleOsVersion|[deviceManagementApplicabilityRuleOsVersion](../resources/intune-deviceconfig-devicemanagementapplicabilityruleosversion.md)|The OS version applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|deviceManagementApplicabilityRuleDeviceMode|[deviceManagementApplicabilityRuleDeviceMode](../resources/intune-deviceconfig-devicemanagementapplicabilityruledevicemode.md)|The device mode applicability rule for this Policy. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|createdDateTime|DateTimeOffset|DateTime the object was created. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|description|String|Admin provided description of the Device Configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
+|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-deviceconfig-deviceconfiguration.md)|
|computerNameStaticPrefix|String|Fixed prefix to be used for computer name.| |computerNameSuffixRandomCharCount|Int32|Dynamically generated characters used as suffix for computer name. Valid values 3 to 14| |activeDirectoryDomainName|String|Active Directory domain name to join.|
The following table shows the properties that are required when you create the [
## Response
-If successful, this method returns a `200 OK` response code and an updated [windowsDomainJoinConfiguration](../resources/intune-shared-windowsdomainjoinconfiguration.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an updated [windowsDomainJoinConfiguration](../resources/intune-deviceconfig-windowsdomainjoinconfiguration.md) object in the response body.
## Example
v1.0 Intune Deviceconfig Windowsphone81certificateprofilebase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81certificateprofilebase-get.md
Content-Length: 1783
] } }
-```
+```
v1.0 Intune Deviceconfig Windowsphone81importedpfxcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81importedpfxcertificateprofile-create.md
The following table shows the properties that are required when you create the w
|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider (KSP) Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
v1.0 Intune Deviceconfig Windowsphone81importedpfxcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81importedpfxcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Valid values 1 to 99 Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider (KSP) Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period Inherited from [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
v1.0 Intune Deviceconfig Windowsphone81scepcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81scepcertificateprofile-create.md
The following table shows the properties that are required when you create the w
|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)| |keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider (KSP). Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validtiy Period. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)|
|scepServerUrls|String collection|SCEP Server Url(s).| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.|
v1.0 Intune Deviceconfig Windowsphone81scepcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81scepcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |renewalThresholdPercentage|Int32|Certificate renewal threshold percentage. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)| |keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Key Storage Provider (KSP). Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
-|subjectNameFormat|[subjectNameFormat](../resources/intune-shared-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
+|subjectNameFormat|[subjectNameFormat](../resources/intune-deviceconfig-subjectnameformat.md)|Certificate Subject Name Format. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `commonName`, `commonNameIncludingEmail`, `commonNameAsEmail`, `custom`, `commonNameAsIMEI`, `commonNameAsSerialNumber`, `commonNameAsAadDeviceId`, `commonNameAsIntuneDeviceId`, `commonNameAsDurableDeviceId`.|
|subjectAlternativeNameType|[subjectAlternativeNameType](../resources/intune-shared-subjectalternativenametype.md)|Certificate Subject Alternative Name Type. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `none`, `emailAddress`, `userPrincipalName`, `customAzureADAttribute`, `domainNameService`, `universalResourceIdentifier`.| |certificateValidityPeriodValue|Int32|Value for the Certificate Validtiy Period. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)| |certificateValidityPeriodScale|[certificateValidityPeriodScale](../resources/intune-shared-certificatevalidityperiodscale.md)|Scale for the Certificate Validity Period. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md). Possible values are: `days`, `months`, `years`.|
-|extendedKeyUsages|[extendedKeyUsage](../resources/intune-shared-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)|
+|extendedKeyUsages|[extendedKeyUsage](../resources/intune-deviceconfig-extendedkeyusage.md) collection|Extended Key Usage (EKU) settings. This collection can contain a maximum of 500 elements. Inherited from [windowsPhone81CertificateProfileBase](../resources/intune-deviceconfig-windowsphone81certificateprofilebase.md)|
|scepServerUrls|String collection|SCEP Server Url(s).| |subjectNameFormatString|String|Custom format to use with SubjectNameFormat = Custom. Example: CN={{EmailAddress}},E={{EmailAddress}},OU=Enterprise Users,O=Contoso Corporation,L=Redmond,ST=WA,C=US| |keyUsage|[keyUsages](../resources/intune-shared-keyusages.md)|SCEP Key Usage. Possible values are: `keyEncipherment`, `digitalSignature`.|
v1.0 Intune Deviceconfig Windowsphone81trustedrootcertificate Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81trustedrootcertificate-delete.md
DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Deviceconfig Windowsphone81trustedrootcertificate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81trustedrootcertificate-get.md
Content-Length: 1406
"certFileName": "Cert File Name value" } }
-```
+```
v1.0 Intune Deviceconfig Windowsphone81trustedrootcertificate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsphone81trustedrootcertificate-update.md
Content-Length: 1319
"trustedRootCertificate": "dHJ1c3RlZFJvb3RDZXJ0aWZpY2F0ZQ==", "certFileName": "Cert File Name value" }
-```
+```
v1.0 Intune Deviceconfig Windowsprivacydataaccesscontrolitem Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsprivacydataaccesscontrolitem-create.md
Content-Length: 299
"appPackageFamilyName": "App Package Family Name value", "appDisplayName": "App Display Name value" }
-```
+```
v1.0 Intune Deviceconfig Windowsprivacydataaccesscontrolitem Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsprivacydataaccesscontrolitem-delete.md
DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{d
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Deviceconfig Windowsprivacydataaccesscontrolitem Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsprivacydataaccesscontrolitem-get.md
Content-Length: 330
"appDisplayName": "App Display Name value" } }
-```
+```
v1.0 Intune Deviceconfig Windowsprivacydataaccesscontrolitem List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsprivacydataaccesscontrolitem-list.md
Content-Length: 356
} ] }
-```
+```
v1.0 Intune Deviceconfig Windowsprivacydataaccesscontrolitem Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsprivacydataaccesscontrolitem-update.md
Content-Length: 299
"appPackageFamilyName": "App Package Family Name value", "appDisplayName": "App Display Name value" }
-```
+```
v1.0 Intune Deviceconfig Windowsupdateforbusinessconfiguration Extendfeatureupdatespause https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsupdateforbusinessconfiguration-extendfeatureupdatespause.md
POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{dev
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Deviceconfig Windowsupdateforbusinessconfiguration Extendqualityupdatespause https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfig-windowsupdateforbusinessconfiguration-extendqualityupdatespause.md
POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{dev
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 HTTP/1.1 204 No Content
-```
+```
v1.0 Intune Deviceconfigv2 Devicemanagementcompliancepolicy Assign https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementcompliancepolicy-assign.md
+
+ Title: "assign action"
+description: "Intune Deviceconfigv2 Devicemanagementcompliancepolicy Assign Api ."
+
+localization_priority: Normal
+++
+# assign action
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
++++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|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|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assign
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+In the request body, supply JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Property|Type|Description|
+|:|:|:|
+|assignments|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection||
+++
+## Response
+If successful, this action returns a `200 OK` response code and a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assign
+
+Content-type: application/json
+Content-length: 610
+
+{
+ "assignments": [
+ {
+ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment",
+ "id": "1f069921-9921-1f06-2199-061f2199061f",
+ "target": {
+ "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget",
+ "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value",
+ "deviceAndAppManagementAssignmentFilterType": "include",
+ "targetType": "user",
+ "entraObjectId": "Entra Object Id value"
+ },
+ "source": "policySets",
+ "sourceId": "Source Id value"
+ }
+ ]
+}
+```
+
+### 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
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 604
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment",
+ "id": "1f069921-9921-1f06-2199-061f2199061f",
+ "target": {
+ "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget",
+ "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value",
+ "deviceAndAppManagementAssignmentFilterType": "include",
+ "targetType": "user",
+ "entraObjectId": "Entra Object Id value"
+ },
+ "source": "policySets",
+ "sourceId": "Source Id value"
+ }
+ ]
+}
+```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assign https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-assign.md
+
+ Title: "assign action"
+description: "Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assign Api ."
+
+localization_priority: Normal
+++
+# assign action
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
++++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|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|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assign
+POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/assign
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+In the request body, supply JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Property|Type|Description|
+|:|:|:|
+|assignments|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection||
+++
+## Response
+If successful, this action returns a `200 OK` response code and a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assign
+
+Content-type: application/json
+Content-length: 610
+
+{
+ "assignments": [
+ {
+ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment",
+ "id": "1f069921-9921-1f06-2199-061f2199061f",
+ "target": {
+ "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget",
+ "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value",
+ "deviceAndAppManagementAssignmentFilterType": "include",
+ "targetType": "user",
+ "entraObjectId": "Entra Object Id value"
+ },
+ "source": "policySets",
+ "sourceId": "Source Id value"
+ }
+ ]
+}
+```
+
+### 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
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 604
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment",
+ "id": "1f069921-9921-1f06-2199-061f2199061f",
+ "target": {
+ "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget",
+ "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value",
+ "deviceAndAppManagementAssignmentFilterType": "include",
+ "targetType": "user",
+ "entraObjectId": "Entra Object Id value"
+ },
+ "source": "policySets",
+ "sourceId": "Source Id value"
+ }
+ ]
+}
+```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assignjustintimeconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-assignjustintimeconfiguration.md
+
+ Title: "assignJustInTimeConfiguration action"
+description: "Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assignjustintimeconfiguration Api ."
+
+localization_priority: Normal
+++
+# assignJustInTimeConfiguration action
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
++++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignJustInTimeConfiguration
+POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/assignJustInTimeConfiguration
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+In the request body, supply JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Property|Type|Description|
+|:|:|:|
+|justInTimeAssignments|[deviceManagementConfigurationJustInTimeAssignmentPolicy](../resources/intune-deviceconfigv2-devicemanagementconfigurationjustintimeassignmentpolicy.md)||
+++
+## Response
+If successful, this action returns a `200 OK` response code and a Boolean in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignJustInTimeConfiguration
+
+Content-type: application/json
+Content-length: 221
+
+{
+ "justInTimeAssignments": {
+ "@odata.type": "microsoft.graph.deviceManagementConfigurationJustInTimeAssignmentPolicy",
+ "targetType": "entraSecurityGroup",
+ "target": [
+ "Target value"
+ ]
+ }
+}
+```
+
+### 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
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 21
+
+{
+ "value": true
+}
+```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Clearenrollmenttimedevicemembershiptarget https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-clearenrollmenttimedevicemembershiptarget.md
+
+ Title: "clearEnrollmentTimeDeviceMembershipTarget action"
+description: "Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Clearenrollmenttimedevicemembershiptarget Api ."
+
+localization_priority: Normal
+++
+# clearEnrollmentTimeDeviceMembershipTarget action
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
++++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/clearEnrollmentTimeDeviceMembershipTarget
+POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/clearEnrollmentTimeDeviceMembershipTarget
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this action returns a `200 OK` response code and a Boolean in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/clearEnrollmentTimeDeviceMembershipTarget
+```
+
+### 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
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 21
+
+{
+ "value": true
+}
+```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Retrieveenrollmenttimedevicemembershiptarget https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-retrieveenrollmenttimedevicemembershiptarget.md
+
+ Title: "retrieveEnrollmentTimeDeviceMembershipTarget action"
+description: "Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Retrieveenrollmenttimedevicemembershiptarget Api ."
+
+localization_priority: Normal
+++
+# retrieveEnrollmentTimeDeviceMembershipTarget action
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
++++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/retrieveEnrollmentTimeDeviceMembershipTarget
+POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/retrieveEnrollmentTimeDeviceMembershipTarget
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this action returns a `200 OK` response code and a [enrollmentTimeDeviceMembershipTargetResult](../resources/intune-deviceconfigv2-enrollmenttimedevicemembershiptargetresult.md) in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/retrieveEnrollmentTimeDeviceMembershipTarget
+```
+
+### 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
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 455
+
+{
+ "value": {
+ "@odata.type": "microsoft.graph.enrollmentTimeDeviceMembershipTargetResult",
+ "validationSucceeded": true,
+ "enrollmentTimeDeviceMembershipTargetValidationStatuses": [
+ {
+ "@odata.type": "microsoft.graph.enrollmentTimeDeviceMembershipTargetStatus",
+ "targetId": "Target Id value",
+ "validationSucceeded": true,
+ "targetValidationErrorCode": "securityGroupNotFound"
+ }
+ ]
+ }
+}
+```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Setenrollmenttimedevicemembershiptarget https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-setenrollmenttimedevicemembershiptarget.md
+
+ Title: "setEnrollmentTimeDeviceMembershipTarget action"
+description: "Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Setenrollmenttimedevicemembershiptarget Api ."
+
+localization_priority: Normal
+++
+# setEnrollmentTimeDeviceMembershipTarget action
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
++++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/setEnrollmentTimeDeviceMembershipTarget
+POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/setEnrollmentTimeDeviceMembershipTarget
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+In the request body, supply JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Property|Type|Description|
+|:|:|:|
+|enrollmentTimeDeviceMembershipTargets|[enrollmentTimeDeviceMembershipTarget](../resources/intune-deviceconfigv2-enrollmenttimedevicemembershiptarget.md) collection||
+++
+## Response
+If successful, this action returns a `200 OK` response code and a [enrollmentTimeDeviceMembershipTargetResult](../resources/intune-deviceconfigv2-enrollmenttimedevicemembershiptargetresult.md) in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/setEnrollmentTimeDeviceMembershipTarget
+
+Content-type: application/json
+Content-length: 228
+
+{
+ "enrollmentTimeDeviceMembershipTargets": [
+ {
+ "@odata.type": "microsoft.graph.enrollmentTimeDeviceMembershipTarget",
+ "targetType": "staticSecurityGroup",
+ "targetId": "Target Id value"
+ }
+ ]
+}
+```
+
+### 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
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 455
+
+{
+ "value": {
+ "@odata.type": "microsoft.graph.enrollmentTimeDeviceMembershipTargetResult",
+ "validationSucceeded": true,
+ "enrollmentTimeDeviceMembershipTargetValidationStatuses": [
+ {
+ "@odata.type": "microsoft.graph.enrollmentTimeDeviceMembershipTargetStatus",
+ "targetId": "Target Id value",
+ "validationSucceeded": true,
+ "targetValidationErrorCode": "securityGroupNotFound"
+ }
+ ]
+ }
+}
+```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-create.md
+
+ Title: "Create deviceManagementConfigurationPolicyAssignment"
+description: "Create a new deviceManagementConfigurationPolicyAssignment object."
+
+localization_priority: Normal
+++
+# Create deviceManagementConfigurationPolicyAssignment
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Create a new [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object.
++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|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|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments
+POST /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments
+POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+In the request body, supply a JSON representation for the deviceManagementConfigurationPolicyAssignment object.
+
+The following table shows the properties that are required when you create the deviceManagementConfigurationPolicyAssignment.
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|The key of the assignment.|
+|target|[deviceAndAppManagementAssignmentTarget](../resources/intune-shared-deviceandappmanagementassignmenttarget.md)|The assignment target for the DeviceManagementConfigurationPolicy.|
+|source|[deviceAndAppManagementAssignmentSource](../resources/intune-shared-deviceandappmanagementassignmentsource.md)|The assignment source for the device compliance policy, direct or parcel/policySet. Possible values are: `direct`, `policySets`.|
+|sourceId|String|The identifier of the source of the assignment.|
+++
+## Response
+If successful, this method returns a `201 Created` response code and a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments
+Content-type: application/json
+Content-length: 478
+
+{
+ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment",
+ "target": {
+ "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget",
+ "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value",
+ "deviceAndAppManagementAssignmentFilterType": "include",
+ "targetType": "user",
+ "entraObjectId": "Entra Object Id value"
+ },
+ "source": "policySets",
+ "sourceId": "Source Id value"
+}
+```
+
+### 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
+HTTP/1.1 201 Created
+Content-Type: application/json
+Content-Length: 527
+
+{
+ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment",
+ "id": "1f069921-9921-1f06-2199-061f2199061f",
+ "target": {
+ "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget",
+ "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value",
+ "deviceAndAppManagementAssignmentFilterType": "include",
+ "targetType": "user",
+ "entraObjectId": "Entra Object Id value"
+ },
+ "source": "policySets",
+ "sourceId": "Source Id value"
+}
+```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-delete.md
+
+ Title: "Delete deviceManagementConfigurationPolicyAssignment"
+description: "Deletes a deviceManagementConfigurationPolicyAssignment."
+
+localization_priority: Normal
+++
+# Delete deviceManagementConfigurationPolicyAssignment
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Deletes a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md).
++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|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|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId}
+DELETE /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId}
+DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId}
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+DELETE https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId}
+```
+
+### 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
+HTTP/1.1 204 No Content
+```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-get.md
+
+ Title: "Get deviceManagementConfigurationPolicyAssignment"
+description: "Read properties and relationships of the deviceManagementConfigurationPolicyAssignment object."
+
+localization_priority: Normal
+++
+# Get deviceManagementConfigurationPolicyAssignment
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Read properties and relationships of the [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object.
++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId}
+GET /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId}
+GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId}
+```
+
+## Optional query parameters
+This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId}
+```
+
+### 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
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 568
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment",
+ "id": "1f069921-9921-1f06-2199-061f2199061f",
+ "target": {
+ "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget",
+ "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value",
+ "deviceAndAppManagementAssignmentFilterType": "include",
+ "targetType": "user",
+ "entraObjectId": "Entra Object Id value"
+ },
+ "source": "policySets",
+ "sourceId": "Source Id value"
+ }
+}
+```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-list.md
+
+ Title: "List deviceManagementConfigurationPolicyAssignments"
+description: "List properties and relationships of the deviceManagementConfigurationPolicyAssignment objects."
+
+localization_priority: Normal
+++
+# List deviceManagementConfigurationPolicyAssignments
+
+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](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+List properties and relationships of the [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) objects.
++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments
+GET /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments
+GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and a collection of [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) objects in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments
+```
+
+### 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
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 604
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment",
+ "id": "1f069921-9921-1f06-2199-061f2199061f",
+ "target&