모든 수정 작업 나열s

아티클
08/14/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
ina.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	누군가가 수정 작업을 수동으로 완료한 경우 이 열에는 해당 전자 메일이 포함됩니다.	영
completerId	String	누군가가 수정 작업을 수동으로 완료한 경우 이 열에는 해당 개체 ID가 포함됩니다.	영
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	업그레이드할 권장 프로그램	영
recommendedVendor	String	업그레이드할 권장 공급업체	영
recommendedVersion	String	업데이트/업그레이드에 권장되는 버전	영
relatedComponent	String	이 수정 작업의 관련 구성 요소(보안 권장 사항의 관련 구성 요소와 유사)	Microsoft Silverlight
requesterEmail	String	작성자 전자 메일 주소	globaladmin@UserName.contoso.com
requesterId	String	Creator 개체 ID	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	String	작성자가 이 수정 작업에 대해 추가한 노트(무료 텍스트)	영
Scid	String	관련 보안 권장 사항의 SCID	영
상태	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 기술 커뮤니티: 엔드포인트용 Microsoft Defender 기술 커뮤니티에서 Microsoft 보안 커뮤니티에 참여하세요.

다음을 통해 공유

모든 수정 작업 나열s

API 설명

권한

속성

예제

요청 예제

응답 예제

참고 항목

피드백

추가 리소스