From b80aafa463f8a3c7be5ab7ea7b176cca365694c1 Mon Sep 17 00:00:00 2001 From: Meghan Stewart <33289333+mestew@users.noreply.github.com> Date: Wed, 25 Jan 2023 14:09:06 -0800 Subject: [PATCH] edits --- .../update/deployment-service-drivers.md | 7 +++++++ .../deployment-service-expedited-updates.md | 5 +++++ .../update/deployment-service-feature-updates.md | 7 +++++++ ...deployment-find-device-name-graph-explorer.md | 4 ++-- .../includes/wufb-deployment-graph-explorer.md | 5 +++-- .../wufb-deployment-tutorial-permissions.md | 16 ++++++++++++++++ 6 files changed, 40 insertions(+), 4 deletions(-) create mode 100644 windows/deployment/update/includes/wufb-deployment-tutorial-permissions.md diff --git a/windows/deployment/update/deployment-service-drivers.md b/windows/deployment/update/deployment-service-drivers.md index 5bfce6c8ad..c8a29a1586 100644 --- a/windows/deployment/update/deployment-service-drivers.md +++ b/windows/deployment/update/deployment-service-drivers.md @@ -23,6 +23,13 @@ In this tutorial, you will: > * Do Z > * Do Z +## Prerequisites + +### Permissions + + +[!INCLUDE [Windows Update for Business deployment service tutorial permissions](./includes/wufb-deployment-tutorial-permissions.md.md)] + ## Open Graph Explorer diff --git a/windows/deployment/update/deployment-service-expedited-updates.md b/windows/deployment/update/deployment-service-expedited-updates.md index c394e42638..7a21b4a50f 100644 --- a/windows/deployment/update/deployment-service-expedited-updates.md +++ b/windows/deployment/update/deployment-service-expedited-updates.md @@ -26,6 +26,11 @@ In this tutorial, you will: ? This requires an extra license at the moment correct? Of does the client have to be listed as intune managed at the moment? +### Permissions + + +[!INCLUDE [Windows Update for Business deployment service tutorial permissions](./includes/wufb-deployment-tutorial-permissions.md.md)] + ## Open Graph Explorer diff --git a/windows/deployment/update/deployment-service-feature-updates.md b/windows/deployment/update/deployment-service-feature-updates.md index 7ba0d5c1bd..18c90eb594 100644 --- a/windows/deployment/update/deployment-service-feature-updates.md +++ b/windows/deployment/update/deployment-service-feature-updates.md @@ -21,6 +21,13 @@ In this tutorial, you will: > * [Run queries to identify test devices](#run-queries-to-identify-test-devices) > * Do Z +## Prerequisites + +### Permissions + + +[!INCLUDE [Windows Update for Business deployment service tutorial permissions](./includes/wufb-deployment-tutorial-permissions.md.md)] + ## Open Graph Explorer diff --git a/windows/deployment/update/includes/wufb-deployment-find-device-name-graph-explorer.md b/windows/deployment/update/includes/wufb-deployment-find-device-name-graph-explorer.md index 02e1f20cc0..8be06bc49a 100644 --- a/windows/deployment/update/includes/wufb-deployment-find-device-name-graph-explorer.md +++ b/windows/deployment/update/includes/wufb-deployment-find-device-name-graph-explorer.md @@ -10,7 +10,7 @@ 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 Device ID** and **Name** of all devices: @@ -50,4 +50,4 @@ GET https://graph.microsoft.com/v1.0/devices?$filter=model ne 'virtual machine' > 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. +> - The `id` from the [device](/graph/api/resources/device) resource type is usually the Azure AD Object ID, which won't be used in this tutorial. diff --git a/windows/deployment/update/includes/wufb-deployment-graph-explorer.md b/windows/deployment/update/includes/wufb-deployment-graph-explorer.md index 0c4d86b149..2a51ba52d4 100644 --- a/windows/deployment/update/includes/wufb-deployment-graph-explorer.md +++ b/windows/deployment/update/includes/wufb-deployment-graph-explorer.md @@ -24,8 +24,9 @@ For this tutorial, you'll use Graph Explorer to make requests to the [Microsoft 1. To make requests: 1. Select either GET, POST, PUT, PATCH, or DELETE from the drop-down list for the HTTP method. - 1. Enter the request into the URL field. The version will populate automatically based on the URL + 1. Enter the request into the URL field. The version will populate automatically based on the URL. 1. If you need to modify the request body, edit the **Request body** tab. 1. Select the **Run query** button. The results will appear in the **Response** window. - > [!TIP] When reviewing [Microsoft Graph documentation](/graph/), you may notice example requests usually list `Content-type: application/json`. Specifying `content-type` typically isn't required for Graph Explorer, but you can add it to the request by selecting the **Headers** tab and adding the `content-type` to the **Request headers** field as the **Key** and `application/json` as the **Value**. + > [!TIP] + > When reviewing [Microsoft Graph documentation](/graph/), you may notice example requests usually list `Content-type: application/json`. Specifying `content-type` typically isn't required for Graph Explorer, but you can add it to the request by selecting the **Headers** tab and adding the `content-type` to the **Request headers** field as the **Key** and `application/json` as the **Value**. diff --git a/windows/deployment/update/includes/wufb-deployment-tutorial-permissions.md b/windows/deployment/update/includes/wufb-deployment-tutorial-permissions.md new file mode 100644 index 0000000000..b1f494a758 --- /dev/null +++ b/windows/deployment/update/includes/wufb-deployment-tutorial-permissions.md @@ -0,0 +1,16 @@ +--- +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 +--- + + +The following permissions are needed for the tutorial: + +- [WindowsUpdates.ReadWrite.All](/graph/permissions-reference#windows-updates-permissions) for [Windows Update for Business deployment service](/graph/api/resources/windowsupdates) operations. +- At least [Device.Read.All](/graph/permissions-reference#device-permissions) permission to display [device](/graph/api/resources/device) information. \ No newline at end of file