diff --git a/windows/deployment/update/deployment-service-drivers.md b/windows/deployment/update/deployment-service-drivers.md index dd3b3a7828..c336974ab1 100644 --- a/windows/deployment/update/deployment-service-drivers.md +++ b/windows/deployment/update/deployment-service-drivers.md @@ -11,7 +11,7 @@ ms.technology: itpro-updates ms.date: 02/14/2023 --- -# Deploy drivers and firmware updates with Windows Update for Business deployment service +# Tutorial: Deploy drivers and firmware updates with Windows Update for Business deployment service ***(Applies to: Windows 11 & Windows 10)*** @@ -20,6 +20,8 @@ In this tutorial, you will: > * [Open Graph Explorer](#open-graph-explorer) > * [Run queries to identify test devices](#run-queries-to-identify-test-devices) > * [Enroll devices](#enroll-devices) +> * [Create a deployment audience and add audience members](#create-a-deployment-audience-and-add-audience-members) +> * Do Z > * Do Z > * Do Z > * [Remove device enrollment](#remove-device-enrollment) @@ -49,24 +51,53 @@ When you enroll devices into driver management, the deployment service becomes t [!INCLUDE [Graph Explorer enroll devices](./includes/wufb-deployment-enroll-device-graph-explorer.md)] -## Create an audience +## Create a deployment audience and add audience members -```rest -POST https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences -content-type: application/json +1. Create an audience for the driver deployment. The deployment audience is a collection of member devices that will receive the driver deployment. POST to the [deployment audience](/graph/api/resources/windowsupdates-deploymentaudience) resource with a request body of `{}` to create a new audience. + + ```rest + POST https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences + content-type: application/json + + {} + ``` + + The POST returns a [201 Created](/troubleshoot/developer/webapps/iis/www-administration-management/http-status-code#2xx---success) response with the following body, where `id` is the **Audience ID**: + + ```json + { + "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/deploymentAudiences/$entity", + "id": "d39ad1ce-01234-5678-9abc-def012345678", + "reportingDeviceCount": 0, + "applicableContent": [] + } + ``` + +1. Add devices, using their **Azure AD ID**, to the deployment audience so they become audience members. Specify the deployment **Audience ID** in the URL field and the devices to add in the request body. The `id` property specifies the **Azure AD ID** of the device. + + ```rest + POST https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences/d39ad1ce-01234-5678-9abc-def012345678/updateAudience + Content-type: application/json + + { + "addMembers": [ + { + "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice", + "id": "01234567-89ab-cdef-0123-456789abcdef" + }, + { + "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice", + "id": "01234567-89ab-cdef-0123-456789abcde0" + }, + { + "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice", + "id": "01234567-89ab-cdef-0123-456789abcde1" + } + ] + } + ``` -{} -``` -Returns a [201 Created] response with the following body: -```json -{ - "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/deploymentAudiences/$entity", - "id": "f0ec689b-fa10-4e45-965c-ce753f7d4363", - "reportingDeviceCount": 0, - "applicableContent": [] -} -``` ## Remove device enrollment diff --git a/windows/deployment/update/deployment-service-feature-updates.md b/windows/deployment/update/deployment-service-feature-updates.md index 5c6a7a72c0..9670fee85f 100644 --- a/windows/deployment/update/deployment-service-feature-updates.md +++ b/windows/deployment/update/deployment-service-feature-updates.md @@ -11,7 +11,7 @@ ms.technology: itpro-updates ms.date: 02/14/2023 --- -# Deploy feature updates with Windows Update for Business deployment service +# Tutorial: Deploy feature updates with Windows Update for Business deployment service ***(Applies to: Windows 11 & Windows 10)*** diff --git a/windows/deployment/update/includes/wufb-deployment-enroll-device-graph-explorer.md b/windows/deployment/update/includes/wufb-deployment-enroll-device-graph-explorer.md index 5ea333f440..b95b1cc330 100644 --- a/windows/deployment/update/includes/wufb-deployment-enroll-device-graph-explorer.md +++ b/windows/deployment/update/includes/wufb-deployment-enroll-device-graph-explorer.md @@ -19,26 +19,26 @@ You enroll devices based on the types of updates you want them to recieve.Curren 1. In the **Request body** tab, enter the following JSON, supplying the following information: - **Azure AD Device ID** as `id` - Either `feature` or `driver` for the updateCategory - - ```json - { - "updateCategory": "driver", - "assets": [ - { - "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice", - "id": "01234567-89ab-cdef-0123-456789abcdef" - }, - { - "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice", - "id": "01234567-89ab-cdef-0123-456789abcde0" - }, - { - "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice", - "id": "01234567-89ab-cdef-0123-456789abcde1" - } - ] - } - ``` + + ```json + { + "updateCategory": "driver", + "assets": [ + { + "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice", + "id": "01234567-89ab-cdef-0123-456789abcdef" + }, + { + "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice", + "id": "01234567-89ab-cdef-0123-456789abcde0" + }, + { + "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice", + "id": "01234567-89ab-cdef-0123-456789abcde1" + } + ] + } + ``` 1. Select the **Run query** button. The results will appear in the **Response** window. In this case, the status code of [202 Accepted](/troubleshoot/developer/webapps/iis/www-administration-management/http-status-code#2xx---success).