overview and prereq edits

This commit is contained in:
Meghan Stewart
2023-02-11 19:50:08 -08:00
parent d367e35e2c
commit 8fd46377c5
5 changed files with 21 additions and 17 deletions

View File

@ -90,7 +90,7 @@ Response returning the policy, without any additional settings specified, that h
```json ```json
HTTP/1.1 202 Accepted HTTP/1.1 202 Accepted
Content-type: application/json content-type: application/json
{ {
"@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/updatePolicies/$entity", "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/updatePolicies/$entity",
"id": "9011c330-1234-5678-9abc-def012345678", "id": "9011c330-1234-5678-9abc-def012345678",
@ -119,8 +119,7 @@ To create a policy with additional settings, in the request body:
```msgraph-interactive ```msgraph-interactive
POST https://graph.microsoft.com/beta/admin/windows/updates/updatePolicies POST https://graph.microsoft.com/beta/admin/windows/updates/updatePolicies
content-type: application/json content-type: application/json
Content-length: 967
{ {
"@odata.type": "#microsoft.graph.windowsUpdates.updatePolicy", "@odata.type": "#microsoft.graph.windowsUpdates.updatePolicy",
"audience": { "audience": {
@ -139,17 +138,7 @@ To create a policy with additional settings, in the request body:
}, },
"durationBeforeDeploymentStart": "P7D" "durationBeforeDeploymentStart": "P7D"
} }
], ]
"deploymentSettings": {
"@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
"schedule": {
"gradualRollout": {
"@odata.type": "#microsoft.graph.windowsUpdates.rateDrivenRolloutSettings",
"durationBetweenOffers": "P1D",
"devicePerOffer": 1000
}
}
}
} }
``` ```
@ -166,6 +155,7 @@ To edit the policy settings, **PATCH** the policy using the **Policy ID**. Run t
``` msgraph-interactive ``` msgraph-interactive
PATCH https://graph.microsoft.com/beta/admin/windows/updates/updatePolicies/9011c330-1234-5678-9abc-def012345678 PATCH https://graph.microsoft.com/beta/admin/windows/updates/updatePolicies/9011c330-1234-5678-9abc-def012345678
content-type: application/json
{ {
"complianceChangeRules": [ "complianceChangeRules": [

View File

@ -174,6 +174,12 @@ content-type: application/json
} }
``` ```
To verify the devices were added to the audience, run the following query using the **Audience ID** of `d39ad1ce-0123-4567-89ab-cdef01234567`:
```msgraph-interactive
GET https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences/d39ad1ce-0123-4567-89ab-cdef01234567/members
```
## Pause a deployment ## Pause a deployment
To pause a deployment, PATCH the deployment to have a `requestedValue` of `paused` for the [deploymentState](/graph/api/resources/windowsupdates-deploymentstate). To resume the deployment, use the value `none` and the state will either update to `offering` or `scheduled` if the deployment hasn't reached the start date yet. To pause a deployment, PATCH the deployment to have a `requestedValue` of `paused` for the [deploymentState](/graph/api/resources/windowsupdates-deploymentstate). To resume the deployment, use the value `none` and the state will either update to `offering` or `scheduled` if the deployment hasn't reached the start date yet.

View File

@ -248,6 +248,12 @@ The following example adds three devices to the deployment audience using the **
} }
``` ```
To verify the devices were added to the audience, run the following query using the **Audience ID** of `d39ad1ce-0123-4567-89ab-cdef01234567`:
```msgraph-interactive
GET https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences/d39ad1ce-0123-4567-89ab-cdef01234567/members
```
## Pause a deployment ## Pause a deployment
To pause a deployment, PATCH the deployment to have a `requestedValue` of `paused` for the [deploymentState](/graph/api/resources/windowsupdates-deploymentstate). To resume the deployment, use the value `none` and the state will either update to `offering` or `scheduled` if the deployment hasn't reached the start date yet. To pause a deployment, PATCH the deployment to have a `requestedValue` of `paused` for the [deploymentState](/graph/api/resources/windowsupdates-deploymentstate). To resume the deployment, use the value `none` and the state will either update to `offering` or `scheduled` if the deployment hasn't reached the start date yet.

View File

@ -14,7 +14,8 @@ A deployment audience is a collection of devices that you want to deploy updates
1. To create a new audience, **POST** to the [deployment audience](/graph/api/resources/windowsupdates-deploymentaudience) resource with a request body of `{}`. 1. To create a new audience, **POST** to the [deployment audience](/graph/api/resources/windowsupdates-deploymentaudience) resource with a request body of `{}`.
```msgraph-interactive ```msgraph-interactive
POST https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences POST https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences
content-type: application/json
{} {}
``` ```
@ -34,7 +35,8 @@ A deployment audience is a collection of devices that you want to deploy updates
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. 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.
```msgraph-interactive ```msgraph-interactive
POST https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences/d39ad1ce-0123-4567-89ab-cdef01234567/updateAudience POST https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences/d39ad1ce-0123-4567-89ab-cdef01234567/updateAudience
content-type: application/json
{ {
"addMembers": [ "addMembers": [

View File

@ -31,4 +31,4 @@ For this article, you'll use Graph Explorer to make requests to the [Microsoft G
1. Select the **Run query** button. The results will appear in the **Response** window. 1. Select the **Run query** button. The results will appear in the **Response** window.
> [!TIP] > [!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**. > 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**.