すべての修復作業を一覧表示する

[アーティクル]
04/26/2024

適用対象:

Microsoft Defender ATP を試してみたいですか? 無料試用版にサインアップします。.

Microsoft Defender 脆弱性の管理を体験するには Microsoft Defender 脆弱性の管理パブリックプレビュー試用版にサインアップする方法について説明します。

重要

この記事の一部の情報は、市販される前に大幅に変更される可能性があるプレリリース製品に関するものです。 Microsoft は、ここで提供されるいかなる情報に関して、明示または黙示を問わず、いかなる保証も行いません。

注:

米国政府機関のお客様の場合は、米国政府機関のお客様のMicrosoft Defender for Endpointに記載されている URI を使用してください。

ヒント

パフォーマンスを向上させるために、地理的な場所に近いサーバーを使用できます。

us.api.security.microsoft.com
eu.api.security.microsoft.com
uk.api.security.microsoft.com
au.api.security.microsoft.com
swa.api.security.microsoft.com

API の説明

すべての修復アクティビティに関する情報を返します。

修復アクティビティの詳細については、こちらをご覧ください。

Url： GET: /api/remediationTasks
OData V4 クエリをサポートします。
OData でサポートされている演算子:
$filter on: createdon と status プロパティ。
$top 最大値が 10,000 です。
$skip.
Microsoft Defender for Endpointを使用した OData クエリの例を参照してください。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法など、詳細については、「Microsoft Defender for Endpoint API を使用する」を参照してください。

アクセス許可の種類	アクセス許可	アクセス許可の表示名
アプリケーション	RemediationTasks.Read.All	'脅威と脆弱性管理の脆弱性情報の読み取り'
委任 (職場または学校のアカウント)	RemediationTask.Read	'脅威と脆弱性管理の脆弱性情報の読み取り'

プロパティ

プロパティ (ID)	データ型	説明	戻り値の例
カテゴリ	文字列	修復アクティビティのカテゴリ (ソフトウェア/セキュリティ構成)	ソフトウェア
completerEmail	String	修復アクティビティが誰かによって手動で完了された場合、この列にはメールが含まれます	Null
completerId	String	修復アクティビティが誰かによって手動で完了された場合、この列にはオブジェクト ID が含まれます	Null
completionMethod	String	修復アクティビティは、"完了としてマーク" を選択したユーザーが "自動的に" (すべてのデバイスに修正プログラムが適用されている場合) または "手動" で完了できます	自動
createdOn	DateTime	この修復アクティビティが作成された時刻	2021-01-12T18:54:11.5499478Z
説明	String	この修復アクティビティの説明	デバイスに影響する既知の脆弱性を軽減するために、Microsoft Silverlight を新しいバージョンに更新します。
dueOn	DateTime	この修復アクティビティに対して作成者が設定した期限	2021-01-13T00:00:00Z
fixedDevices	.	固定されているデバイスの数	2
ID	String	この修復アクティビティの ID	097d9735-5479-4899-b1b7-77398899df92
Nameid	String	関連する製品名	Microsoft Silverlight
優先度	String	この修復アクティビティの作成者セットの優先度 (高\中\低)	高
Productid	String	関連する製品 ID	microsoft-_-silverlight
productivityImpactRemediationType	String	いくつかの構成変更は、ユーザーに影響を与えないデバイスに対してのみ要求できます。この値は、"すべての公開デバイス" または "ユーザーに影響のないデバイスのみ" の選択を示します。	AllExposedAssets
rbacGroupNames	String	関連するデバイスグループ名	[ "Windows Server"、"Windows 11"、"Windows 10" ]
recommendedProgram	String	にアップグレードするための推奨プログラム	Null
recommendedVendor	String	にアップグレードすることをお勧めするベンダー	Null
recommendedVersion	String	更新/アップグレードする推奨バージョン	Null
relatedComponent	String	この修復アクティビティの関連コンポーネント (セキュリティに関する推奨事項の関連コンポーネントと同様)	Microsoft Silverlight
requesterEmail	String	作成者のメールアドレス	globaladmin@UserName.contoso.com
requesterId	String	Creator オブジェクト ID	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	String	この修復アクティビティに作成者が追加したノート (フリーテキスト)	Null
Scid	String	関連するセキュリティに関する推奨事項の SCID	Null
状態	String	修復アクティビティの状態 (アクティブ/完了)	アクティブ
statusLastModifiedOn	DateTime	状態フィールドが更新された日付	2021-01-12T18:54:11.5499487Z
targetDevices	Long	この修復が適用される公開されているデバイスの数	43
Title	String	この修復アクティビティのタイトル	Microsoft Silverlight を更新する
型	String	修復の種類	Update
vendorId	String	関連ベンダー名	Microsoft

例

要求の例

GET https://api.securitycenter.windows.com/api/remediationtasks/

応答の例

{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#RemediationTasks",
    "value": [
        {
            "id": "03942ef5-aewb-4w6e-b555-d6a97013844w",
            "title": "Update Microsoft Silverlight",
            "createdOn": "2021-02-10T13:20:36.4718166Z",
            "requesterId": "65548a1d-ef00-4a7a-8d19-1b967b5c36f4",
            "requesterEmail": "user1@contoso.com",
            "status": "Active",
            "statusLastModifiedOn": "2021-02-10T13:20:36.4719698Z",
            "description": "Update Silverlight to a later version  to mitigate 55 known vulnerabilities affecting your devices. Doing so can help lessen the security risk to your organization due to versions which have reached their end-of-support.",
            "relatedComponent": "Microsoft Silverlight",
            "targetDevices": 18511,
            "rbacGroupNames": [
                "UnassignedGroup",
                "hhh"
            ],
            "fixedDevices": 2866,
            "requesterNotes": "test",
            "dueOn": "2021-02-11T00:00:00Z",
            "category": "Software",
            "productivityImpactRemediationType": null,
            "priority": "Medium",
            "completionMethod": null,
            "completerId": null,
            "completerEmail": null,
            "scid": null,
            "type": "Update",
            "productId": "microsoft-_-silverlight",
            "vendorId": "microsoft",
            "nameId": "silverlight",
            "recommendedVersion": null,
            "recommendedVendor": null,
            "recommendedProgram": null
        }
    ]
}