Windows Autopatch を使用してデプロイをスケジュールする

[アーティクル]
11/07/2024

Windows Autopatch を使用して更新プログラムを展開する場合は、デバイスが将来の日付に更新プログラムを受け取るように展開をスケジュールできます。

スケジュール機能は、Windows 10/Windows 11機能更新プログラムのデプロイと互換性があります。

将来の日付から開始するようにデプロイをスケジュールする

スケジュール設定を構成することで、将来の日付から開始するようにデプロイをスケジュールできます。次の例では、デプロイが割り当てられているすべてのデバイスに、2021 年 7 月 1 日に更新プログラムが提供されます。

要求

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",
        "schedule": {
            "startDateTime": "2021-07-01T17:00:00Z",
        }
    }
}

応答

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",
        "schedule": {
            "startDateTime": "2021-07-01T17:00:00Z",
            "gradualRollout": null
        },
        "monitoring": null,
        "userExperience": null
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}

一定期間にわたってデプロイをステージングする

また、割り当てられたデバイスが、時間の経過と同時に段階的なロールアウトで更新プログラムを提供されるように、デプロイをスケジュールすることもできます。この更新プログラムは、展開に割り当てられたデバイスのサブセットに定期的に提供され、ロールアウトの合計期間は終了日またはオファリングレートによって決定されます。段階的なロールアウトは、定期的な予定表イベントシリーズと似ていると考えても良い。

例: 開始日と終了日の間に一定の間隔でデプロイをステージングする

時間の経過と同時にデプロイをステージングする方法の 1 つは、デプロイの endDateTime を設定することです。展開に割り当てられたすべてのデバイスは、 startDateTime と endDateTime の間のウィンドウ内で更新プログラムが提供されます。 startDateTime が指定されていない場合、デバイスが割り当てられるとすぐにデプロイが開始されます。

この例では、新しい展開を構成して、2021 年 7 月 1 日から毎週更新プログラム (durationBetweenOffers が 7 日に設定) を提供するように、新しいデバイスセットを構成します。すべてのデバイスは、2021 年 8 月 1 日より前に更新プログラムを提供されます。

要求

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",
        "schedule": {
            "startDateTime": "2021-07-01T17:00:00Z",
            "gradualRollout": {
                "@odata.type": "#microsoft.graph.windowsUpdates.dateDrivenRolloutSettings",
                "endDateTime": "2021-08-01T17:00:00Z",
                "durationBetweenOffers": "P7D"
            }
        }
    }
}

応答

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",
        "schedule": {
            "startDateTime": "2021-07-01T17:00:00Z",
            "gradualRollout": {
                "@odata.type": "#microsoft.graph.windowsUpdates.dateDrivenRolloutSettings",
                "endDateTime": "2021-08-01T17:00:00Z",
                "durationBetweenOffers": "P7D"
            }
        }
        "monitoring": null,
        "userExperience": null
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}

例: 各オファーで指定した数のデバイスを使用して、定期的にデプロイをステージングする

時間の経過と同時にデプロイをステージングするもう 1 つの方法は、 devicesPerOfferを使用してオファリングレートを構成することです。展開に割り当てられたデバイスは、すべてのデバイスに更新プログラムが提供されるまで、指定されたレートに従って更新プログラムが提供されます。

この例では、新しい展開を構成して、2021 年 7 月 1 日から毎週更新プログラム (durationBetweenOffers が 7 日に設定) を提供するように、新しいデバイスセットを構成します。すべてのデバイスに更新プログラムが提供されるまで、一度に 100 台のデバイスが更新プログラムを提供されます。

要求

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",
        "schedule": {
            "startDateTime": "2020-07-01T17:00:00Z",
            "gradualRollout": {
                "@odata.type": "#microsoft.graph.windowsUpdates.rateDrivenRolloutSettings",
                "durationBetweenOffers": "P7D",
                "devicePerOffer": 100
            }
        }
    }
}

応答

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",
        "schedule": {
            "startDateTime": "2020-07-01T17:00:00Z",
            "gradualRollout": {
                "@odata.type": "#microsoft.graph.windowsUpdates.rateDrivenRolloutSettings",
                "durationBetweenOffers": "P7D",
                "devicePerOffer": 100
            }
        },
        "monitoring": null,
        "userExperience": null
    },
    "createdDateTime": "String (timestamp)",
    "lastModifiedDateTime": "String (timestamp)"
}

次の方法で共有

Windows Autopatch を使用してデプロイをスケジュールする

将来の日付から開始するようにデプロイをスケジュールする

要求

応答

一定期間にわたってデプロイをステージングする

例: 開始日と終了日の間に一定の間隔でデプロイをステージングする

要求

応答

例: 各オファーで指定した数のデバイスを使用して、定期的にデプロイをステージングする

要求

応答

フィードバック

その他のリソース