Get-XdrVulnerabilityManagementDashboard
SYNOPSIS
Retrieves Microsoft Defender Vulnerability Management dashboard analytics data.
SYNTAX
RiskScore (Default)
Get-XdrVulnerabilityManagementDashboard [-RiskScore] [-Force] [-ProgressAction <ActionPreference>]
[<CommonParameters>]
VulnerabilityNotificationRules
Get-XdrVulnerabilityManagementDashboard [-VulnerabilityNotificationRules] [-Force]
[-ProgressAction <ActionPreference>] [<CommonParameters>]
SecureScoreCategories
Get-XdrVulnerabilityManagementDashboard [-SecureScoreCategories] [-Force] [-ProgressAction <ActionPreference>]
[<CommonParameters>]
SecureScoreTotal
Get-XdrVulnerabilityManagementDashboard [-SecureScoreTotal] [-Force] [-ProgressAction <ActionPreference>]
[<CommonParameters>]
AssetsCountByExposureLevel
Get-XdrVulnerabilityManagementDashboard [-AssetsCountByExposureLevel] [-Force]
[-ProgressAction <ActionPreference>] [<CommonParameters>]
AssetsTopVulnerable
Get-XdrVulnerabilityManagementDashboard [-AssetsTopVulnerable] [-Force] [-ProgressAction <ActionPreference>]
[<CommonParameters>]
ChangeEventsVaTopPerDay
Get-XdrVulnerabilityManagementDashboard [-ChangeEventsVaTopPerDay] [-Force]
[-ProgressAction <ActionPreference>] [<CommonParameters>]
ChangeEventsScaTopPerDay
Get-XdrVulnerabilityManagementDashboard [-ChangeEventsScaTopPerDay] [-Force]
[-ProgressAction <ActionPreference>] [<CommonParameters>]
DESCRIPTION
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.
EXAMPLES
EXAMPLE 1
Get-XdrVulnerabilityManagementDashboard -RiskScore
Retrieves the organization's current risk score.
EXAMPLE 2
Get-XdrVulnerabilityManagementDashboard -SecureScoreTotal
Retrieves the organization's total secure score.
EXAMPLE 3
Get-XdrVulnerabilityManagementDashboard -SecureScoreCategories
Retrieves secure score broken down by security categories.
EXAMPLE 4
Get-XdrVulnerabilityManagementDashboard -AssetsCountByExposureLevel
Retrieves count of assets at each exposure level (None, Low, Medium, High, Critical).
EXAMPLE 5
Get-XdrVulnerabilityManagementDashboard -AssetsTopVulnerable
Retrieves the most vulnerable assets in your environment.
EXAMPLE 6
Get-XdrVulnerabilityManagementDashboard -ChangeEventsVaTopPerDay
Retrieves top vulnerability changes per day (new vulnerabilities discovered).
EXAMPLE 7
Get-XdrVulnerabilityManagementDashboard -VulnerabilityNotificationRules
Retrieves vulnerability notification rules metadata.
PARAMETERS
-VulnerabilityNotificationRules
Retrieves metadata for vulnerability notification rules configuration.
Type: SwitchParameter
Parameter Sets: VulnerabilityNotificationRules
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-SecureScoreCategories
Retrieves secure score breakdown by categories.
Type: SwitchParameter
Parameter Sets: SecureScoreCategories
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-SecureScoreTotal
Retrieves the total secure score for the organization.
Type: SwitchParameter
Parameter Sets: SecureScoreTotal
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-RiskScore
Retrieves the organization's risk score from TVM analytics.
Type: SwitchParameter
Parameter Sets: RiskScore
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-AssetsCountByExposureLevel
Retrieves count of assets grouped by their exposure level.
Type: SwitchParameter
Parameter Sets: AssetsCountByExposureLevel
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-AssetsTopVulnerable
Retrieves the top most vulnerable assets in the environment.
Type: SwitchParameter
Parameter Sets: AssetsTopVulnerable
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ChangeEventsVaTopPerDay
Retrieves top vulnerability assessment (VA) change events per day.
Type: SwitchParameter
Parameter Sets: ChangeEventsVaTopPerDay
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ChangeEventsScaTopPerDay
Retrieves top software composition analysis (SCA) change events per day.
Type: SwitchParameter
Parameter Sets: ChangeEventsScaTopPerDay
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Force
Bypasses the cache and forces a fresh retrieval from the API.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ProgressAction
The ProgressAction parameter is a common parameter, not a cmdlet parameter. For more information, see about_CommonParameters.
Type: ActionPreference
Parameter Sets: (All)
Aliases: proga
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.