Compartilhar via


Implantar uma atualização de qualidade acelerada usando o serviço de implantação do Windows Update for Business

Com o serviço de implantação Windows Update for Business, você pode implantar atualizações do Windows em dispositivos em um locatário Microsoft Entra. Hoje, o serviço de implantação dá suporte a implantações de atualizações de recursos Windows 10/11, atualizações de qualidade aceleradas e atualizações de driver. Este tópico se concentra em implantações de atualizações de qualidade aceleradas. Para obter informações sobre como implantar atualizações de recursos, consulte Implantar uma atualização de recurso. Para obter informações sobre como implantar atualizações de driver, consulte Gerenciar atualização do driver.

Acelerar uma atualização de qualidade substitui as políticas de adiamento Windows Update for Business para que a atualização seja instalada o mais rápido possível. Pode ser útil quando eventos críticos de qualidade surgem e você precisa implantar as atualizações mais recentes mais rapidamente do que o normal. No entanto, embora possa ajudar a alcançar metas de conformidade em relação a uma atualização de qualidade específica, ela não foi projetada para ser usada todos os meses. Em vez disso, considere usar prazos de conformidade para atualizações.

Quando você implanta uma atualização de qualidade acelerada em um dispositivo, Windows Update oferece a atualização aplicável mais recente ao dispositivo se ele ainda não tiver recebido a atualização com a data de lançamento especificada. Por exemplo, se você implantar a atualização de segurança Windows 10 lançada em 13 de abril de 2021 em um dispositivo que não tem a atualização atualmente, o dispositivo receberá uma atualização acelerada. Se o dispositivo já tiver a atualização especificada ou mais recente, ele 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

Etapa 1: (Opcional) Obter uma lista de atualizações agilizáveis

Você pode consultar o catálogo de serviços de implantação para obter uma lista de atualizações que podem ser aceleradas para dispositivos como conteúdo em uma implantação.

As atualizações de qualidade são representadas pelo tipo qualityUpdateCatalogEntry , com uma qualidadeUpdateClassification de security ou nonSecurity. Todos os Windows 10 atualizações de qualidade 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 produto. Adicione $expand=microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions à URL de solicitação para identificar os builds do sistema operacional afetados por cada atualização de qualidade.

O exemplo a seguir mostra como consultar todas as atualizações de qualidade Windows 10 que podem ser implantadas como atualizações aceleradas pelo serviço de implantação. Recomendamos mostrar apenas as três atualizações mais atuais, de modo que o exemplo a seguir inclua $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"
                    }
                }
            ]
        }
    ]
}

Etapa 2: criar uma implantação

Uma implantação especifica o conteúdo a ser implantado, como e quando implantar o conteúdo e os dispositivos de destino. Para atualizações de qualidade, o conteúdo é especificado usando uma data de conformidade de destino. Quando uma implantação é criada, um público de implantação é criado automaticamente como uma relação.

Quando você implanta uma atualização de qualidade acelerada em um dispositivo, Windows Update oferece uma atualização que traz o dispositivo acima do nível mínimo de conformidade especificado. Dependendo de quando cada dispositivo verifica e atualiza, 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 atendem ao padrão de conformidade de atualização de segurança especificado. Esse comportamento de oferecer a atualização aplicável mais recente, indicada pela propriedade equivalenteContent que está sendo definida como o valor latestSecuritypadrão, ajuda a manter os dispositivos o mais seguros possível e impede que um dispositivo receba uma atualização acelerada seguida por outra atualização regular apenas alguns dias depois.

Nota: Se você implantar uma atualização acelerada de qualidade sem segurança, ela deve ser a atualização de qualidade mais recente lançada. Por exemplo, se você agilizar a versão 11D após o lançamento do 12B, nenhuma atualização será acelerada para os dispositivos na implantação.

Você pode configurar o período de carência de reinicialização do dispositivo usando os dias de propriedadeUntilForcedReboot nas configurações de experiência do usuário da implantação. O período de carência define a quantidade de tempo após a instalação que o usuário pode controlar o tempo de quando o dispositivo é reiniciado. Se o dispositivo não tiver sido reiniciado quando o período de carência expirar, ele será reiniciado automaticamente.

Veja abaixo um exemplo de criação de uma implantação para uma atualização de qualidade acelerada. Os dispositivos de destino são especificados na próxima etapa.

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

Etapa 3: Atribuir dispositivos ao público de implantação

Depois que a implantação for criada, você poderá atribuir dispositivos ao público de implantação. Quando o público de implantação é atualizado com êxito, Windows Update oferece a atualização para os dispositivos relevantes de acordo com as configurações de implantação.

Os dispositivos são registrados automaticamente com o serviço quando adicionados às coleções de membros ou exclusões de um público de implantação (ou seja, um objeto azureADDevice é criado automaticamente se ele ainda não existir).

O exemplo a seguir mostra como adicionar dispositivos Microsoft Entra como membros do público de implantaçã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 implantação

Enquanto a implantação estiver em andamento, você pode pausar a implantação atualizando seu estado e atualizando seus membros de audiência e exclusões.

Após uma implantação

Depois que todos os dispositivos atribuídos a um público de implantação tiverem sido inicialmente oferecidos a atualização, nem todos os dispositivos podem ter iniciado ou concluído a atualização, devido a fatores como conectividade do dispositivo. Enquanto a implantação ainda existir, ela garante que Windows Update esteja oferecendo a atualização para os dispositivos atribuídos sempre que eles se reconectarem.