mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-05-12 13:27:23 +00:00
edits
This commit is contained in:
parent
d30ca671ee
commit
a3659897e0
@ -12,7 +12,45 @@ ms.localizationpriority: medium
|
|||||||
|
|
||||||
You enroll devices based on the types of updates you want them to recieve.Currently, you can enroll devices to receive feature updates (`feature`) or drivers (`driver`). You can enroll devices to receive updates from multiple update classifications.
|
You enroll devices based on the types of updates you want them to recieve.Currently, you can enroll devices to receive feature updates (`feature`) or drivers (`driver`). You can enroll devices to receive updates from multiple update classifications.
|
||||||
|
|
||||||
1.
|
1. To enroll devices, you'll POST to [updatableAssets](/graph/api/resources/windowsupdates-updatableasset) using [enrollAssets](/graph/api/windowsupdates-updatableasset-enrollassets). The following example enrolls three devices to receive driver updates:
|
||||||
|
1. In Graph Explorer, select **POST** from the drop-down list for the HTTP verb.
|
||||||
|
1. Enter the following request into the URL field: </br>
|
||||||
|
`https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/enrollAssets`
|
||||||
|
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"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
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).
|
||||||
|
|
||||||
|
:::image type="content" source="../media/7512398-deployment-enroll-asset-graph.png" alt-text="Screenshot of successfully enrolling assets through Graph Explorer." lightbox="../media/7512398-deployment-enroll-asset-graph.png" :::
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
```rest
|
```rest
|
||||||
|
|
||||||
POST https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/enrollAssets
|
POST https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/enrollAssets
|
||||||
|
@ -12,13 +12,19 @@ ms.localizationpriority: medium
|
|||||||
|
|
||||||
You will need at least [Device.Read.All](/graph/permissions-reference#device-permissions) permission to display [device](/graph/api/resources/device) information.
|
You will need at least [Device.Read.All](/graph/permissions-reference#device-permissions) permission to display [device](/graph/api/resources/device) information.
|
||||||
|
|
||||||
Displays the AzureAD device ID and name of all devices:
|
> [!Tip]
|
||||||
|
> Requests using the [device](/graph/api/resources/device) resource type typically have both an `id` and a `deviceid`:
|
||||||
|
> - The `deviceid` is the **Azure AD Device ID** and will be used in this tutorial.
|
||||||
|
> - Later in this tutorial, this `deviceid` will be used as an `id` when you make certain requests such as adding a device to a deployment audience.
|
||||||
|
> - The `id` from the [device](/graph/api/resources/device) resource type is usually the Azure AD Object ID and it won't be used in this tutorial.
|
||||||
|
|
||||||
|
Displays the **AzureAD Device ID** and **Name** of all devices:
|
||||||
|
|
||||||
```rest
|
```rest
|
||||||
GET https://graph.microsoft.com/v1.0/devices?$select=deviceid,displayName
|
GET https://graph.microsoft.com/v1.0/devices?$select=deviceid,displayName
|
||||||
```
|
```
|
||||||
|
|
||||||
Displays the AzureAD device ID for a device name that starts with `Test`:
|
Displays the **AzureAD Device ID** and **Name** for device names that starts with `Test`:
|
||||||
|
|
||||||
```rest
|
```rest
|
||||||
GET https://graph.microsoft.com/v1.0/devices?$filter=startswith(displayName,'Test')&$select=deviceid,displayName
|
GET https://graph.microsoft.com/v1.0/devices?$filter=startswith(displayName,'Test')&$select=deviceid,displayName
|
||||||
@ -32,15 +38,15 @@ For the next requests, set the **ConsistencyLevel** header to `eventual`. For mo
|
|||||||
1. For **Key** type in `ConsistencyLevel` and for **Value**, type `eventual`.
|
1. For **Key** type in `ConsistencyLevel` and for **Value**, type `eventual`.
|
||||||
1. Select the **Add** button. When you're finished, remove the request header by selecting the trash can icon.
|
1. Select the **Add** button. When you're finished, remove the request header by selecting the trash can icon.
|
||||||
|
|
||||||
:::image type="content" source="../media/7512398-deployment-service-graph-modify-header.png" alt-text="Screenshot of the request headers tab in Graph Explorer":::
|
:::image type="content" source="../media/7512398-deployment-service-graph-modify-header.png" alt-text="Screenshot of the request headers tab in Graph Explorer" lightbox="../media/7512398-deployment-service-graph-modify-header.png":::
|
||||||
|
|
||||||
Displays the name and operating system version for the device that has the AzureAD device ID of `01234567-89ab-cdef-0123-456789abcdef`:
|
Displays the **Name** and **Operating system version** for the device that has the **AzureAD Device ID** of `01234567-89ab-cdef-0123-456789abcdef`:
|
||||||
|
|
||||||
```rest
|
```rest
|
||||||
GET https://graph.microsoft.com/v1.0/devices?$search="deviceid:01234567-89ab-cdef-0123-456789abcdef"?$select=displayName,operatingSystemVersion
|
GET https://graph.microsoft.com/v1.0/devices?$search="deviceid:01234567-89ab-cdef-0123-456789abcdef"?$select=displayName,operatingSystemVersion
|
||||||
```
|
```
|
||||||
|
|
||||||
Find devices that don't have virtual machine listed as the model and that have a manufacturer listed:
|
Find devices that don't have virtual machine listed as the model and that have a manufacturer listed. Display the **AzureAD Device ID**, **Name**, and **Operating system version** for each device:
|
||||||
|
|
||||||
```rest
|
```rest
|
||||||
GET https://graph.microsoft.com/v1.0/devices?$filter=model ne 'virtual machine' and NOT(manufacturer eq null)&$count=true&$select=deviceid,displayName,operatingSystemVersion
|
GET https://graph.microsoft.com/v1.0/devices?$filter=model ne 'virtual machine' and NOT(manufacturer eq null)&$count=true&$select=deviceid,displayName,operatingSystemVersion
|
||||||
|
@ -20,7 +20,7 @@ For this tutorial, you'll use Graph Explorer to make requests to the [Microsoft
|
|||||||
1. Select the **Modify permissions** tab in Graph Explorer.
|
1. Select the **Modify permissions** tab in Graph Explorer.
|
||||||
1. In the permissions dialog box, select the **WindowsUpdates.ReadWrite.All** permission then select **Consent**. You may need to sign in again to grant consent.
|
1. In the permissions dialog box, select the **WindowsUpdates.ReadWrite.All** permission then select **Consent**. You may need to sign in again to grant consent.
|
||||||
|
|
||||||
:::image type="content" source="../media/7512398-wufbds-graph-modify-permission.png" alt-text="Screenshot of the modify permissions tab in Graph Explorer":::
|
:::image type="content" source="../media/7512398-wufbds-graph-modify-permission.png" alt-text="Screenshot of the modify permissions tab in Graph Explorer" lightbox="../media/7512398-wufbds-graph-modify-permission.png" :::
|
||||||
|
|
||||||
1. To make requests:
|
1. To make requests:
|
||||||
1. Select either GET, POST, PUT, PATCH, or DELETE from the drop-down list for the HTTP verb.
|
1. Select either GET, POST, PUT, PATCH, or DELETE from the drop-down list for the HTTP verb.
|
||||||
|
Binary file not shown.
After Width: | Height: | Size: 158 KiB |
Loading…
x
Reference in New Issue
Block a user