Compartir a través de

Implementación de una actualización de características con Windows Autopatch

  • Artículo

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 artículo se centra en la implementación de actualizaciones de características. Para obtener información sobre cómo implementar actualizaciones de seguridad rápidas, consulte Implementación de una actualización de seguridad acelerada. 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.

Al implementar una actualización de características en un dispositivo, Windows Update ofrece la actualización especificada al dispositivo si aún no ha recibido la actualización. Por ejemplo, si implementa Windows 10 versión de actualización de características 20H2 en un dispositivo inscrito en la administración de actualizaciones de características y que se encuentra actualmente en una versión anterior de Windows 10, el dispositivo se actualiza a la versión 20H2. Si el dispositivo ya está en la versión 20H2 o posterior, permanece en su versión actual. Si el dispositivo no está inscrito en la administración de actualizaciones de características, esta operación no afecta al dispositivo.

Siempre que un dispositivo permanezca inscrito en la administración de actualizaciones de características, el dispositivo no recibirá ninguna otra actualización de características de Windows Update a menos que se implemente explícitamente con Windows Autopatch.

Importante

Al usar Windows Autopatch para actualizar dispositivos a Windows 11 (estableciendo el parámetro de versión de una implementación en "Windows 11, versión 21H2"), acepta que al aplicar este sistema operativo a un dispositivo (1) la licencia de Windows aplicable se compró a través de licencias por volumen, o (2) que está autorizado para enlazar su organización y está aceptando en su nombre la licencia de software de Microsoft pertinente. Términos que se encuentran aquí: Términos de licencia de software de Microsoft.

Requisitos previos

Paso 1: (Opcional) Obtener una lista de actualizaciones que se pueden implementar

Puede consultar la API de catálogo de Windows Autopatch para obtener una lista de actualizaciones que se pueden implementar en los dispositivos como contenido en una implementación.

En el ejemplo siguiente se muestra cómo consultar todas las actualizaciones de características de Windows que windows Autopatch puede implementar.

Solicitud

GET https://graph.microsoft.com/beta/admin/windows/updates/catalog/entries?$filter=isof('microsoft.graph.windowsUpdates.featureUpdateCatalogEntry')

Respuesta

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

{
    "value": [
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.featureUpdateCatalogEntry",
            "id": "d9049ddb-0ca8-4bc1-bd3c-41a456ef300f",
            "displayName": "Windows 11, version 22H2",
            "deployableUntilDateTime": "2025-10-14T00:00:00Z",
            "releaseDateTime": "2022-09-20T00:00:00Z",
            "version": "Windows 11, version 22H2",
            "buildNumber": "22621"
        },
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.featureUpdateCatalogEntry",
            "id": "7f4cee4c-9aa5-4e61-a4ca-c23a1bdba6f7",
            "displayName": "Windows 11",
            "deployableUntilDateTime": "2024-10-08T00:00:00Z",
            "releaseDateTime": "2021-10-04T00:00:00Z",
            "version": "Windows 11, version 21H2",
            "buildNumber": "22000"
        },
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.featureUpdateCatalogEntry",
            "id": "f341705b-0b15-4ce3-aaf2-6a1681d78606",
            "displayName": "Windows 10, version 22H2",
            "deployableUntilDateTime": "2025-10-14T00:00:00Z",
            "releaseDateTime": "2022-10-18T00:00:00Z",
            "version": "Windows 10, version 22H2",
            "buildNumber": "19045"
        },
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.featureUpdateCatalogEntry",
            "id": "53707a30-7816-448e-ab54-8cfedc48bfbc",
            "displayName": "Windows 10, version 21H2",
            "deployableUntilDateTime": "2024-06-11T00:00:00Z",
            "releaseDateTime": "2021-11-16T00:00:00Z",
            "version": "Windows 10, version 21H2",
            "buildNumber": "19044"
        }
    ]
}

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. Cuando se crea una implementación, se crea automáticamente una audiencia de implementación como una relación.

Puede crear una implementación como recomendada que no requiera ninguna intervención manual por parte del usuario final. También puede crear una implementación como opcional que permita al usuario final descargar e instalar la actualización a su conveniencia.

En el ejemplo siguiente se muestra cómo crear una implementación opcional de una actualización de características, con opciones opcionales que configuran la programación de implementación y las reglas de supervisión. Las medidas de seguridad se aplican de forma predeterminada. 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.featureUpdateCatalogEntry",
            "id": "cd45877c-87a9-4ed1-b184-fd89230207b1"
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "schedule": {
            "gradualRollout": {
                "@odata.type": "#microsoft.graph.windowsUpdates.rateDrivenRolloutSettings",
                "durationBetweenOffers": "P7D",
                "devicePerOffer": 100
            }
        },
        "monitoring": {
            "monitoringRules": [
                {
                    "signal": "rollback",
                    "threshold": 5,
                    "action": "pauseDeployment"
                }
            ]
        },
        "userExperience": {
            "offerAsOptional": false,
            "daysUntilForcedReboot": null
        }
    }
}

Respuesta

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

{
    "@odata.type": "#microsoft.graph.windowsUpdates.deployment",
    "id": "b5171742-1742-b517-4217-17b5421717b5",
    "state": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentState",
        "value": "offering",
        "reasons": [],
        "requestedValue": "none",
        "effectiveSinceDate": "String (timestamp)"
    },
    "content": {
        "@odata.type": "#microsoft.graph.windowsUpdates.catalogContent"
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "schedule": {
            "gradualRollout": {
                "@odata.type": "#microsoft.graph.windowsUpdates.rateDrivenRolloutSettings",
                "durationBetweenOffers": "P7D",
                "devicePerOffer": 100
            }
        },
        "monitoring": {
            "monitoringRules": [
                {
                    "@odata.type": "#microsoft.graph.windowsUpdates.monitoringRule",
                    "signal": "rollback",
                    "threshold": 5,
                    "action": "pauseDeployment"
                }
            ]
        },
        "userExperience": {
            "offerAsOptional": false, 
            "daysUntilForcedReboot": null
        }
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}

Paso 3: Asignación de dispositivos a la audiencia de implementación

Una vez creada una implementación, puede asignar dispositivos a la audiencia de implementación. Una vez que la audiencia de implementación se actualiza correctamente, Windows Update comienza a ofrecer 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 una implementación está en curso, puede pausar la implementación actualizando su estado, así como actualizando sus miembros de audiencia y exclusiones.

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. Mientras la implementación siga existiendo, Windows Update sigue ofreciendo la actualización a los dispositivos asignados cada vez que se vuelvan a conectar.