.
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
- aea.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 Defender Tech Community의 Microsoft 보안 커뮤니티와 Engage.