mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-06-16 10:53:43 +00:00
use include for audience
This commit is contained in:
@ -56,56 +56,8 @@ When you enroll devices into driver management, the deployment service becomes t
|
|||||||
|
|
||||||
## Create a deployment audience and add audience members
|
## Create a deployment audience and add audience members
|
||||||
|
|
||||||
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.
|
<!--Using include for creating deployment audiences and adding audience members using Graph Explorer-->
|
||||||
|
[!INCLUDE [Graph Explorer enroll devices](./includes/wufb-deployment-audience-graph-explorer.md)]
|
||||||
```http
|
|
||||||
POST https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences
|
|
||||||
content-type: application/json
|
|
||||||
|
|
||||||
{}
|
|
||||||
```
|
|
||||||
|
|
||||||
The POST returns an HTTP status code of `201 Created` as a 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-0123-4567-89ab-cdef01234567",
|
|
||||||
"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.
|
|
||||||
|
|
||||||
```http
|
|
||||||
POST https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences/d39ad1ce-0123-4567-89ab-cdef01234567/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"
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
1. To verify the devices were added to the audience, run the following query using the **Audience ID**:
|
|
||||||
|
|
||||||
```http
|
|
||||||
GET https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences/d39ad1ce-0123-4567-89ab-cdef01234567/members
|
|
||||||
```
|
|
||||||
|
|
||||||
Once a device has been enrolled and added to a deployment audience, the Windows Update for Business deployment service will start collecting scan results from Windows Update to build a catalog of applicable drivers to be browsed, approved, and scheduled for deployment.
|
Once a device has been enrolled and added to a deployment audience, the Windows Update for Business deployment service will start collecting scan results from Windows Update to build a catalog of applicable drivers to be browsed, approved, and scheduled for deployment.
|
||||||
|
|
||||||
|
@ -18,7 +18,7 @@ ms.date: 02/14/2023
|
|||||||
In this article, you will:
|
In this article, you will:
|
||||||
> [!div class="checklist"]
|
> [!div class="checklist"]
|
||||||
> * [Open Graph Explorer](#open-graph-explorer)
|
> * [Open Graph Explorer](#open-graph-explorer)
|
||||||
> * [Run queries to identify test devices](#run-queries-to-identify-devices)
|
> * [Run queries to identify devices](#run-queries-to-identify-devices)
|
||||||
> * [Enroll devices](#enroll-devices)
|
> * [Enroll devices](#enroll-devices)
|
||||||
> * Do Z
|
> * Do Z
|
||||||
> * Do Z
|
> * Do Z
|
||||||
@ -50,6 +50,13 @@ As long as a device remains enrolled in feature update management, the device do
|
|||||||
<!--Using include for enrolling devices using Graph Explorer-->
|
<!--Using include for enrolling devices using Graph Explorer-->
|
||||||
[!INCLUDE [Graph Explorer enroll devices](./includes/wufb-deployment-enroll-device-graph-explorer.md)]
|
[!INCLUDE [Graph Explorer enroll devices](./includes/wufb-deployment-enroll-device-graph-explorer.md)]
|
||||||
|
|
||||||
|
## Create a deployment audience and add audience members
|
||||||
|
|
||||||
|
<!--Using include for creating deployment audiences and adding audience members using Graph Explorer-->
|
||||||
|
[!INCLUDE [Graph Explorer enroll devices](./includes/wufb-deployment-audience-graph-explorer.md)]
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## Unenroll devices
|
## Unenroll devices
|
||||||
|
|
||||||
|
@ -0,0 +1,62 @@
|
|||||||
|
---
|
||||||
|
author: mestew
|
||||||
|
ms.author: mstewart
|
||||||
|
manager: aaroncz
|
||||||
|
ms.technology: itpro-updates
|
||||||
|
ms.prod: windows-client
|
||||||
|
ms.topic: include
|
||||||
|
ms.date: 02/14/2023
|
||||||
|
ms.localizationpriority: medium
|
||||||
|
---
|
||||||
|
<!--This file is shared by deployment-service-drivers.md and the deployment-service-feature-updates.md articles. Headings may be driven by article context. 7512398 -->
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
```http
|
||||||
|
POST https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences
|
||||||
|
content-type: application/json
|
||||||
|
|
||||||
|
{}
|
||||||
|
```
|
||||||
|
|
||||||
|
The POST returns an HTTP status code of `201 Created` as a 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-0123-4567-89ab-cdef01234567",
|
||||||
|
"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.
|
||||||
|
|
||||||
|
```http
|
||||||
|
POST https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences/d39ad1ce-0123-4567-89ab-cdef01234567/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"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
1. To verify the devices were added to the audience, run the following query using the **Audience ID**:
|
||||||
|
|
||||||
|
```http
|
||||||
|
GET https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences/d39ad1ce-0123-4567-89ab-cdef01234567/members
|
||||||
|
```
|
Reference in New Issue
Block a user