Windows Update for Business デプロイサービスを使用して迅速な更新プログラムを展開する

[アーティクル]
04/05/2024
適用対象:

✅ Windows 11, ✅ Windows 10

この記事では、次の操作を行います。

Graph エクスプローラーを開く
クエリを実行してテストデバイスを識別する
迅速な更新のカタログエントリを一覧表示する
デプロイを作成する
デプロイ対象ユーザーにメンバーを追加する
デプロイを削除する

前提条件

Update Health Tools がクライアントにインストールされていることを確認するなど、Windows Update for Business デプロイサービスのすべての前提条件を満たす必要があります。

Update Health Tools は、KB4023057以降にインストールされます。デバイスに Update Health Tools が存在することを確認するには、次のいずれかの方法を使用します。
- 迅速な更新プログラムの準備テストを実行する
- フォルダー C:\Program Files\Microsoft Update Health Tools を探すか、「Microsoft Update Health Tools のプログラムの削除」を確認します。
- ツールのインストールを確認するための PowerShell スクリプトの例: Get-CimInstance -ClassName Win32_Product \| Where-Object {$_.Name -match "Microsoft Update Health Tools"}

アクセス許可

この記事に記載されているクエリには、次のアクセス許可が必要です。

WindowsUpdates.ReadWrite.All for Windows Update for Business 展開サービス操作。
デバイス情報を表示するための Device.Read.All 以上のアクセス許可。

Windows Update展開管理者などの一部のロールには、既にこれらのアクセス許可があります。

Graph エクスプローラーを開く

この記事では、Graph エクスプローラーを使用して、Microsoft Graph API に対してデータの取得、追加、削除、更新を要求します。 Graph エクスプローラーは、Microsoft Graph API について学習できる開発者ツールです。 Graph エクスプローラーの使用方法の詳細については、「Graph エクスプローラーの概要」を参照してください。

Warning

この記事に記載されている要求では、Microsoft 365 アカウントでサインインする必要があります。必要に応じて、Microsoft 365 Business Premiumで無料の 1 か月間試用版を利用できます。
テストテナントを使用してデプロイプロセスを学習して確認することを強くお勧めします。グラフエクスプローラーは、学習ツールを目的としています。続行する前に、Graph エクスプローラーの同意の付与と同意の種類を理解していることを確認してください。

ブラウザーから [Graph エクスプローラー] に移動し、Microsoft Entra ユーザーアカウントを使用してサインインします。
この記事のクエリを使用するには、 WindowsUpdates.ReadWrite.All アクセス許可を有効にする必要がある場合があります。アクセス許可を有効にするには:
1. Graph エクスプローラーの [アクセス許可の変更] タブを選択します。
2. [アクセス許可] ダイアログボックスで、[ WindowsUpdates.ReadWrite.All ] アクセス許可を選択し、[同意] を選択 します。同意を付与するには、もう一度サインインする必要がある場合があります。
要求を行うには:
1. HTTP メソッドのドロップダウンリストから GET、POST、PUT、PATCH、または DELETE のいずれかを選択します。
2. URL フィールドに要求を入力します。バージョンは、URL に基づいて自動的に設定されます。
3. 要求本文を変更する必要がある場合は、[ 要求本文] タブを編集します。
4. [ クエリの実行 ] ボタンを選択します。結果が [応答 ] ウィンドウに表示されます。
ヒント

Microsoft Graph のドキュメントを確認すると、通常、要求の例にが一覧表示content-type: application/jsonされる場合があります。 content-type Graph エクスプローラーでは通常を指定する必要はありませんが、[ヘッダー] タブを選択し、[要求ヘッダー] フィールドに [キーapplication/json] と [値] としてを追加することで、要求に追加content-typeできます。

クエリを実行してデバイスを識別する

デバイスリソースの種類を使用して、デプロイサービスに登録するクライアントを検索します。特定のニーズに合わせてクエリパラメーターを変更します。詳細については、「クエリパラメーターを使用する」を参照してください。

すべてのデバイスの AzureAD デバイス ID と名前を表示します。
```
GET https://graph.microsoft.com/v1.0/devices?$select=deviceid,displayName
```

で始まる名前を持つデバイスのAzureAD デバイス ID と名前をTest表示します。

GET https://graph.microsoft.com/v1.0/devices?$filter=startswith(displayName,'Test')&$select=deviceid,displayName

高度なクエリの要求ヘッダーを追加する

次の要求の場合は、 ConsistencyLevel ヘッダーをに eventual設定します。高度なクエリパラメーターの詳細については、「Microsoft Entra ディレクトリオブジェクトの高度なクエリ機能」を参照してください。

[Graph エクスプローラー] で、[要求ヘッダー] タブを選択します。
[キーの種類] と [ConsistencyLevel値] に「」と入力しますeventual。
[ 追加 ] ボタンを選択します。完了したら、ごみ箱のアイコンを選択して要求ヘッダーを削除します。

AzureAD デバイス ID として持つ01234567-89ab-cdef-0123-456789abcdefデバイスの名前とオペレーティングシステムのバージョンを表示します。
```
GET https://graph.microsoft.com/v1.0/devices?$search="deviceid:01234567-89ab-cdef-0123-456789abcdef"&$select=displayName,operatingSystemVersion
```
仮想マシンではない可能性があるデバイスを見つけるには、モデルとして仮想マシンが一覧表示されていないが製造元が一覧表示されているデバイスをフィルター処理します。各 デバイスの AzureAD デバイス ID、名前、 オペレーティングシステムのバージョン を表示します。
```
GET https://graph.microsoft.com/v1.0/devices?$filter=model ne 'virtual machine' and NOT(manufacturer eq null)&$count=true&$select=deviceid,displayName,operatingSystemVersion
```

ヒント

通常、デバイスリソースの種類を使用する要求には、 id との両方がありますdeviceid。

deviceidはデバイス ID Microsoft Entraであり、この記事で使用されます。
- この記事の後半では、これは deviceid 、展開対象ユーザーにデバイスを追加するなど、特定の要求を行うときのとして id 使用されます。
idデバイスリソースの種類のは通常、Microsoft Entra オブジェクト ID です。この記事では使用しません。

迅速な更新のカタログエントリを一覧表示する

各更新プログラムは、一意のカタログエントリに関連付けられます。カタログにクエリを実行して、迅速に実行できる更新プログラムを見つけることができます。 id返されるはカタログ ID で、デプロイの作成に使用されます。次のクエリでは、展開サービスによって迅速な更新プログラムとしてデプロイできる、セキュリティとセキュリティ以外の品質のすべての更新プログラムを一覧表示します。を使用 $top=2 して順序付けすると ReleaseDateTimeshows 、迅速に展開できる最新の更新プログラムが表示されます。

GET https://graph.microsoft.com/beta/admin/windows/updates/catalog/entries?$filter=isof('microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry') and microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/isExpeditable eq true&$orderby=releaseDateTime desc&$top=2

次の切り捨てられた応答には、セキュリティ更新プログラムの e317aa8a0455ca604de95329b524ec921ca57f2e6ed3ff88aac757a7468998a5カタログ ID が08/08/2023 - 2023.08 B SecurityUpdate for Windows 10 and later表示されます。

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries",
    "value": [
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry",
            "id": "e317aa8a0455ca604de95329b524ec921ca57f2e6ed3ff88aac757a7468998a5",
            "displayName": "08/08/2023 - 2023.08 B SecurityUpdate for Windows 10 and later",
            "deployableUntilDateTime": null,
            "releaseDateTime": "2023-08-08T00:00:00Z",
            "isExpeditable": true,
            "qualityUpdateClassification": "security",
            "catalogName": "2023-08 Cumulative Update for Windows 10 and later",
            "shortName": "2023.08 B",
            "qualityUpdateCadence": "monthly",
            "cveSeverityInformation": {
                "maxSeverity": "critical",
                "maxBaseScore": 9.8,
                "exploitedCves@odata.context": "https://graph.microsoft.com/$metadata#admin/windows/updates/catalog/entries('e317aa8a0455ca604de95329b524ec921ca57f2e6ed3ff88aac757a7468998a5')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/cveSeverityInformation/exploitedCves",
                "exploitedCves": [
                    {
                        "number": "ADV230003",
                        "url": "https://msrc.microsoft.com/update-guide/vulnerability/ADV230003"
                    },
                    {
                        "number": "CVE-2023-38180",
                        "url": "https://msrc.microsoft.com/update-guide/vulnerability/CVE-2023-38180"
                    }
                ]
            }
        }
    ]
}

デプロイサービスでは、2023 年 1 月以降にリリースされた更新プログラムに関する詳細情報を表示できます。製品リビジョンを使用すると、KB 番号やなど、更新プログラムに関する追加情報が提供されますMajorVersion.MinorVersion.BuildNumber.UpdateBuildRevision。 Windows 10と 11 は、同じメジャーバージョンとマイナーバージョンを共有しますが、ビルド番号は異なります。

最新の品質更新プログラムの製品リビジョン情報を表示するには、次を使用します。

GET https://graph.microsoft.com/beta/admin/windows/updates/catalog/entries?$expand=microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions&$orderby=releaseDateTime desc&$top=1

次の切り捨てられた応答は、Windows 10、バージョン 22H2、バージョン 22H2 のKB5029244に関する情報を表示し、Windows 11 バージョン 22H2 のKB5029263を表示します。

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries(microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions())",
    "value": [
        {
            "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry",
            "id": "e317aa8a0455ca604de95329b524ec921ca57f2e6ed3ff88aac757a7468998a5",
            "displayName": "08/08/2023 - 2023.08 B SecurityUpdate for Windows 10 and later",
            "deployableUntilDateTime": null,
            "releaseDateTime": "2023-08-08T00:00:00Z",
            "isExpeditable": true,
            "qualityUpdateClassification": "security",
            "catalogName": "2023-08 Cumulative Update for Windows 10 and later",
            "shortName": "2023.08 B",
            "qualityUpdateCadence": "monthly",
            "cveSeverityInformation": {
                "maxSeverity": "critical",
                "maxBaseScore": 9.8,
                "exploitedCves@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('e317aa8a0455ca604de95329b524ec921ca57f2e6ed3ff88aac757a7468998a5')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/cveSeverityInformation/exploitedCves",
                "exploitedCves": [
                    {
                        "number": "ADV230003",
                        "url": "https://msrc.microsoft.com/update-guide/vulnerability/ADV230003"
                    },
                    {
                        "number": "CVE-2023-38180",
                        "url": "https://msrc.microsoft.com/update-guide/vulnerability/CVE-2023-38180"
                    }
                ]
            },
            "productRevisions@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('e317aa8a0455ca604de95329b524ec921ca57f2e6ed3ff88aac757a7468998a5')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions",
            "productRevisions": [
                {
                    "id": "10.0.19045.3324",
                    "displayName": "Windows 10, version 22H2, build 19045.3324",
                    "releaseDateTime": "2023-08-08T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 10",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 19045,
                        "updateBuildRevision": 3324
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('e317aa8a0455ca604de95329b524ec921ca57f2e6ed3ff88aac757a7468998a5')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.19045.3324')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5029244",
                        "url": "https://support.microsoft.com/help/5029244"
                    }
                },
                {
                    "id": "10.0.22621.2134",
                    "displayName": "Windows 11, version 22H2, build 22621.2134",
                    "releaseDateTime": "2023-08-08T00:00:00Z",
                    "version": "22H2",
                    "product": "Windows 11",
                    "osBuild": {
                        "majorVersion": 10,
                        "minorVersion": 0,
                        "buildNumber": 22621,
                        "updateBuildRevision": 2134
                    },
                    "knowledgeBaseArticle@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/catalog/entries('e317aa8a0455ca604de95329b524ec921ca57f2e6ed3ff88aac757a7468998a5')/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry/productRevisions('10.0.22621.2134')/knowledgeBaseArticle/$entity",
                    "knowledgeBaseArticle": {
                        "id": "KB5029263",
                        "url": "https://support.microsoft.com/help/5029263"
                    }
                },

デプロイを作成する

デプロイを作成するときは、デプロイの動作を定義するために複数のオプションを使用できます。次の例では、カタログエントリ ID を使用して08/08/2023 - 2023.08 B SecurityUpdate for Windows 10 and laterセキュリティ更新プログラムのデプロイをe317aa8a0455ca604de95329b524ec921ca57f2e6ed3ff88aac757a7468998a5作成し、要求本文でおよび userExperience 展開オプションを定義しますexpedite。

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.qualityUpdateCatalogEntry",
            "id": "e317aa8a0455ca604de95329b524ec921ca57f2e6ed3ff88aac757a7468998a5"
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "expedite": {
            "isExpedited": true
        },
        "userExperience": {
            "daysUntilForcedReboot": 2
        }
    }
}

要求は、新しく作成されたデプロイの応答本文に 201 Created 応答コードとデプロイオブジェクトを返します。これには、次のものが含まれます。

新しく作成されたデプロイのデプロイ IDde910e12-3456-7890-abcd-ef1234567890 。
新しく作成されたデプロイ対象ユーザーの対象ユーザー IDd39ad1ce-0123-4567-89ab-cdef01234567 。

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/deployments/$entity",
    "id": "de910e12-3456-7890-abcd-ef1234567890",
    "createdDateTime": "2024-01-30T19:43:37.1672634Z",
    "lastModifiedDateTime": "2024-01-30T19:43:37.1672644Z",
    "state": {
        "effectiveValue": "offering",
        "requestedValue": "none",
        "reasons": []
    },
    "content": {
        "@odata.type": "#microsoft.graph.windowsUpdates.catalogContent",
        "catalogEntry@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/deployments('073fb534-5cdd-4326-8aa2-a4d29037b60f')/content/microsoft.graph.windowsUpdates.catalogContent/catalogEntry/$entity",
        "catalogEntry": {
            "@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry",
            "id": "e317aa8a0455ca604de95329b524ec921ca57f2e6ed3ff88aac757a7468998a5",
            "displayName": null,
            "deployableUntilDateTime": null,
            "releaseDateTime": "2023-08-08T00:00:00Z",
            "isExpeditable": false,
            "qualityUpdateClassification": "security",
            "catalogName": null,
            "shortName": null,
            "qualityUpdateCadence": "monthly",
            "cveSeverityInformation": null
        }
    },
    "settings": {
        "schedule": null,
        "monitoring": null,
        "contentApplicability": null,
        "userExperience": {
            "daysUntilForcedReboot": 2,
            "offerAsOptional": null
        },
        "expedite": {
            "isExpedited": true,
            "isReadinessTest": false
        }
    },
    "audience@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/deployments('de910e12-3456-7890-abcd-ef1234567890')/audience/$entity",
    "audience": {
        "id": "d39ad1ce-0123-4567-89ab-cdef01234567",
        "applicableContent": []
    }
}

デプロイ対象ユーザーにメンバーを追加する

対象ユーザー ID は、d39ad1ce-0123-4567-89ab-cdef01234567デプロイの作成時に作成されました。 対象ユーザー ID は、デプロイ対象ユーザーにメンバーを追加するために使用されます。展開対象ユーザーが更新されると、Windows Update展開設定に従ってデバイスへの更新プログラムの提供が開始されます。展開が存在し、デバイスが対象ユーザーに存在する限り、更新が迅速に行われます。

次の例では、各デバイスのMicrosoft Entra IDを使用して、展開対象ユーザーに 2 つのデバイスを追加します。

POST https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences/d39ad1ce-0123-4567-89ab-cdef01234567/updateAudience
content-type: application/json

{
  "addMembers": [
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "01234567-89ab-cdef-0123-456789abcdef"
    },
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "01234567-89ab-cdef-0123-456789abcde0"
    }
  ]
}

対象ユーザーにデバイスが追加されたことを確認するには、の 対象ユーザー ID を使用して次の d39ad1ce-0123-4567-89ab-cdef01234567クエリを実行します。

GET https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences/d39ad1ce-0123-4567-89ab-cdef01234567/members

デプロイを削除する

迅速なデプロイを停止するには、デプロイを削除します。展開を削除すると、コンテンツがまだ受信していない場合は、デバイスにコンテンツが提供されなくなります。コンテンツの提供を再開するには、新しい承認を作成する必要があります。

次の例では、 デプロイ ID がde910e12-3456-7890-abcd-ef1234567890のデプロイを削除します。

DELETE https://graph.microsoft.com/beta/admin/windows/updates/deployments/de910e12-3456-7890-abcd-ef1234567890

更新プログラムを迅速化するための準備テスト

isReadinessTest を使用して、クライアントが迅速な更新プログラムを受け取る準備ができているかどうかを確認できます。迅速な準備テストであることを指定するデプロイを作成し、デプロイ対象ユーザーにメンバーを追加します。サービスは、クライアントが更新プログラムを迅速化するための前提条件を満たしているかどうかを確認チェック。テストの結果は、ビジネスレポートのWindows Update ブックに表示されます。 [ 品質の更新 ] タブで、[ 迅速な状態 ] タイルを選択します。これにより、準備テスト結果が表示された [ 準備 ] タブが表示されたポップアップが開きます。

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.qualityUpdateCatalogEntry",
            "id": "317aa8a0455ca604de95329b524ec921ca57f2e6ed3ff88aac757a7468998a5"
        }
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "expedite": {
            "isExpedited": true,
            "isReadinessTest": true
        }
    }
}

切り捨てられた応答には、isReadinessTest がにtrue設定され、の de910e12-3456-7890-abcd-ef1234567890DeploymentID が表示されます。その後、展開対象ユーザーにメンバーを追加して、デバイスがプレリリースを満たしていることをサービスにチェックし、結果を [ビジネスレポートのWindows Update] ブックで確認できます。

        "expedite": {
            "isExpedited": true,
            "isReadinessTest": true
        }
    },
    "audience@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/deployments('6a6c03b5-008e-4b4d-8acd-48144208f179_Readiness')/audience/$entity",
    "audience": {
        "id": "de910e12-3456-7890-abcd-ef1234567890",
        "applicableContent": []
    }

Update Health Tools のログの場所

Update Health Tools は、迅速な更新プログラムを展開するときに使用されます。場合によっては、Update Health Tools のログを確認することもできます。

ログの場所: %ProgramFiles%\Microsoft Update Health Tools\Logs

ログの形式はです .etl 。
- Microsoft では、ファイルを表示する GitHub のダウンロードとして PerfView を提供しています .etl 。

詳細については、「迅速な更新プログラムのトラブルシューティング」を参照してください。

Windows Update for Business デプロイサービスを使用して迅速な更新プログラムを展開する

前提条件

アクセス許可

Graph エクスプローラーを開く

クエリを実行してデバイスを識別する

高度なクエリの要求ヘッダーを追加する

迅速な更新のカタログエントリを一覧表示する

デプロイを作成する

デプロイ対象ユーザーにメンバーを追加する

デプロイを削除する

更新プログラムを迅速化するための準備テスト

Update Health Tools のログの場所

フィードバック

フィードバック

その他のリソース

Windows Update for Business デプロイ サービスを使用して迅速な更新プログラムを展開する

前提条件

アクセス許可

Graph エクスプローラーを開く

クエリを実行してデバイスを識別する

高度なクエリの要求ヘッダーを追加する

迅速な更新のカタログ エントリを一覧表示する

デプロイを作成する

デプロイ対象ユーザーにメンバーを追加する

デプロイを削除する

更新プログラムを迅速化するための準備テスト

Update Health Tools のログの場所

フィードバック

フィードバック

その他のリソース

Windows Update for Business デプロイサービスを使用して迅速な更新プログラムを展開する

迅速な更新のカタログエントリを一覧表示する