Edits - minor edits, update dates

FaithOmbongi · web-flow · commit a2d42673ccaf · 2024-12-31T12:17:13.000+03:00
diff --git a/api-reference/beta/api/certificateauthoritypath-list-mutualtlsoauthconfigurations.md b/api-reference/beta/api/certificateauthoritypath-list-mutualtlsoauthconfigurations.md
@@ -2,7 +2,7 @@
 title: "List mutualTlsOauthConfigurations"
 description: "Get a list of the available mutualTlsOauthConfiguration resources."
 author: "sofia-geislinger"
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ms.localizationpriority: medium
 ms.subservice: "entra-id"
 doc_type: apiPageType
diff --git a/api-reference/beta/api/certificateauthoritypath-post-mutualtlsoauthconfigurations.md b/api-reference/beta/api/certificateauthoritypath-post-mutualtlsoauthconfigurations.md
@@ -2,7 +2,7 @@
 title: "Create mutualTlsOauthConfiguration"
 description: "Create a mutualTlsOauthConfiguration resource that contains a specified certificate authority object."
 author: "sofia-geislinger"
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ms.localizationpriority: medium
 ms.subservice: "entra-id"
 doc_type: apiPageType
diff --git a/api-reference/beta/api/device-update.md b/api-reference/beta/api/device-update.md
@@ -5,7 +5,7 @@ author: "sandeo-MSFT"
 ms.localizationpriority: medium
 ms.subservice: "entra-directory-management"
 doc_type: apiPageType
-ms.date: 10/25/2024
+ms.date: 12/31/2024
 ---
 
 # Update device
diff --git a/api-reference/beta/api/devicetemplate-createdevicefromtemplate.md b/api-reference/beta/api/devicetemplate-createdevicefromtemplate.md
@@ -2,7 +2,7 @@
 title: "deviceTemplate: createDeviceFromTemplate"
 description: "Create a new device from a device template."
 author: "atastrophic"
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ms.localizationpriority: medium
 ms.subservice: "entra-id"
 doc_type: apiPageType
diff --git a/api-reference/beta/api/devicetemplate-delete-owners.md b/api-reference/beta/api/devicetemplate-delete-owners.md
@@ -5,7 +5,7 @@ author: "sofia-geislinger"
 ms.localizationpriority: medium
 ms.subservice: "entra-id"
 doc_type: apiPageType
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ---
 
 # Remove deviceTemplate owner
@@ -30,7 +30,6 @@ Choose the permission or permissions marked as least privileged for this API. Us
 [!INCLUDE [permissions-table](../includes/permissions/devicetemplate-delete-owners-permissions.md)]
 
 [!INCLUDE [rbac-devicestemplate-apis](../includes/rbac-for-apis/rbac-devicetemplate-apis.md)]
-> **Note:** Users must be owner of the object.
 
 ## HTTP request
 
diff --git a/api-reference/beta/api/devicetemplate-delete.md b/api-reference/beta/api/devicetemplate-delete.md
@@ -2,7 +2,7 @@
 title: "Delete deviceTemplate"
 description: "Delete a registered deviceTemplate."
 author: "sofia-geislinger"
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ms.localizationpriority: medium
 ms.subservice: "entra-id"
 doc_type: apiPageType
@@ -28,7 +28,6 @@ Choose the permission or permissions marked as least privileged for this API. Us
 [!INCLUDE [permissions-table](../includes/permissions/devicetemplate-delete-permissions.md)]
 
 [!INCLUDE [rbac-devicestemplate-apis](../includes/rbac-for-apis/rbac-devicetemplate-apis.md)]
-> **Note:** Users must be owner of the object.
 
 ## HTTP request
 
diff --git a/api-reference/beta/api/devicetemplate-get.md b/api-reference/beta/api/devicetemplate-get.md
@@ -5,7 +5,7 @@ author: "sofia-geislinger"
 ms.localizationpriority: medium
 ms.subservice: "entra-id"
 doc_type: apiPageType
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ---
 
 # Get deviceTemplate
diff --git a/api-reference/beta/api/devicetemplate-list-owners.md b/api-reference/beta/api/devicetemplate-list-owners.md
@@ -5,7 +5,7 @@ author: "sofia-geislinger"
 ms.localizationpriority: medium
 ms.subservice: "entra-id"
 doc_type: apiPageType
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ---
 
 # List deviceTemplate owners
diff --git a/api-reference/beta/api/devicetemplate-post-owners.md b/api-reference/beta/api/devicetemplate-post-owners.md
@@ -5,7 +5,7 @@ author: "ploegert"
 ms.localizationpriority: medium
 ms.subservice: "entra-id"
 doc_type: apiPageType
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ---
 
 # Add deviceTemplate owner
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Add a new owner to a [deviceTemplate](../resources/devicetemplate.md) object. Owners are granted permissions to enable or disable devices and update properties, such as **alternativeNames**, for the devices created from these device templates. As an owner, no other administrator roles are necessary to create, update, or delete devices from this template, as well as to add or remove template owners. Owners added via this API are returned in a [list device owners](../api/devicetemplate-list-owners.md) request. 
+Add a new owner to a [deviceTemplate](../resources/devicetemplate.md) object. Owners are granted permissions to enable or disable devices and update properties, such as **alternativeNames**, for the devices created from the device template. As an owner, no other administrator roles are necessary to create, update, or delete devices from this template, as well as to add or remove template owners. Owners added via this API are returned in a [list device owners](../api/devicetemplate-list-owners.md) request. 
 
 ## Permissions
 
@@ -28,7 +28,6 @@ Choose the permission or permissions marked as least privileged for this API. Us
 [!INCLUDE [permissions-table](../includes/permissions/devicetemplate-post-owners-permissions.md)]
 
 [!INCLUDE [rbac-devicestemplate-apis](../includes/rbac-for-apis/rbac-devicetemplate-apis.md)]
-> **Note:** Users must be owner of the object.
 
 ## HTTP request
 
diff --git a/api-reference/beta/api/mutualtlsoauthconfiguration-delete.md b/api-reference/beta/api/mutualtlsoauthconfiguration-delete.md
@@ -2,7 +2,7 @@
 title: "Delete mutualTlsOauthConfiguration"
 description: "Delete the specified mutualTlsOauthConfiguration resource."
 author: "sofia-geislinger"
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ms.localizationpriority: medium
 ms.subservice: "entra-id"
 doc_type: apiPageType
diff --git a/api-reference/beta/api/mutualtlsoauthconfiguration-get.md b/api-reference/beta/api/mutualtlsoauthconfiguration-get.md
@@ -5,7 +5,7 @@ author: "atastrophic"
 ms.localizationpriority: medium
 ms.subservice: "entra-id"
 doc_type: apiPageType
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ---
 
 # Get mutualTlsOauthConfiguration
@@ -35,7 +35,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 ```http
 GET /directory/certificateAuthorities/mutualTlsOauthConfigurations/{mutualTlsOauthConfigurationId}
 ```
->**Note:** The `{mutualTlsOauthConfigurationId}` in the request URL is the value of the **id** property of the **deviceTemplate**.
+>**Note:** The `{mutualTlsOauthConfigurationId}` in the request URL is the value of the **id** property of the [deviceTemplate](../resources/devicetemplate.md).
 
 ## Optional query parameters
 
diff --git a/api-reference/beta/api/mutualtlsoauthconfiguration-update.md b/api-reference/beta/api/mutualtlsoauthconfiguration-update.md
@@ -5,7 +5,7 @@ author: "ploegert"
 ms.localizationpriority: medium
 ms.subservice: "entra-id"
 doc_type: apiPageType
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ---
 
 # Update mutualTlsOauthConfiguration
@@ -16,7 +16,7 @@ Namespace: microsoft.graph
 
 Update the specified [mutualTlsOauthConfiguration](../resources/mutualtlsoauthconfiguration.md) resource.
 
-You can only update the following two properties: **displayName**, **certificateAuthorities**.
+You can only update the following two properties: **displayName**, **certificateAuthority**.
 
 To update a subset of objects in the **certificateAuthorities** collection, first get the complete list, make your modifications, and then repost the entire contents of the **certificateAuthorities** attribute list in the request body. Excluding a subset of objects removes them from the collection.
 
@@ -143,6 +143,7 @@ This example assumes that the original object stored has the following value. No
   ]
 }
 ```
+
 #### Request
 
 The following example shows a request that updates the certificate authority list to contain only a single certificate, which removes the other.
diff --git a/api-reference/beta/api/template-list-devicetemplates.md b/api-reference/beta/api/template-list-devicetemplates.md
@@ -5,7 +5,7 @@ author: "sofia-geislinger"
 ms.localizationpriority: medium
 ms.subservice: "entra-id"
 doc_type: apiPageType
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ---
 
 # List deviceTemplates
diff --git a/api-reference/beta/api/template-post-devicetemplates.md b/api-reference/beta/api/template-post-devicetemplates.md
@@ -5,7 +5,7 @@ author: "sofia-geislinger"
 ms.localizationpriority: medium
 ms.subservice: "entra-id"
 doc_type: apiPageType
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ---
 
 # Create deviceTemplate
diff --git a/api-reference/beta/includes/rbac-for-apis/rbac-devicetemplate-apis.md b/api-reference/beta/includes/rbac-for-apis/rbac-devicetemplate-apis.md
@@ -7,4 +7,4 @@ ms.topic: include
 > In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. The following least privileged roles are supported for this operation:
 > - Cloud Device Administrator 
 > - IoT Device Administrator 
-> - Users
+> - Users - owners of the device template object
diff --git a/api-reference/beta/resources/certificateauthoritypath.md b/api-reference/beta/resources/certificateauthoritypath.md
@@ -3,7 +3,7 @@ title: "certificateAuthorityPath resource type"
 description: "Container for certificate authorities-related configurations for applications in the tenant."
 author: "madansr7"
 ms.localizationpriority: medium
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ms.subservice: "entra-sign-in"
 doc_type: resourcePageType
 ---
diff --git a/api-reference/beta/resources/device.md b/api-reference/beta/resources/device.md
@@ -3,7 +3,7 @@ title: "device resource type"
 description: "Represents a device registered in the directory."
 ms.localizationpriority: medium
 author: "sandeo-MSFT"
-ms.date: 12/02/2024
+ms.date: 12/31/2024
 ms.subservice: "entra-directory-management"
 doc_type: resourcePageType
 ---
@@ -103,8 +103,8 @@ This resource supports:
 | Relationship | Type    |Description|
 |:---------------|:--------|:----------|
 |commands | [command](command.md) collection | Set of commands sent to this device.|
+|deviceTemplate|[deviceTemplate](devicetemplate.md) collection|Device template used to instantiate this device. Nullable. Read-only. |
 |extensions|[extension](extension.md) collection|The collection of open extensions defined for the device. Read-only. Nullable. |
-|deviceTemplate|[deviceTemplate](devicetemplate.md) collection|Device template used to instantiate this object. Nullable. Read-only. |
 |memberOf|[directoryObject](directoryobject.md) collection|Groups and administrative units that this device is a member of. Read-only. Nullable. Supports `$expand`. |
 |registeredOwners|[directoryObject](directoryobject.md) collection| The user that cloud joined the device or registered their personal device. The registered owner is set at the time of registration. Read-only. Nullable. Supports `$expand`. |
 |registeredUsers|[directoryObject](directoryobject.md) collection| Collection of registered users of the device. For cloud joined devices and registered personal devices, registered users are set to the same value as registered owners at the time of registration. Read-only. Nullable. Supports `$expand`. |
diff --git a/api-reference/beta/resources/devicetemplate.md b/api-reference/beta/resources/devicetemplate.md
@@ -3,7 +3,7 @@ title: "deviceTemplate resource type"
 description: "Represents property values that are common to a set of device objects."
 author: "ploegert"
 ms.localizationpriority: medium
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ms.subservice: "entra-id"
 doc_type: resourcePageType
 ---
@@ -46,7 +46,7 @@ Inherits from [directoryObject](../resources/directoryobject.md).
 |Relationship|Type|Description|
 |:---|:---|:---|
 |deviceInstances|[device](../resources/device.md) collection|Collection of **device** objects created based on this template.|
-|owners|[directoryObject](../resources/directoryobject.md) collection|Collection of objects that can manage the device template and the related **deviceInstances**. Owners can be represented as [service principals](..\resources\serviceprincipal.md), [users](..\resources\users.md), or [applications](..\resources\application.md). As an owner, no other administrator roles are necessary to create, update, or delete devices from this template, as well as to add or remove template owners. |
+|owners|[directoryObject](../resources/directoryobject.md) collection|Collection of directory objects that can manage the device template and the related **deviceInstances**. Owners can be represented as [service principals](..\resources\serviceprincipal.md), [users](..\resources\users.md), or [applications](..\resources\application.md). An owner has full privileges over the device template and doesn't require other administrator roles to create, update, or delete devices from this template, as well as to add or remove template owners. |
 
 ## JSON representation
 The following JSON representation shows the resource type.
diff --git a/api-reference/beta/resources/directory.md b/api-reference/beta/resources/directory.md
@@ -3,7 +3,7 @@ title: "directory resource type (deleted items)"
 description: "Deleted items remain available to restore for up to 30 days. After 30 days, the items are permanently deleted."
 ms.localizationpriority: medium
 author: "keylimesoda"
-ms.date: 12/02/2024
+ms.date: 12/31/2024
 ms.subservice: "entra-directory-management"
 doc_type: resourcePageType
 toc.title: Deleted item
@@ -65,7 +65,7 @@ Inherits from [entity](entity.md).
 |publicKeyInfrastructure|[publicKeyInfrastructureRoot](../resources/publickeyinfrastructureroot.md)|The collection of public key infrastructure instances for the certificate-based authentication feature for users in a Microsoft Entra tenant.|
 | recommendations | [recommendation](../resources/recommendation.md) collection | List of recommended improvements to improve tenant posture. |
 | subscriptions | [companySubscription](companysubscription.md) collection | List of commercial subscriptions that an organization has. |
-|templates|[template](../resources/template.md) |A container for templates, such as device templates used for onboarding Entra ID devices. |
+|templates|[template](../resources/template.md) |A container for templates, such as device templates used for onboarding devices in Microsoft Entra ID. |
 
 ## JSON representation
 
diff --git a/api-reference/beta/resources/enums.md b/api-reference/beta/resources/enums.md
@@ -5,7 +5,7 @@ doc_type: enumPageType
 ms.localizationpriority: medium
 ms.subservice: "non-product-specific"
 author: "MSGraphDocsvTeam"
-ms.date: 12/19/2024
+ms.date: 12/31/2024
 ---
 
 # Enum values
diff --git a/api-reference/beta/resources/mutualtlsoauthconfiguration.md b/api-reference/beta/resources/mutualtlsoauthconfiguration.md
@@ -3,7 +3,7 @@ title: "mutualTlsOauthConfiguration resource type"
 description: "Represents a list of certificate authorities (CAs) that are permitted to issue certificates for a specific set of objects used for mTLS."
 author: "sgeislinger"
 ms.localizationpriority: medium
-ms.date: 11/20/2024
+ms.date: 12/31/2024
 ms.subservice: "entra-id"
 doc_type: resourcePageType
 toc.title: "Mutual TLS OAuth configuration"
diff --git a/api-reference/beta/resources/template.md b/api-reference/beta/resources/template.md
@@ -1,9 +1,9 @@
 ---
 title: "template resource type"
-description: "Represents a container for templates, such as device templates used for onboarding Entra ID devices."
+description: "Represents a container for templates, such as device templates used for onboarding devices in Microsoft Entra ID."
 author: "ploegert"
 ms.localizationpriority: medium
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ms.subservice: "entra-id"
 doc_type: resourcePageType
 ---
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Represents a container for templates, such as device templates used for onboarding Entra ID devices.
+Represents a container for templates, such as device templates used for onboarding devices in Microsoft Entra ID.
 
 ## Methods
 None.
diff --git a/api-reference/beta/resources/trustedcertificateauthorityasentitybase.md b/api-reference/beta/resources/trustedcertificateauthorityasentitybase.md
@@ -3,7 +3,7 @@ title: "trustedCertificateAuthorityAsEntityBase resource type"
 description: "An abstract base type that represents the trusted certificate authority types for the tenant."
 author: "madansr7"
 ms.localizationpriority: medium
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ms.subservice: "entra-sign-in"
 doc_type: resourcePageType
 ---
diff --git a/api-reference/beta/resources/trustedcertificateauthoritybase.md b/api-reference/beta/resources/trustedcertificateauthoritybase.md
@@ -3,7 +3,7 @@ title: "trustedCertificateAuthorityBase resource type"
 description: "An abstract type that represents a list of certificate authorities (CAs) that are permitted to issue certificates for authentication."
 author: "atastrophic"
 ms.localizationpriority: medium
-ms.date: 11/24/2024
+ms.date: 12/31/2024
 ms.subservice: "entra-id"
 doc_type: resourcePageType
 ---
diff --git a/changelog/Microsoft.DirectoryServices.json b/changelog/Microsoft.DirectoryServices.json
@@ -94,7 +94,7 @@
       "Id": "370a2bc0-4ec9-4052-95ee-0990a1204483",
       "Cloud": "Prod",
       "Version": "beta",
-      "CreatedDateTime": "2024-12-13T19:52:54.8483541Z",
+      "CreatedDateTime": "2024-12-31T19:52:54.8483541Z",
       "WorkloadArea": "Identity and access",
       "SubArea": "Directory management"
     },
diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md
@@ -17,6 +17,14 @@ For details about previous updates to Microsoft Graph, see [Microsoft Graph what
 > [!IMPORTANT]
 > Features in _preview_ status are subject to change without notice, and might not be promoted to generally available (GA) status. Don't use preview features in production apps.
 
+## January 2025: New in preview only 
+
+### Identity and access | Directory management
+
+- Use the **alternativeNames** property on [device](/graph/api/resources/device?view=graph-rest-beta&preserve-view=true) to get or set alternative names for a device.
+- Use the [deviceTemplate](/graph/api/resources/devicetemplate?view=graph-rest-beta&preserve-view=true) resource and its associated methods to manage device templates for Azure IoT.
+- Use the [mutualTlsOauthConfiguration](/graph/api/resources/mutualtlsoauthconfiguration?view=graph-rest-beta&preserve-view=true) resource and its associated methods to manage certificate authorities that are permitted to issue certificates for a specific set of objects used for mTLS.
+
 ## December 2024: New and generally available
 
 ### Reports
@@ -63,10 +71,6 @@ Use the new restore bulk addition request API for more convenient, efficient, an
 
 ### Identity and access | Directory management
 
-- Use the **alternativeNames** property on [device](/graph/api/resources/device?view=graph-rest-beta&preserve-view=true) to get or set alternative names for a device.
-- Use the [deviceTemplate](/graph/api/resources/devicetemplate?view=graph-rest-beta&preserve-view=true) resource and its associated methods to manage device templates for Azure IoT.
-- Use the [mutualTlsOauthConfiguration](/graph/api/resources/mutualtlsoauthconfiguration?view=graph-rest-beta&preserve-view=true) resource and its associated methods to manage certificate authorities that are permitted to issue certificates for a specific set of objects used for mTLS.
-
 While [restoring soft-deleted users](/graph/api/directory-deleteditems-restore?view=graph-rest-beta&preserve-view=true), you can now specify whether Microsoft Entra ID should replace the user's **userPrincipalName** with a new value.
 
 ### Identity and access | Identity and sign-in
