POWERSHELL COMMAND
Get-XdrVulnerabilityManagementAdvisories
Retrieves security advisories from Vulnerability Management.
Gets security advisories from Threat and Vulnerability Management (TVM) in Microsoft Defender XDR. This function includes caching support with a 30-minute TTL to reduce API calls. By default, returns all pages of results with pagination handled automatically.
Syntax
Get-XdrVulnerabilityManagementAdvisories [-Force] [-Top <int>] [<CommonParameters>]
Get-XdrVulnerabilityManagementAdvisories [-Force] [-CountOnly] [-Top <int>] [<CommonParameters>]
Get-XdrVulnerabilityManagementAdvisories [-Force] [-Top <int>] [-ByVendor] [<CommonParameters>]
Parameters
-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.
-CountOnly
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | False |
Returns only the total count of advisories (numOfResults).
-Top
| Property | Value |
|---|---|
| Type | Int32 |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | 0 |
Limits the number of results returned. Useful for previewing data without fetching all pages.
-ByVendor
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | False |
Returns only the vendor-specific advisory counts (meta object).
Examples
Get-XdrVulnerabilityManagementAdvisories
Retrieves all security advisories with full pagination.
Get-XdrVulnerabilityManagementAdvisories -Force
Forces a fresh retrieval of security advisories, bypassing the cache.
Get-XdrVulnerabilityManagementAdvisories -CountOnly
Returns only the total number of advisories.
Get-XdrVulnerabilityManagementAdvisories -Top 10
Returns only the first 10 advisories.
Get-XdrVulnerabilityManagementAdvisories -ByVendor
Returns only the vendor-specific advisory counts (Dell, HP, Lenovo).
Output
Type: System.Object[]
Returns an array of advisory objects when using default or -Top parameters.
System.Int64 When -CountOnly is specified, returns the total count as an integer.
System.Management.Automation.PSCustomObject When -ByVendor is specified, returns the vendor metadata object.