Gerir salvaguardas com o Windows Autopatch

Quando implementa atualizações com o Windows Autopatch, as implementações são automaticamente salvaguardadas ao impedir que os dispositivos com problemas conhecidos ou prováveis sejam disponibilizados pela Windows Update.

As salvaguardas são compatíveis com implementações de atualizações de funcionalidades Windows 11 e Windows 10. As suspensões de salvaguarda contra problemas conhecidos estão disponíveis para implementações de atualizações de funcionalidades Windows 11 e Windows 10, e estão disponíveis proteções contra problemas prováveis para implementações de Windows 11.

Aplicar todas as salvaguardas

Por predefinição, todas as salvaguardas aplicáveis são aplicadas aos dispositivos numa implementação. Para beneficiar de salvaguardas, não precisa de especificar mais nada ao criar uma implementação.

O exemplo seguinte demonstra como criar uma implementação com todas as salvaguardas 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

Pode optar ativamente por não participar em salvaguardas contra problemas prováveis numa implementação ao configurar as definições de salvaguarda. Se necessário, também pode optar ativamente por não participar em suspensões de salvaguarda para problemas conhecidos através da política de desativação de salvaguardas.

O exemplo seguinte demonstra como criar uma implementação sem salvaguardas contra problemas prováveis. Ao especificar um safeguardProfile para a categoria de likelyIssues na lista de perfis de salvaguarda a desativar, está a configurar a implementação para oferecer a atualização a um dispositivo, mesmo que seja provável que 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)"
}