Gérer les protections à l’aide du service de déploiement Windows Update for Business

Lorsque vous déployez des mises à jour avec le service de déploiement, le service protège automatiquement les déploiements en empêchant les appareils présentant des problèmes connus ou probables de recevoir la mise à jour par Windows Update.

Les protections sont compatibles avec les déploiements de Windows 11 et les mises à jour des fonctionnalités Windows 10. Les conservations de protection contre les problèmes connus sont disponibles pour les déploiements de Windows 11 et de mises à jour de fonctionnalités Windows 10, et des conservations de protection contre les problèmes probables sont disponibles pour les déploiements de Windows 11.

Appliquer toutes les protections

Par défaut, le service de déploiement applique toutes les protections applicables aux appareils dans un déploiement. Pour bénéficier de protections, vous n’avez pas besoin de spécifier quoi que ce soit d’autre lors de la création d’un déploiement.

L’exemple suivant montre comment créer un déploiement avec toutes les protections appliquées.

Demande

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

Réponse

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

Refuser les dispositifs de protection contre les problèmes probables

Vous pouvez désactiver les protections contre les problèmes probables dans un déploiement en configurant les paramètres de protection. Si nécessaire, vous pouvez également désactiver les conservations de protection pour les problèmes connus à l’aide de la stratégie désactiver les protections.

L’exemple suivant montre comment créer un déploiement sans protection contre les problèmes probables. En spécifiant un safeguardProfile pour la catégorie de likelyIssues sous la liste des profils de protection à désactiver, vous configurez le déploiement pour proposer la mise à jour à un appareil, même s’il est susceptible d’avoir un problème de mise à jour.

Demande

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

Réponse

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