mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-06-16 10:53:43 +00:00
overview and prereq edits
This commit is contained in:
@ -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",
|
||||||
@ -120,7 +120,6 @@ To create a policy with additional settings, in the request body:
|
|||||||
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": [
|
||||||
|
@ -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.
|
||||||
|
@ -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.
|
||||||
|
@ -15,6 +15,7 @@ A deployment audience is a collection of devices that you want to deploy updates
|
|||||||
|
|
||||||
```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
|
||||||
|
|
||||||
{}
|
{}
|
||||||
```
|
```
|
||||||
@ -35,6 +36,7 @@ A deployment audience is a collection of devices that you want to deploy updates
|
|||||||
|
|
||||||
```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": [
|
||||||
|
@ -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**.
|
||||||
|
Reference in New Issue
Block a user