| title | description | ms.service | ms.author | author | ms.localizationpriority | manager | audience | ms.collection | ms.topic | ms.subservice | ms.custom | search.appverid | ms.date | |||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Score methods and properties |
Retrieves your organization's exposure score, device secure score, and exposure score by device group |
defender-endpoint |
siosulli |
siosulli |
medium |
deniseb |
ITPro |
|
reference |
reference |
api |
met150 |
12/18/2020 |
[!INCLUDE Microsoft Defender XDR rebranding]
Applies to:
- Microsoft Defender for Endpoint Plan 1
- Microsoft Defender for Endpoint Plan 2
- Microsoft Defender XDR
Want to experience Microsoft Defender for Endpoint? Sign up for a free trial.
[!includeMicrosoft Defender for Endpoint API URIs for US Government]
[!includeImprove request performance]
[!includePrerelease information]
| Method | Return Type | Description |
|---|---|---|
| Get exposure score | Score | Get the organizational exposure score. |
| Get device secure score | Score | Get the organizational device secure score. |
| List exposure score by device group | Score | List scores by device group. |
Note
Device group creation is supported in Defender for Endpoint Plan 1 and Plan 2.
| Property | Type | Description |
|---|---|---|
| Score | Double | The current score. |
| Time | DateTime | The date and time in which the call for this API was made. |
| RbacGroupName | String | The device group name. |
| RbacGroupId | String | The device group ID. |
| [!INCLUDE Microsoft Defender for Endpoint Tech Community] |