diff --git a/windows/deployment/update/deployment-service-drivers.md b/windows/deployment/update/deployment-service-drivers.md index 9306660954..76fa41480a 100644 --- a/windows/deployment/update/deployment-service-drivers.md +++ b/windows/deployment/update/deployment-service-drivers.md @@ -26,4 +26,10 @@ In this tutorial, you will: ## Open Graph Explorer -[!INCLUDE [Graph Explorer sign in](./includes/wufb-deployment-graph-explorer.md)] \ No newline at end of file +[!INCLUDE [Graph Explorer sign in](./includes/wufb-deployment-graph-explorer.md)] + +## Run queries to identify test devices + + +[!INCLUDE [Graph Explorer device queries](./includes/wufb-deployment-find-device-name.md)] + diff --git a/windows/deployment/update/deployment-service-expedited-updates.md b/windows/deployment/update/deployment-service-expedited-updates.md index a8ba04d28f..a886d3b539 100644 --- a/windows/deployment/update/deployment-service-expedited-updates.md +++ b/windows/deployment/update/deployment-service-expedited-updates.md @@ -29,3 +29,8 @@ In this tutorial, you will: [!INCLUDE [Graph Explorer sign in](./includes/wufb-deployment-graph-explorer.md)] + +## Run queries to identify test devices + + +[!INCLUDE [Graph Explorer device queries](./includes/wufb-deployment-find-device-name.md)] \ No newline at end of file diff --git a/windows/deployment/update/deployment-service-feature-updates.md b/windows/deployment/update/deployment-service-feature-updates.md index e1f9d5e2d9..3f888d0fb9 100644 --- a/windows/deployment/update/deployment-service-feature-updates.md +++ b/windows/deployment/update/deployment-service-feature-updates.md @@ -24,4 +24,9 @@ In this tutorial, you will: ## Open Graph Explorer -[!INCLUDE [Graph Explorer sign in](./includes/wufb-deployment-graph-explorer.md)] \ No newline at end of file +[!INCLUDE [Graph Explorer sign in](./includes/wufb-deployment-graph-explorer.md)] + +## Run queries to identify test devices + + +[!INCLUDE [Graph Explorer device queries](./includes/wufb-deployment-find-device-name.md)] \ No newline at end of file diff --git a/windows/deployment/update/includes/wufb-deployment-find-device-name.md b/windows/deployment/update/includes/wufb-deployment-find-device-name.md new file mode 100644 index 0000000000..461af6da9d --- /dev/null +++ b/windows/deployment/update/includes/wufb-deployment-find-device-name.md @@ -0,0 +1,36 @@ +--- +author: mestew +ms.author: mstewart +manager: aaroncz +ms.prod: w10 +ms.collection: M365-modern-desktop +ms.topic: include +ms.date: 08/18/2022 +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. + +Displays the AzureAD ID and name of all devices:
+ `GET https://graph.microsoft.com/v1.0/devices?$select=deviceid,displayName` + +Displays the AzureAD ID for a device name that starts with `Test`:
+ `GET https://graph.microsoft.com/v1.0/devices?$filter=startswith(displayName, 'Test')&$select=deviceid,displayName` + +### Add a request header + +For the next requests, set the **ConsistencyLevel** header to `eventual`. For more information about advanced query parameters, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). + +1. In Graph Explorer, select the **Request headers** tab. +1. For **Key** type in `ConsistencyLevel` then type `eventual` for **Value**. +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"::: + +Displays the name and operating system version for the device that has the AzureAD ID of `44bb2fa1-5bfe-44c7-9221-9c8ed64e1076`:
+ `GET https://graph.microsoft.com/v1.0/devices?$search="deviceid:44bb2fa1-5bfe-44c7-9221-9c8ed64e1076"?$select=displayName,operatingSystemVersion` + +Find devices that don't have virtual machine listed as the model and that have a manufacturer listed:
+`GET https://graph.microsoft.com/v1.0/devices?$filter=model ne 'virtual machine' and NOT(manufacturer eq null)&$count=true&$select=deviceid,displayName,operatingSystemVersion` + diff --git a/windows/deployment/update/includes/wufb-deployment-graph-explorer.md b/windows/deployment/update/includes/wufb-deployment-graph-explorer.md index 8cfc4924b1..bca691a415 100644 --- a/windows/deployment/update/includes/wufb-deployment-graph-explorer.md +++ b/windows/deployment/update/includes/wufb-deployment-graph-explorer.md @@ -8,7 +8,7 @@ ms.topic: include ms.date: 08/18/2022 ms.localizationpriority: medium --- - + For this tutorial, you'll use Graph Explorer to make requests to the [Microsoft Graph APIs](/graph/api/resources/windowsupdates-updates?view=graph-rest-beta&preserve-view=true) to retrieve, add, delete, and update data. For more information about using Graph Explorer, see [Get started with Graph Explorer](/graph/graph-explorer/overview). @@ -20,6 +20,6 @@ For this tutorial, you'll use Graph Explorer to make requests to the [Microsoft 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. - :::image type="content" source="../media/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"::: diff --git a/windows/deployment/update/media/7512398-deployment-service-graph-modify-header.png b/windows/deployment/update/media/7512398-deployment-service-graph-modify-header.png new file mode 100644 index 0000000000..44fb8ee6ab Binary files /dev/null and b/windows/deployment/update/media/7512398-deployment-service-graph-modify-header.png differ diff --git a/windows/deployment/update/media/wufbds-graph-modify-permission.png b/windows/deployment/update/media/7512398-wufbds-graph-modify-permission.png similarity index 100% rename from windows/deployment/update/media/wufbds-graph-modify-permission.png rename to windows/deployment/update/media/7512398-wufbds-graph-modify-permission.png