Поделиться через


Развертывание ускоренного обновления качества с помощью службы развертывания клиентский компонент Центра обновления Windows для бизнеса

С помощью службы развертывания клиентский компонент Центра обновления Windows для бизнеса можно развертывать обновления Windows на устройствах в клиенте Microsoft Entra. Сегодня служба развертывания поддерживает развертывание обновлений компонентов Windows 10/11, ускоряемых обновлений качества и обновлений драйверов. Этот раздел посвящен развертыванию ускоряемых обновлений качества. Сведения о развертывании обновлений компонентов см. в разделе Развертывание обновления компонентов. Сведения о развертывании обновлений драйверов см. в разделе Управление обновлением драйверов.

Быстрое обновление качества переопределяет клиентский компонент Центра обновления Windows политики отсрочки для бизнеса, чтобы обновление устанавливалось как можно быстрее. Это может быть полезно, когда возникают критические события качества и вам нужно развертывать последние обновления быстрее, чем обычно. Тем не менее, хотя он может помочь достичь целевых показателей соответствия конкретному обновлению качества, он не предназначен для использования каждый месяц. Вместо этого рекомендуется использовать крайние сроки соответствия для обновлений.

При развертывании ускоренного обновления качества на устройстве клиентский компонент Центра обновления Windows предлагает последнее применимое обновление для устройства, если оно еще не получило обновление с указанной датой выпуска. Например, если вы развернете Windows 10 обновление для системы безопасности, выпущенное 13 апреля 2021 г., на устройстве, на которое в настоящее время нет обновления, устройство получит ускоренное обновление. Если устройство уже имеет указанное или более новое обновление, оно не получает ускоренное обновление.

Ускоренное обновление качества также имеет следующие характеристики:

  • Обновление начинается сразу, а не ожидает следующей регулярной проверки наличия обновлений, которая выполняется каждые 22 часа по умолчанию.
  • Обновление скачивается и устанавливается максимально быстро.
  • Процесс обновления переопределяет настроенные параметры политики устройства, например дни до принудительной перезагрузки устройства. После установки ускоренного обновления устройство возвращается к текущим параметрам политики.

Предварительные требования

Шаг 1. (Необязательно) Получение списка оперативно обновляемых обновлений

Вы можете запросить каталог служб развертывания, чтобы получить список обновлений, которые можно ускорить на устройствах в качестве содержимого в развертывании.

Обновления качества представлены типом qualityUpdateCatalogEntry с типом qualityUpdateClassificationsecurity или nonSecurity. Все Windows 10 обновления качества, которые классифицируются какsecurity, и все Windows 11 обновления качества, которые классифицируются как security или non-security могут быть ускоряться.

Все исправления относятся к списку редакций продукта. Добавьте $expand=microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions в URL-адрес запроса, чтобы определить сборки операционной системы, на которые влияет каждое обновление качества.

В следующем примере показано, как запрашивать все Windows 10 обновления качества, которые могут быть развернуты в качестве ускоряемых обновлений службой развертывания. Рекомендуется отображать только три самых последних обновления, поэтому в следующем примере содержится $top=3.

Запрос

GET https://graph.microsoft.com/beta/admin/windows/updates/catalog/entries?$top=3&$filter=isof('microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry') and microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/isExpeditable eq true&$expand=microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions&$orderby=releaseDateTime desc

Отклик

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries(microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions())",
    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET admin/windows/updates/catalog/entries?$select=deployableUntilDateTime,displayName",
    "value": [
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry",
            "id": "7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e",
            "displayName": "12/12/2023 - 2023.12 B SecurityUpdate for Windows 10 and later",
            "deployableUntilDateTime": null,
            "releaseDateTime": "2023-12-12T00:00:00Z",
            "isExpeditable": true,
            "qualityUpdateClassification": "security",
            "catalogName": "2023-12 Cumulative Update for Windows 10 and later",
            "shortName": "2023.12 B",
            "qualityUpdateCadence": "monthly",
            "cveSeverityInformation": {
                "maxSeverity": "moderate",
                "maxBaseScore": 9.6,
                "exploitedCves@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/cveSeverityInformation/exploitedCves",
                "exploitedCves": []
            },
            "productRevisions@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions",
            "productRevisions": [
                {
                    "id": "10.0.19045.3803",
                    "displayName": "Windows 10, version 22H2, build 19045.3803",
                    "releaseDateTime": "2023-12-12T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 10",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 19045,
                        "updateBuildRevision": 3803
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.19045.3803')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5033372",
                        "url": "https://support.microsoft.com/help/5033372"
                    }
                },
                {
                    "id": "10.0.22621.2861",
                    "displayName": "Windows 11, version 22H2, build 22621.2861",
                    "releaseDateTime": "2023-12-12T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22621,
                        "updateBuildRevision": 2861
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22621.2861')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5033375",
                        "url": "https://support.microsoft.com/help/5033375"
                    }
                },
                {
                    "id": "10.0.22000.2652",
                    "displayName": "Windows 11, version 21H2, build 22000.2652",
                    "releaseDateTime": "2023-12-12T00:00:00Z",
                    "version": "21H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22000,
                        "updateBuildRevision": 2652
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22000.2652')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5033369",
                        "url": "https://support.microsoft.com/help/5033369"
                    }
                },
                {
                    "id": "10.0.19044.3803",
                    "displayName": "Windows 10, version 21H2, build 19044.3803",
                    "releaseDateTime": "2023-12-12T00:00:00Z",
                    "version": "21H2",
                    "product": "Windows 10",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 19044,
                        "updateBuildRevision": 3803
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.19044.3803')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5033372",
                        "url": "https://support.microsoft.com/help/5033372"
                    }
                },
                {
                    "id": "10.0.22631.2861",
                    "displayName": "Windows 11, version 23H2, build 22631.2861",
                    "releaseDateTime": "2023-12-12T00:00:00Z",
                    "version": "23H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22631,
                        "updateBuildRevision": 2861
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('7752017d0d3dd343836d0a6952d51380c8faa114466fe0944f3f40e0dcbc491e')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22631.2861')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5033375",
                        "url": "https://support.microsoft.com/help/5033375"
                    }
                }
            ]
        },
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry",
            "id": "936705f27e4efc863ae4e6f2004da8cc6a51e035902d3367def02faf263e9fbd",
            "displayName": "11/30/2023 - 2023.11 D Update for Windows 10 and later",
            "deployableUntilDateTime": null,
            "releaseDateTime": "2023-11-30T00:00:00Z",
            "isExpeditable": true,
            "qualityUpdateClassification": "nonSecurity",
            "catalogName": "2023-11 Cumulative Update Preview for Windows 10 and later",
            "shortName": "2023.11 D",
            "qualityUpdateCadence": "monthly",
            "cveSeverityInformation": null,
            "productRevisions@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('936705f27e4efc863ae4e6f2004da8cc6a51e035902d3367def02faf263e9fbd')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions",
            "productRevisions": [
                {
                    "id": "10.0.19045.3758",
                    "displayName": "Windows 10, version 22H2, build 19045.3758",
                    "releaseDateTime": "2023-11-30T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 10",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 19045,
                        "updateBuildRevision": 3758
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('936705f27e4efc863ae4e6f2004da8cc6a51e035902d3367def02faf263e9fbd')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.19045.3758')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032278",
                        "url": "https://support.microsoft.com/help/5032278"
                    }
                },
                {
                    "id": "10.0.22621.2792",
                    "displayName": "Windows 11, version 22H2, build 22621.2792",
                    "releaseDateTime": "2023-12-04T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22621,
                        "updateBuildRevision": 2792
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('936705f27e4efc863ae4e6f2004da8cc6a51e035902d3367def02faf263e9fbd')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22621.2792')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032288",
                        "url": "https://support.microsoft.com/help/5032288"
                    }
                },
                {
                    "id": "10.0.22631.2792",
                    "displayName": "Windows 11, version 23H2, build 22631.2792",
                    "releaseDateTime": "2023-12-04T00:00:00Z",
                    "version": "23H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22631,
                        "updateBuildRevision": 2792
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('936705f27e4efc863ae4e6f2004da8cc6a51e035902d3367def02faf263e9fbd')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22631.2792')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032288",
                        "url": "https://support.microsoft.com/help/5032288"
                    }
                }
            ]
        },
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry",
            "id": "97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71",
            "displayName": "11/14/2023 - 2023.11 B SecurityUpdate for Windows 10 and later",
            "deployableUntilDateTime": null,
            "releaseDateTime": "2023-11-14T00:00:00Z",
            "isExpeditable": true,
            "qualityUpdateClassification": "security",
            "catalogName": "2023-11 Cumulative Update for Windows 10 and later",
            "shortName": "2023.11 B",
            "qualityUpdateCadence": "monthly",
            "cveSeverityInformation": {
                "maxSeverity": "critical",
                "maxBaseScore": 9.8,
                "exploitedCves@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/cveSeverityInformation/exploitedCves",
                "exploitedCves": [
                    {
                        "number": "CVE-2023-36036",
                        "url": "https://msrc.microsoft.com/update-guide/vulnerability/CVE-2023-36036"
                    },
                    {
                        "number": "CVE-2023-36033",
                        "url": "https://msrc.microsoft.com/update-guide/vulnerability/CVE-2023-36033"
                    },
                    {
                        "number": "CVE-2023-36025",
                        "url": "https://msrc.microsoft.com/update-guide/vulnerability/CVE-2023-36025"
                    }
                ]
            },
            "productRevisions@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions",
            "productRevisions": [
                {
                    "id": "10.0.19045.3693",
                    "displayName": "Windows 10, version 22H2, build 19045.3693",
                    "releaseDateTime": "2023-11-14T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 10",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 19045,
                        "updateBuildRevision": 3693
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.19045.3693')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032189",
                        "url": "https://support.microsoft.com/help/5032189"
                    }
                },
                {
                    "id": "10.0.22621.2715",
                    "displayName": "Windows 11, version 22H2, build 22621.2715",
                    "releaseDateTime": "2023-11-14T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22621,
                        "updateBuildRevision": 2715
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22621.2715')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032190",
                        "url": "https://support.microsoft.com/help/5032190"
                    }
                },
                {
                    "id": "10.0.22000.2600",
                    "displayName": "Windows 11, version 21H2, build 22000.2600",
                    "releaseDateTime": "2023-11-14T00:00:00Z",
                    "version": "21H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22000,
                        "updateBuildRevision": 2600
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22000.2600')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032192",
                        "url": "https://support.microsoft.com/help/5032192"
                    }
                },
                {
                    "id": "10.0.19044.3693",
                    "displayName": "Windows 10, version 21H2, build 19044.3693",
                    "releaseDateTime": "2023-11-14T00:00:00Z",
                    "version": "21H2",
                    "product": "Windows 10",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 19044,
                        "updateBuildRevision": 3693
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.19044.3693')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032189",
                        "url": "https://support.microsoft.com/help/5032189"
                    }
                },
                {
                    "id": "10.0.22631.2715",
                    "displayName": "Windows 11, version 23H2, build 22631.2715",
                    "releaseDateTime": "2023-11-14T00:00:00Z",
                    "version": "23H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22631,
                        "updateBuildRevision": 2715
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('97b5e4baece0047a63eca88c4e7c93fb2d5fb5667cef0b417f6e51e1cc2f4c71')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22631.2715')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5032190",
                        "url": "https://support.microsoft.com/help/5032190"
                    }
                }
            ]
        }
    ]
}

Шаг 2. Создание развертывания

Развертывание указывает содержимое для развертывания, способ и время развертывания содержимого, а также целевые устройства. Для обновлений качества содержимое указывается с помощью целевой даты соответствия. При создании развертывания аудитория развертывания автоматически создается в виде связи.

При развертывании ускоренного обновления качества на устройстве клиентский компонент Центра обновления Windows предлагает обновление, которое выводит устройство выше указанного минимального уровня соответствия. В зависимости от того, когда каждое устройство сканирует и обновляется, некоторые устройства могут получать более новые обновления (например, более новое обновление для системы безопасности, чем обновление, соответствующее минимальному уровню соответствия), но все устройства соответствуют указанному стандарту соответствия обновлений системы безопасности. Такое поведение при предложении последнего применимого обновления, указанное эквивалентом свойстваContent , для которого задано значение latestSecurityпо умолчанию, помогает обеспечить максимально возможную безопасность устройств и предотвратить получение устройствами ускоренного обновления, за которым следует еще одно регулярное обновление через несколько дней.

Примечание: Если вы развертываете ускоренное обновление качества, отличное от системы безопасности, оно должно быть последним выпущенным обновлением качества. Например, если ускорить выпуск 11D после выпуска 12B, обновление для устройств в развертывании не будет ускорено.

Льготный период перезапуска устройства можно настроить с помощью свойства daysUntilForcedReboot в параметрах взаимодействия с пользователем развертывания. Льготный период задает время после установки, которое пользователь может контролировать время перезапуска устройства. Если устройство не перезагрузилось к истечению льготного периода, оно перезапускается автоматически.

Ниже приведен пример создания развертывания для ускоренного обновления качества. Целевые устройства указываются на следующем шаге.

Запрос

POST https://graph.microsoft.com/beta/admin/windows/updates/deployments
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.windowsUpdates.deployment",
    "content": {
        "@odata.type": "#microsoft.graph.windowsUpdates.catalogContent",
        "catalogEntry": {
            "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry",
            "id": "catalog/entries/1"
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "expedite": {
            "isExpedited": true, 
            "isReadinessTest": false
        },
        "userExperience": {
            "daysUntilForcedReboot": 2
        }
    }
}

Отклик

HTTP/1.1 201 Created
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.windowsUpdates.deployment",
    "id": "b5171742-1742-b517-4217-17b5421717b5",
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)",    
    "state": {
        "effectiveValue": "offering",
        "requestedValue": "none",
        "reasons": []
    },
    "content": {
        "@odata.type": "#microsoft.graph.windowsUpdates.catalogContent"
    },
    "settings": {
        "schedule": null,
        "monitoring": null,
        "contentApplicability": null,
        "userExperience": {
            "daysUntilForcedReboot": 2
        },
        "expedite": {
            "isExpedited": true
        }
    }
}

Шаг 3. Назначение устройств аудитории развертывания

После создания развертывания можно назначить устройства аудитории развертывания. После успешного обновления аудитории развертывания клиентский компонент Центра обновления Windows предлагает обновление для соответствующих устройств в соответствии с параметрами развертывания.

Устройства автоматически регистрируются в службе при добавлении в коллекции членов или исключений аудитории развертывания (то есть объект azureADDevice автоматически создается, если он еще не существует).

В следующем примере показано, как добавить Microsoft Entra устройства в качестве участников аудитории развертывания.

Запрос

POST https://graph.microsoft.com/beta/admin/windows/updates/deployments/{deploymentId}/audience/updateAudience
Content-type: application/json

{
    "addMembers": [
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
            "id": "String (identifier)"
        },
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
            "id": "String (identifier)"
        },
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
            "id": "String (identifier)"
        }
    ]
}

Отклик

HTTP/1.1 202 Accepted

Во время развертывания

Пока выполняется развертывание, можно приостановить развертывание, обновив его состояние и обновив членов аудитории и исключения.

После развертывания

После того как все устройства, назначенные аудитории развертывания, изначально были предложены обновления, возможно, не все устройства начали или завершили обновление из-за таких факторов, как подключение устройства. Пока развертывание все еще существует, оно гарантирует, что клиентский компонент Центра обновления Windows предлагает обновление назначенным устройствам при каждом повторном подключении.