모든 수정 작업 나열s

아티클
05/03/2024

적용 대상:

엔드포인트용 Microsoft Defender를 경험하고 싶으신가요? 무료 평가판에 등록합니다.

Microsoft Defender 취약성 관리 경험하고 싶으신가요? Microsoft Defender 취약성 관리 공개 미리 보기 평가판에 등록하는 방법에 대해 자세히 알아보세요.

중요

이 게시물의 일부 정보는 상용으로 출시되기 전에 실질적으로 수정될 수 있는 사전 릴리스된 제품과 관련이 있습니다. Microsoft는 여기에서 제공되는 정보와 관련하여 명시적이거나 묵시적인 어떠한 보증도 하지 않습니다.

참고

미국 정부 고객인 경우 미국 정부 고객을 위해 엔드포인트용 Microsoft Defender 나열된 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 있는 OData 쿼리의 예제를 참조하세요.

권한

이 API를 호출하려면 다음 권한 중 하나가 필요합니다. 사용 권한을 선택하는 방법을 포함하여 자세한 내용은 엔드포인트용 Microsoft Defender API 사용을 참조하세요.

사용 권한 유형	사용 권한	사용 권한 표시 이름
응용 프로그램	RemediationTasks.Read.All	'위협 및 취약성 관리 취약성 정보 읽기'
위임됨(회사 또는 학교 계정)	RemediationTask.Read	'위협 및 취약성 관리 취약성 정보 읽기'

속성

속성(ID)	데이터 형식	설명	반환된 값의 예
Category	String	수정 작업의 범주(소프트웨어/보안 구성)	소프트웨어
completerEmail	String	누군가가 수정 작업을 수동으로 완료한 경우 이 열에는 해당 전자 메일이 포함됩니다.	Null
completerId	String	누군가가 수정 작업을 수동으로 완료한 경우 이 열에는 해당 개체 ID가 포함됩니다.	Null
completionMethod	String	"완료된 것으로 표시"를 선택한 사용자가 수정 작업을 "자동으로"(모든 디바이스가 패치된 경우) 또는 "수동으로" 완료할 수 있습니다.	자동
createdOn	날짜/시간	이 수정 작업을 만든 시간	2021-01-12T18:54:11.5499478Z
설명	String	이 수정 활동에 대한 설명	Microsoft Silverlight를 이후 버전으로 업데이트하여 디바이스에 영향을 주는 알려진 취약성을 완화합니다.
dueOn	날짜/시간	작성자가 이 수정 작업에 대해 설정한 기한입니다.	2021-01-13T00:00:00Z
fixedDevices	.	수정된 디바이스 수	2
ID	String	이 수정 작업의 ID	097d9735-5479-4899-b1b7-77398899df92
nameId	String	관련 제품 이름	Microsoft Silverlight
우선 순위	String	이 수정 작업에 대해 만든 이 설정의 우선 순위(High\Medium\Low)	높음
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	날짜/시간	상태 필드가 업데이트된 날짜	2021-01-12T18:54:11.5499487Z
targetDevices	긴	이 수정에 적용할 수 있는 노출된 디바이스 수	43
제목	String	이 수정 작업의 제목	Microsoft Silverlight 업데이트
유형	String	수정 유형	업데이트
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
        }
    ]
}

참고 항목

팁

더 자세히 알아보고 싶으신가요? 기술 커뮤니티: 엔드포인트용 Microsoft Defender Tech Community의 Microsoft 보안 커뮤니티와 Engage.

다음을 통해 공유

모든 수정 작업 나열s

API 설명

권한

속성

예제

요청 예제

응답 예제

참고 항목

피드백

피드백

추가 리소스