Partilhar via

Implementar uma atualização de qualidade acelerada com o Windows Autopatch

  • Artigo

Com o Windows Autopatch, pode implementar atualizações do Windows em dispositivos num inquilino Microsoft Entra. Atualmente, o Windows Autopatch suporta a implementação de atualizações de funcionalidades Windows 10/11, atualizações de qualidade de acesso frequente, atualizações de qualidade aceleradas e atualizações de controlador. Este tópico centra-se na implementação de atualizações de qualidade aceleradas. Para obter informações sobre a implementação de atualizações de funcionalidades, veja Implementar uma atualização de funcionalidades. Para obter informações sobre como implementar atualizações de qualidade de acesso frequente, consulte Implementar uma atualização de qualidade de acesso frequente. Para obter informações sobre como implementar atualizações de controladores, veja Gerir a atualização do controlador.

Acelerar uma atualização de qualidade substitui as políticas de diferimento Windows Update para Empresas para que a atualização seja instalada o mais rapidamente possível. Pode ser útil quando surgem eventos de qualidade críticos e tem de implementar as atualizações mais recentes mais rapidamente do que o normal. No entanto, embora possa ajudar a alcançar objetivos de conformidade relativamente a uma atualização de qualidade específica, não foi concebido para ser utilizado todos os meses. Em vez disso, considere utilizar prazos de conformidade para atualizações.

Quando implementa uma atualização de qualidade acelerada num dispositivo, Windows Update oferece a atualização mais recente aplicável ao dispositivo se ainda não tiver recebido a atualização com a data de lançamento especificada. Por exemplo, se implementar a atualização de segurança Windows 10 disponibilizada a 13 de abril de 2021 num dispositivo que não tenha atualmente a atualização, o dispositivo recebe uma atualização acelerada. Se o dispositivo já tiver a atualização especificada ou mais recente, não receberá uma atualização acelerada.

As atualizações de qualidade aceleradas também têm as seguintes características:

  • A atualização é iniciada imediatamente em vez de aguardar a próxima verificação de atualização regular, que ocorre uma vez a cada 22 horas por padrão.
  • A atualização é baixada e instalada o mais rápido possível.
  • O processo de atualização substitui as configurações de política de dispositivo definidas, como dias até que o dispositivo seja forçado a reiniciar. Depois que a atualização acelerada é instalada, o dispositivo retorna para as configurações de política atuais.

Pré-requisitos

Passo 1: (Opcional) Obter uma lista de atualizações expeditas

Pode consultar a API de catálogo do Windows Autopatch para obter uma lista de atualizações que podem ser aceleradas para dispositivos como conteúdo numa implementação.

As atualizações de qualidade são representadas pelo tipo qualityUpdateCatalogEntry , com qualityUpdateClassification de security ou nonSecurity. Todas as atualizações de qualidade Windows 10 classificadas como security e todas as atualizações de qualidade Windows 11 classificadas como security ou non-security podem ser aceleradas.

Todas as atualizações de qualidade referem-se a uma lista de revisões de produtos. Adicione $expand=microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions ao URL do pedido para identificar que sistema operativo cria cada atualização de qualidade que afeta.

O exemplo seguinte mostra como consultar todas as atualizações de qualidade Windows 10 que podem ser implementadas como atualizações aceleradas pelo Windows Autopatch. Recomendamos que mostre apenas as três atualizações mais atuais, pelo que o exemplo seguinte inclui $top=3.

Solicitação

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

Resposta

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"
                    }
                }
            ]
        }
    ]
}

Passo 2: criar uma implementação

Uma implementação especifica o conteúdo a implementar, como e quando implementar o conteúdo e os dispositivos visados. Para atualizações de qualidade, o conteúdo é especificado através de uma data de conformidade de destino. Quando uma implementação é criada, uma audiência de implementação é criada automaticamente como uma relação.

Quando implementa uma atualização de qualidade acelerada num dispositivo, Windows Update oferece uma atualização que coloca o dispositivo acima do nível mínimo de conformidade especificado. Dependendo de quando cada dispositivo analisa e atualizações, alguns dispositivos podem receber atualizações mais recentes (por exemplo, uma atualização de segurança mais recente do que a que corresponde ao nível mínimo de conformidade), mas todos os dispositivos cumprem a norma de conformidade de atualização de segurança especificada. Este comportamento de oferecer a atualização mais recente aplicável, indicado pela propriedade equivalenteContent a ser definida para o valor latestSecuritypredefinido, ajuda a manter os dispositivos o mais seguros possível e impede que um dispositivo receba uma atualização acelerada seguida de outra atualização regular poucos dias depois.

Nota: Se implementar uma atualização de qualidade não relacionada com segurança acelerada, esta tem de ser a atualização de qualidade mais recente disponibilizada. Por exemplo, se agilizar a versão 11D após o lançamento de 12B, nenhuma atualização será acelerada para os dispositivos na implementação.

Pode configurar o período de tolerância de reinício do dispositivo com a propriedade daysUntilForcedReboot nas definições de experiência de utilizador da implementação. O período de tolerância define a quantidade de tempo após a instalação que o utilizador pode controlar a temporização de quando o dispositivo é reiniciado. Se o dispositivo não tiver sido reiniciado quando o período de tolerância expirar, será reiniciado automaticamente.

Segue-se um exemplo de criação de uma implementação para uma atualização de qualidade acelerada. Os dispositivos visados são especificados no passo seguinte.

Solicitação

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
        }
    }
}

Resposta

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
        }
    }
}

Passo 3: atribuir dispositivos à audiência de implementação

Após a criação da implementação, pode atribuir dispositivos à audiência de implementação. Quando a audiência de implementação é atualizada com êxito, Windows Update oferece a atualização para os dispositivos relevantes de acordo com as definições de implementação.

Os dispositivos são registados automaticamente quando adicionados às coleções de membros ou exclusões de uma audiência de implementação (ou seja, um objeto azureADDevice é criado automaticamente se ainda não existir).

O exemplo seguinte mostra como adicionar Microsoft Entra dispositivos como membros da audiência de implementação.

Solicitação

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)"
        }
    ]
}

Resposta

HTTP/1.1 202 Accepted

Durante uma implementação

Enquanto a implementação estiver em curso, pode colocar a implementação em pausa atualizando o respetivo estado e atualizando os respetivos membros de audiência e exclusões.

Após uma implementação

Depois de todos os dispositivos atribuídos a uma audiência de implementação terem sido inicialmente oferecidos a atualização, nem todos os dispositivos podem ter iniciado ou concluído a atualização, devido a fatores como a conectividade do dispositivo. Desde que a implementação ainda exista, garante que Windows Update está a oferecer a atualização aos dispositivos atribuídos sempre que se ligarem novamente.