Implementación de una actualización de calidad acelerada con Windows Autopatch
Con Windows Autopatch, puedes implementar actualizaciones de Windows en dispositivos en un inquilino de Microsoft Entra. En la actualidad, Windows Autopatch admite la implementación de actualizaciones de características de Windows 10/11, actualizaciones de calidad de hotpatch, actualizaciones de calidad aceleradas y actualizaciones de controladores. Este tema se centra en la implementación de actualizaciones de calidad aceleradas. Para obtener información sobre la implementación de actualizaciones de características, consulte Implementación de una actualización de características. Para obtener información sobre cómo implementar actualizaciones de calidad de hotpatch, consulte Implementación de una actualización de calidad de hotpatch. Para obtener información sobre cómo implementar actualizaciones de controladores, consulte Administración de actualizaciones de controladores.
La aceleración de una actualización de calidad invalida las directivas de aplazamiento de Windows Update para empresas para que la actualización se instale lo antes posible. Puede ser útil cuando surjan eventos críticos de calidad y tenga que implementar las actualizaciones más recientes más rápidamente de lo normal. Sin embargo, aunque puede ayudar a lograr los objetivos de cumplimiento con una actualización de calidad específica, no está diseñada para usarse cada mes. En su lugar, considere la posibilidad de usar las fechas límite de cumplimiento para las actualizaciones.
Al implementar una actualización de calidad acelerada en un dispositivo, Windows Update ofrece la última actualización aplicable al dispositivo si aún no ha recibido la actualización con la fecha de lanzamiento especificada. Por ejemplo, si implementa la actualización de seguridad Windows 10 publicada el 13 de abril de 2021 en un dispositivo que no tiene actualmente la actualización, el dispositivo recibe una actualización acelerada. Si el dispositivo ya tiene la actualización especificada o una versión más reciente, no recibe una actualización rápida.
Las actualizaciones de calidad aceleradas también tienen las siguientes características:
- La actualización se inicia inmediatamente en lugar de esperar al siguiente examen de actualización normal, que se produce una vez cada 22 horas de forma predeterminada.
- La actualización se descarga e instala lo antes posible.
- El proceso de actualización invalida las opciones de directiva de dispositivo configuradas, como los días hasta que el dispositivo se ve obligado a reiniciarse. Una vez instalada la actualización acelerada, el dispositivo vuelve a la configuración de directiva actual.
Requisitos previos
- Los dispositivos cumplen los requisitos previos para Windows Autopatch.
- Los dispositivos instalaron la actualización descrita en KB4023057: actualización para Windows 10 componentes de Update Service (o una versión más reciente).
- Para comprobar que los dispositivos cumplen los requisitos previos para recibir una actualización rápida, use la prueba de preparación para acelerar las actualizaciones.
Paso 1: (Opcional) Obtener una lista de actualizaciones rápidas
Puede consultar la API de catálogo de Windows Autopatch para obtener una lista de actualizaciones que se pueden acelerar en los dispositivos como contenido en una implementación.
Las actualizaciones de calidad se representan mediante el tipo qualityUpdateCatalogEntry , con un valor qualityUpdateClassification de security
o nonSecurity
. Todas las actualizaciones de calidad Windows 10 que se clasifican como security
y todas Windows 11 actualizaciones de calidad que se clasifican como security
o non-security
se pueden acelerar.
Todas las actualizaciones de calidad hacen referencia a una lista de revisiones de productos. Agregue $expand=microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions
a la dirección URL de la solicitud para identificar qué sistema operativo compila cada actualización de calidad que afecta.
En el ejemplo siguiente se muestra cómo consultar todas las actualizaciones de calidad de Windows 10 que windows Autopatch puede implementar como actualizaciones rápidas. Se recomienda mostrar solo las tres actualizaciones más recientes, por lo que en el ejemplo siguiente se incluye $top=3
.
Solicitud
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
Respuesta
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"
}
}
]
}
]
}
Paso 2: Creación de una implementación
Una implementación especifica el contenido que se va a implementar, cómo y cuándo implementar el contenido y los dispositivos de destino. Para las actualizaciones de calidad, el contenido se especifica mediante una fecha de cumplimiento de destino. Cuando se crea una implementación, se crea automáticamente una audiencia de implementación como una relación.
Al implementar una actualización de calidad acelerada en un dispositivo, Windows Update ofrece una actualización que sitúa el dispositivo por encima del nivel de cumplimiento mínimo especificado. En función de cuándo examine y actualice cada dispositivo, algunos dispositivos pueden recibir actualizaciones más recientes (por ejemplo, una actualización de seguridad más reciente que la que corresponde al nivel de cumplimiento mínimo), pero todos los dispositivos cumplen el estándar de cumplimiento de actualización de seguridad especificado. Este comportamiento de ofrecer la actualización aplicable más reciente, indicada por la propiedad equivalenteContent que se establece en el valor latestSecurity
predeterminado, ayuda a mantener los dispositivos lo más seguros posible e impide que un dispositivo reciba una actualización rápida seguida de otra actualización regular solo unos días después.
Nota: Si implementa una actualización de calidad no de seguridad acelerada, debe ser la actualización de calidad más reciente publicada. Por ejemplo, si acelera la versión 11D después de que se haya publicado 12B, no se acelerará ninguna actualización en los dispositivos de la implementación.
Puede configurar el período de gracia de reinicio del dispositivo mediante la propiedad daysUntilForcedReboot en la configuración de la experiencia del usuario de la implementación. El período de gracia establece la cantidad de tiempo después de la instalación que el usuario puede controlar el tiempo de reinicio del dispositivo. Si el dispositivo no se ha reiniciado en el momento en que expira el período de gracia, se reinicia automáticamente.
A continuación se muestra un ejemplo de creación de una implementación para una actualización de calidad acelerada. Los dispositivos de destino se especifican en el paso siguiente.
Solicitud
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
}
}
}
Respuesta
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
}
}
}
Paso 3: Asignación de dispositivos a la audiencia de implementación
Una vez creada la implementación, puede asignar dispositivos a la audiencia de implementación. Cuando la audiencia de implementación se actualiza correctamente, Windows Update ofrece la actualización a los dispositivos pertinentes según la configuración de implementación.
Los dispositivos se registran automáticamente cuando se agregan a las colecciones de miembros o exclusiones de una audiencia de implementación (es decir, se crea automáticamente un objeto azureADDevice si aún no existe).
En el ejemplo siguiente se muestra cómo agregar Microsoft Entra dispositivos como miembros de la audiencia de implementación.
Solicitud
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)"
}
]
}
Respuesta
HTTP/1.1 202 Accepted
Durante una implementación
Mientras la implementación está en curso, puede pausar la implementación actualizando su estado y actualizando los miembros y exclusiones de la audiencia.
Después de una implementación
Después de que se haya ofrecido inicialmente la actualización a todos los dispositivos asignados a una audiencia de implementación, es posible que no todos los dispositivos hayan iniciado o completado la actualización, debido a factores como la conectividad de dispositivos. Siempre que la implementación siga existiendo, garantiza que Windows Update ofrezca la actualización a los dispositivos asignados cada vez que se vuelvan a conectar.