Merge branch 'main' into freshness-PermissionsManagementHowTo

Danielabom · web-flow · commit c6c718124d7a · 2025-01-17T11:26:36.000-06:00
diff --git a/api-reference/beta/api/adminwindowsupdates-list-deployments.md b/api-reference/beta/api/adminwindowsupdates-list-deployments.md
@@ -3,7 +3,7 @@ title: "List deployments"
 description: "Get a list of deployment objects and their properties."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: apiPageType
 ms.date: 09/16/2024
 ---
diff --git a/api-reference/beta/api/adminwindowsupdates-list-resourceconnections-operationalinsightsconnection.md b/api-reference/beta/api/adminwindowsupdates-list-resourceconnections-operationalinsightsconnection.md
@@ -3,7 +3,7 @@ title: "List operationalInsightsConnections"
 description: "Get a list of the operationalInsightsConnection objects and their properties."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: apiPageType
 ms.date: 08/31/2024
 ---
diff --git a/api-reference/beta/api/adminwindowsupdates-list-resourceconnections.md b/api-reference/beta/api/adminwindowsupdates-list-resourceconnections.md
@@ -3,7 +3,7 @@ title: "List resourceConnections"
 description: "Get a list of the resourceConnection objects and their properties."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: apiPageType
 ms.date: 09/16/2024
 ---
diff --git a/api-reference/beta/api/adminwindowsupdates-list-updatableassets-azureaddevice.md b/api-reference/beta/api/adminwindowsupdates-list-updatableassets-azureaddevice.md
@@ -3,7 +3,7 @@ title: "List azureADDevice resources"
 description: "Get a list of azureADDevice objects and their properties."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: apiPageType
 ms.date: 09/16/2024
 ---
diff --git a/api-reference/beta/api/adminwindowsupdates-list-updatableassets-updatableassetgroup.md b/api-reference/beta/api/adminwindowsupdates-list-updatableassets-updatableassetgroup.md
@@ -3,7 +3,7 @@ title: "List updatableAssetGroup resources"
 description: "Get a list of updatableAssetGroup objects and their properties."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: apiPageType
 ms.date: 09/16/2024
 ---
diff --git a/api-reference/beta/api/adminwindowsupdates-list-updatableassets.md b/api-reference/beta/api/adminwindowsupdates-list-updatableassets.md
@@ -3,7 +3,7 @@ title: "List updatableAssets"
 description: "Get a list of updatableAsset objects and their properties."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: apiPageType
 ms.date: 09/16/2024
 ---
diff --git a/api-reference/beta/api/adminwindowsupdates-list-updatepolicies.md b/api-reference/beta/api/adminwindowsupdates-list-updatepolicies.md
@@ -3,7 +3,7 @@ title: "List updatePolicies"
 description: "Get a list of updatePolicy objects and their properties."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: apiPageType
 ms.date: 09/16/2024
 ---
diff --git a/api-reference/beta/api/adminwindowsupdates-post-deploymentaudiences.md b/api-reference/beta/api/adminwindowsupdates-post-deploymentaudiences.md
@@ -3,7 +3,7 @@ title: "Create deploymentAudience"
 description: "Create a new deploymentAudience object."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: apiPageType
 ms.date: 08/31/2024
 ---
diff --git a/api-reference/beta/api/adminwindowsupdates-post-deployments.md b/api-reference/beta/api/adminwindowsupdates-post-deployments.md
@@ -3,7 +3,7 @@ title: "Create deployment"
 description: "Create a new deployment object."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: apiPageType
 ms.date: 09/16/2024
 ---
diff --git a/api-reference/beta/api/adminwindowsupdates-post-resourceconnections-operationalinsightsconnection.md b/api-reference/beta/api/adminwindowsupdates-post-resourceconnections-operationalinsightsconnection.md
@@ -3,7 +3,7 @@ title: "Create operationalInsightsConnection"
 description: "Create a new operationalInsightsConnection object."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: apiPageType
 ms.date: 08/31/2024
 ---
diff --git a/api-reference/beta/api/adminwindowsupdates-post-updatableassets-updatableassetgroup.md b/api-reference/beta/api/adminwindowsupdates-post-updatableassets-updatableassetgroup.md
@@ -3,7 +3,7 @@ title: "Create updatableAssetGroup"
 description: "Create a new updatableAssetGroup object."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: apiPageType
 ms.date: 08/31/2024
 ---
diff --git a/api-reference/beta/api/adminwindowsupdates-post-updatepolicies.md b/api-reference/beta/api/adminwindowsupdates-post-updatepolicies.md
@@ -3,7 +3,7 @@ title: "Create updatePolicy"
 description: "Create a new updatePolicy object."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: apiPageType
 ms.date: 09/16/2024
 ---
diff --git a/api-reference/beta/api/devicetemplate-createdevicefromtemplate.md b/api-reference/beta/api/devicetemplate-createdevicefromtemplate.md
@@ -55,7 +55,7 @@ The following table lists the parameters that you can use when you call this act
 |:---|:---|:---|
 | accountEnabled       | Boolean                             | `true` if the account is enabled; otherwise, `false`. The default value is `true`. A disabled device can't authenticate with Microsoft Entra ID. Optional.|
 | alternativeNames     | String collection                   | A collection of ARM resource IDs associated with the device, if any. Optional. |
-| externalDeviceId     | String                              | UUID of the device by IoT registry. Must be unique within a tenant. Required. |
+| externalDeviceId     | String                              | ID of the device in IoT registry. Must be unique within a tenant. Required. |
 | externalSourceName   | String                              | Identifies the source name of the device. Optional. |
 | keyCredential        | [keyCredential](../resources/keycredential.md) | The key credential when you use self-signed certificates. Optional. |
 | operatingSystemVersion | String                              | The operating system version of the device specified. Optional. |
diff --git a/api-reference/beta/api/devicetemplate-post-owners.md b/api-reference/beta/api/devicetemplate-post-owners.md
@@ -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 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. 
+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. There can be a maximum of 100 owners on a device template.
 
 ## Permissions
 
diff --git a/api-reference/beta/api/mutualtlsoauthconfiguration-update.md b/api-reference/beta/api/mutualtlsoauthconfiguration-update.md
@@ -155,18 +155,18 @@ This example assumes that the original object stored has the following value. No
   "certificateAuthorities": [
     {
       "isRootAuthority": true,
-      "certificateRevocationListUrl": "http://acme.com/root.crl",
+      "certificateRevocationListUrl": "http://LakeshoreRetail.com/root.crl",
       "deltaCertificateRevocationListUrl": null,
       "certificate": "joGrWL+Yqkik/CABWG0d1w....",
-      "issuer": "acme Inc",
+      "issuer": "Lakeshore Retail",
       "issuerSubjectkeyIdentifier": "SKI"
     },
     {
       "isRootAuthority": true,
-      "certificateRevocationListUrl": "http://digicert.com/root.crl",
+      "certificateRevocationListUrl": "http://LakeshoreRetail.com/root.crl",
       "deltaCertificateRevocationListUrl": null,
       "certificate": "koGrWL+Yqkik/CABWG0d1w....",
-      "issuer": "Digicert Inc",
+      "issuer": "Lakeshore Retail",
       "issuerSubjectkeyIdentifier": "SKI"
     }
   ]
@@ -191,10 +191,10 @@ Content-Type: application/json
   "certificateAuthorities": [
     {
       "isRootAuthority": true,
-      "certificateRevocationListUrl": "http://acme.com/root.crl",
+      "certificateRevocationListUrl": "http://LakeshoreRetail.com/root.crl",
       "deltaCertificateRevocationListUrl": null,
       "certificate": "Binary",
-      "issuer": "acme Inc",
+      "issuer": "Lakeshore Retail",
       "issuerSubjectkeyIdentifier": "SKI"
     }
   ]
@@ -253,10 +253,10 @@ Location: "https://graph.microsoft.com/beta/directory/certificateAuthorities/mut
   "certificateAuthorities": [
     {
       "isRootAuthority": true,
-      "certificateRevocationListUrl": "http://acme.com/root.crl",
+      "certificateRevocationListUrl": "http://LakeshoreRetail.com/root.crl",
       "deltaCertificateRevocationListUrl": null,
       "certificate": "Binary",
-      "issuer": "acme Inc",
+      "issuer": "Lakeshore Retail",
       "issuerSubjectkeyIdentifier": "SKI"
     }
   ]
diff --git a/api-reference/beta/api/template-list-devicetemplates.md b/api-reference/beta/api/template-list-devicetemplates.md
@@ -120,17 +120,17 @@ Content-Type: application/json
       "id": "16f1d02a-af59-4ca7-b2ea-494a262353b9",
       "mutualTlsOauthConfigurationId": "00001111-aaaa-2222-bbbb-3333cccc4444",
       "mutualTlsOauthConfigurationTenantId": "00001111-aaaa-2222-bbbb-3333cccc4445",
-      "deviceAuthority": "IoT Device Authority",
-      "manufacturer": "IoT Manufacturer",
+      "deviceAuthority": "Lakeshore Retail",
+      "manufacturer": "Tailwind Traders",
       "model": "IoT Device K1",
       "operatingSystem": "WindowsIoT"
     },
     {
       "id": "3a0698d9-fd85-4b9e-9655-e26d19013459",
       "mutualTlsOauthConfigurationId": "00001111-aaaa-2222-bbbb-3333cccc4433",
       "mutualTlsOauthConfigurationTenantId": "00001111-aaaa-2222-bbbb-3333cccc4435",
-      "deviceAuthority": "IoT Test for owner",
-      "manufacturer": "IoT manufacturer",
+      "deviceAuthority": "Lakeshore Retail",
+      "manufacturer": "Tailwind Traders",
       "model": "IoT Devices",
       "operatingSystem": null
     }
diff --git a/api-reference/beta/resources/devicetemplate.md b/api-reference/beta/resources/devicetemplate.md
@@ -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 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. <br/><br/> Supports `$expand`. |
+|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. There can be a maximum of 100 owners on a device template. <br/><br/> Supports `$expand`. |
 
 ## JSON representation
 The following JSON representation shows the resource type.
diff --git a/concepts/extensibility-open-users.md b/concepts/extensibility-open-users.md
@@ -1,22 +1,22 @@
 ---
 title: "Add custom data to users using open extensions"
-description: "Learn how to add an open extension to a user's profile, query it, change and delete the extension."
+description: "Learn how to use open extensions to add lightweight data to a user's profile, query it, change, and delete the extension."
 author: FaithOmbongi
 ms.author: ombongifaith
 ms.reviewer: dkershaw
 ms.subservice: extensions
 ms.localizationpriority: high
 ms.custom: graphiamtop20
 ms.topic: tutorial
-ms.date: 01/25/2024
+ms.date: 01/17/2025
 #Customer intent: As a developer, I want to learn how to store lightweight data to Microsoft Entra users through Microsoft Graph, and avoid using an external database system.
 ---
 
 # Add custom data to users using open extensions
 
 In this tutorial, you lean how to use [open extensions](/graph/api/resources/opentypeextension).
 
-Imagine you're building an application that's available on multiple client platforms, such as desktop and mobile. You want to let users configure their UI experience so it's consistent no matter which device they use to sign in to your app.
+Imagine you're building an application that's available on multiple client platforms, such as desktop and mobile. You want to the app's users to configure their UI experience so it's consistent no matter which device they use to sign in.
 
 For this scenario, this article shows you how to:
 
@@ -34,7 +34,7 @@ For this scenario, this article shows you how to:
 
 To reproduce the steps in this article, you need the following privileges:
 
-- Sign in to an API client such as [Graph Explorer](https://aka.ms/ge) and the user you want to store the roaming profile for.
+- Sign in to an API client such as [Graph Explorer](https://aka.ms/ge) as the user you want to store the roaming profile for.
 - Grant the app the *User.ReadWrite* delegated permission for the signed-in user.
 
 ## Step 1. Add roaming profile information
@@ -119,7 +119,7 @@ Content-Type: application/json
 
 ## Step 2. Retrieve roaming profile information
 
-When the user signs in to the app from another device, the app calls Microsoft Graph to retrieve the user's profile details and expand the **extensions** navigation property to get their roaming settings, then uses this data to provide the same experience as on the other device.
+When the user signs in to the app from another device, the app calls Microsoft Graph to retrieve their profile details including the **extensions** navigation property that contains their roaming settings, then uses this data to provide the same experience as on the other device.
 
 ### Request
 
@@ -202,7 +202,7 @@ Content-Type: application/json
 
 The user can choose to change their roaming profile information. The app calls Microsoft Graph by running the following query. The request returns a `204 No Content` response code.
 
-You must include all properties in the request body as well, even if you want to update only a subset of them. Otherwise, Microsoft Graph removes the properties you don't pass in. To delete data but keep a property, set the property value to `null`.
+You must include all properties in the request body, even if you want to update only a subset. Otherwise, Microsoft Graph removes the unspecified properties. To delete data but keep a property, set the property value to `null`.
 
 # [HTTP](#tab/http)
 <!-- {
@@ -215,7 +215,7 @@ Content-type: application/json
 
 {
     "theme":"light",
-    "color":"yellow",
+    "color":"purple",
     "lang":"Swahili"
 }
 ```
diff --git a/concepts/images/msgraph-onboarding/explorer8-createassignment.png b/concepts/images/msgraph-onboarding/explorer8-createassignment.png
diff --git a/concepts/images/security-ediscovery-appauthsetup-step2.png b/concepts/images/security-ediscovery-appauthsetup-step2.png
diff --git a/concepts/toc.yml b/concepts/toc.yml
@@ -1106,7 +1106,7 @@ items:
         href: change-notifications-delivery-webhooks.md
       - name: Notifications through Azure Event Hubs
         href: change-notifications-delivery-event-hubs.md
-      - name: Notifications through Azure Event Grid (preview)
+      - name: Notifications through Azure Event Grid
         href: /azure/event-grid/subscribe-to-graph-api-events?context=graph%2Fcontext
     - name: Lifecycle notifications for subscriptions
       href: change-notifications-lifecycle-events.md
diff --git a/concepts/windowsupdates-concept-overview.md b/concepts/windowsupdates-concept-overview.md
@@ -3,7 +3,7 @@ title: "Windows updates API overview"
 description: "Windows Autopatch gives control to your organization over the updates offered to your devices."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: conceptualPageType
 ms.date: 11/07/2024
 ---
diff --git a/concepts/windowsupdates-deploy-expedited-update.md b/concepts/windowsupdates-deploy-expedited-update.md
@@ -3,7 +3,7 @@ title: "Deploy an expedited quality update using Windows Autopatch"
 description: "Follow these steps to deploy expedited Windows quality updates to devices in a Microsoft Entra tenant when an emergency occurs by using Windows Autopatch."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: conceptualPageType
 ms.date: 11/07/2024
 ---
diff --git a/concepts/windowsupdates-deploy-update.md b/concepts/windowsupdates-deploy-update.md
@@ -3,7 +3,7 @@ title: "Deploy a feature update using Windows Autopatch"
 description: "Follow these steps to deploy Windows feature updates to devices in a Microsoft Entra tenant by using Windows Autopatch."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: conceptualPageType
 ms.date: 11/07/2024
 ---
diff --git a/concepts/windowsupdates-deployments.md b/concepts/windowsupdates-deployments.md
@@ -3,7 +3,7 @@ title: "Deployments in Windows Autopatch"
 description: "Use Windows Autopatch to create deployments, configure settings, and set lifecycle state. Assign a device to multiple deployments."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: conceptualPageType
 ms.date: 11/07/2024
 ---
diff --git a/concepts/windowsupdates-enroll.md b/concepts/windowsupdates-enroll.md
@@ -3,7 +3,7 @@ title: "Enroll in update management by Windows Autopatch"
 description: "Enroll a device in update management so that you can use Windows Autopatch to manage content delivered from Windows Update to that device."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: conceptualPageType
 ms.date: 11/07/2024
 ---
diff --git a/concepts/windowsupdates-hotpatch-update.md b/concepts/windowsupdates-hotpatch-update.md
@@ -3,7 +3,7 @@ title: "Deploy a hotpatch quality update using Windows Autopatch"
 description: "Follow these steps to deploy hotpatch Windows quality updates to devices in a Microsoft Entra tenant by using Windows Autopatch."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: conceptualPageType
 ms.date: 11/05/2024
 ---
diff --git a/concepts/windowsupdates-manage-driver-update.md b/concepts/windowsupdates-manage-driver-update.md
@@ -3,7 +3,7 @@ title: "Deploy a driver update using Windows Autopatch"
 description: "Follow these steps to manage driver approvals for devices in a Microsoft Entra tenant by using Windows Autopatch."
 author: "Ryan-K-Williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: conceptualPageType
 ms.date: 11/07/2024
 ---
diff --git a/concepts/windowsupdates-manage-monitoring-rules.md b/concepts/windowsupdates-manage-monitoring-rules.md
@@ -3,7 +3,7 @@ title: "Manage monitoring rules using Windows Autopatch"
 description: "Use Windows Autopatch to create a monitoring rule or resume deployments paused by a monitoring rule."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: conceptualPageType
 ms.date: 11/07/2024
 ---
diff --git a/concepts/windowsupdates-manage-safeguards.md b/concepts/windowsupdates-manage-safeguards.md
@@ -3,7 +3,7 @@ title: "Manage safeguards using Windows Autopatch"
 description: "When you deploy updates with Windows Autopatch, it automatically prevents devices with issues from being offered the update."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: conceptualPageType
 ms.date: 11/07/2024
 ---
diff --git a/concepts/windowsupdates-schedule-deployment.md b/concepts/windowsupdates-schedule-deployment.md
@@ -3,7 +3,7 @@ title: "Schedule a deployment using Windows Autopatch"
 description: "When deploying an update, you can schedule the deployment so that devices receive the update later by using Windows Autopatch."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: conceptualPageType
 ms.date: 11/07/2024
 ---
diff --git a/concepts/windowsupdates-software-updates.md b/concepts/windowsupdates-software-updates.md
@@ -3,7 +3,7 @@ title: "Software updates with Windows Autopatch"
 description: "Software updates are the primary type of content Windows Autopatch deploys. You can look in a catalog to find specific updates that are available to deploy."
 author: "ryan-k-williams"
 ms.localizationpriority: medium
-ms.subservice: autopatch
+ms.subservice: windows-autopatch
 doc_type: conceptualPageType
 ms.date: 11/07/2024
 ---
