Gerenciar proteções usando o Windows Autopatch

Quando você implanta atualizações com o Windows Autopatch, as implantações são protegidas automaticamente, impedindo que dispositivos com problemas conhecidos ou prováveis recebam a oferta da atualização pelo Windows Update.

As proteções são compatíveis com implantações de atualizações de recursos do Windows 11 e do Windows 10. As retenções de proteção contra problemas conhecidos estão disponíveis para implantações de atualizações de recursos do Windows 11 e do Windows 10, e as retenções de proteção contra problemas prováveis estão disponíveis para implantações do Windows 11.

Aplicar todas as proteções

Por padrão, todas as proteções aplicáveis são aplicadas aos dispositivos em uma implantação. Para se beneficiar das proteções, você não precisa especificar nada adicional ao criar uma implantação.

O exemplo a seguir demonstra como criar uma implantação com todas as proteções aplicadas.

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.featureUpdateCatalogEntry",
            "id": "catalog/entries/1"
        }
    }
}

Resposta

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": [
            {
                "@odata.type": "microsoft.graph.windowsUpdates.deploymentStateReason",
                "value": "offeringByRequest"
            }
        ],
        "requestedValue": "none",
        "effectiveSinceDate": "String (timestamp)"
    },
    "content": {
        "@odata.type": "#microsoft.graph.windowsUpdates.catalogContent",
        }
    },
    "settings": null,
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}

Recusar proteções contra problemas prováveis

Você pode desativar as proteções contra possíveis problemas em uma implantação definindo as configurações de proteção. Se necessário, você também pode recusar retenções de proteção para problemas conhecidos usando a política de proteção desabilitada.

O exemplo a seguir demonstra como criar uma implantação sem proteções contra possíveis problemas. Ao especificar um safeguardProfile para a categoria de likelyIssues sob a lista de perfis de proteção a serem desabilitados, você está configurando a implantação para oferecer a atualização para um dispositivo, mesmo que seja provável que ele tenha um problema de atualização.

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.featureUpdateCatalogEntry",
            "id": "catalog/entries/1"
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "contentApplicability": {
            "safeguard": {
                "disabledSafeguardProfiles": [
                    {
                        "category": "likelyIssues"
                    }
                ]
            }
        }
    }
}

Resposta

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": [
            {
                "@odata.type": "microsoft.graph.windowsUpdates.deploymentStateReason",
                "value": "offeringByRequest"
            }
        ],
        "requestedValue": "none",
        "effectiveSinceDate": "String (timestamp)"
    },
    "content": {
        "@odata.type": "#microsoft.graph.windowsUpdates.catalogContent",
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "monitoring": null,
        "schedule": null,
        "userExperience": null,
        "contentApplicability": {
            "safeguard": {
                "disabledSafeguardProfiles": [
                    {
                        "@odata.type": "#microsoft.graph.windowsUpdates.safeguardProfile",
                        "category": "likelyIssues"
                    }
                ]
            }
        }
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}