POWERSHELL COMMAND
Get-XdrVulnerabilityManagementDashboard
Retrieves Microsoft Defender Vulnerability Management dashboard analytics data.
Retrieves various analytics data displayed on the TVM dashboard including risk scores, secure scores, asset exposure levels, change events, and notification rules. This function includes caching support with a 30-minute TTL to reduce API calls.
Syntax
Get-XdrVulnerabilityManagementDashboard [-RiskScore] [-Force] [<CommonParameters>]
Get-XdrVulnerabilityManagementDashboard [-VulnerabilityNotificationRules] [-Force] [<CommonParameters>]
Get-XdrVulnerabilityManagementDashboard [-SecureScoreCategories] [-Force] [<CommonParameters>]
Get-XdrVulnerabilityManagementDashboard [-SecureScoreTotal] [-Force] [<CommonParameters>]
Get-XdrVulnerabilityManagementDashboard [-AssetsCountByExposureLevel] [-Force] [<CommonParameters>]
Get-XdrVulnerabilityManagementDashboard [-AssetsTopVulnerable] [-Force] [<CommonParameters>]
Get-XdrVulnerabilityManagementDashboard [-ChangeEventsVaTopPerDay] [-Force] [<CommonParameters>]
Get-XdrVulnerabilityManagementDashboard [-ChangeEventsScaTopPerDay] [-Force] [<CommonParameters>]
Parameters
-VulnerabilityNotificationRules
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | False |
Retrieves metadata for vulnerability notification rules configuration.
-SecureScoreCategories
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | False |
Retrieves secure score breakdown by categories.
-SecureScoreTotal
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | False |
Retrieves the total secure score for the organization.
-RiskScore
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | False |
Retrieves the organization’s risk score from TVM analytics.
-AssetsCountByExposureLevel
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | False |
Retrieves count of assets grouped by their exposure level.
-AssetsTopVulnerable
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | False |
Retrieves the top most vulnerable assets in the environment.
-ChangeEventsVaTopPerDay
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | False |
Retrieves top vulnerability assessment (VA) change events per day.
-ChangeEventsScaTopPerDay
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | False |
Retrieves top software composition analysis (SCA) change events per day.
-Force
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | False |
Bypasses the cache and forces a fresh retrieval from the API.
Examples
Get-XdrVulnerabilityManagementDashboard -RiskScore
Retrieves the organization's current risk score.
Get-XdrVulnerabilityManagementDashboard -SecureScoreTotal
Retrieves the organization's total secure score.
Get-XdrVulnerabilityManagementDashboard -SecureScoreCategories
Retrieves secure score broken down by security categories.
Get-XdrVulnerabilityManagementDashboard -AssetsCountByExposureLevel
Retrieves count of assets at each exposure level (None, Low, Medium, High, Critical).
Get-XdrVulnerabilityManagementDashboard -AssetsTopVulnerable
Retrieves the most vulnerable assets in your environment.
Get-XdrVulnerabilityManagementDashboard -ChangeEventsVaTopPerDay
Retrieves top vulnerability changes per day (new vulnerabilities discovered).
Get-XdrVulnerabilityManagementDashboard -VulnerabilityNotificationRules
Retrieves vulnerability notification rules metadata.
Output
Type: System.Management.Automation.PSCustomObject
Returns dashboard analytics data. Output structure varies based on the parameter used.
System.Object[] For parameters returning collections (e.g., -SecureScoreCategories, -AssetsTopVulnerable).