Skip to main content

Get-XdrVulnerabilityManagementProducts

SYNOPSIS​

Retrieves products from Vulnerability Management.

SYNTAX​

Default (Default)​

Get-XdrVulnerabilityManagementProducts [-Top <Int32>] [-Force] [-ProgressAction <ActionPreference>]
[<CommonParameters>]

CountOnly​

Get-XdrVulnerabilityManagementProducts [-Force] [-CountOnly] [-ProgressAction <ActionPreference>]
[<CommonParameters>]

HardwareVendors​

Get-XdrVulnerabilityManagementProducts [-Force] [-HardwareVendorsInventoryCount]
[-ProgressAction <ActionPreference>] [<CommonParameters>]

BiosVendors​

Get-XdrVulnerabilityManagementProducts [-Force] [-BiosVendorsInventoryCount]
[-ProgressAction <ActionPreference>] [<CommonParameters>]

ProcessorVendors​

Get-XdrVulnerabilityManagementProducts [-Force] [-ProcessorVendorsInventoryCount]
[-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION​

Gets product information 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 the products array.

EXAMPLES​

EXAMPLE 1​

Get-XdrVulnerabilityManagementProducts
Retrieves all products using cached data if available.

EXAMPLE 2​

Get-XdrVulnerabilityManagementProducts -Top 100
Retrieves the first 100 products.

EXAMPLE 3​

Get-XdrVulnerabilityManagementProducts -Force
Forces a fresh retrieval of products, bypassing the cache.

EXAMPLE 4​

Get-XdrVulnerabilityManagementProducts -CountOnly
Returns only the total number of products.

EXAMPLE 5​

Get-XdrVulnerabilityManagementProducts -HardwareVendorsInventoryCount
Retrieves hardware vendors inventory count.

PARAMETERS​

-Top​

Limits the number of results returned. Valid range is 1-10000.

Type: Int32
Parameter Sets: Default
Aliases:

Required: False
Position: Named
Default value: 0
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

-CountOnly​

Returns only the total count of products (numOfResults).

Type: SwitchParameter
Parameter Sets: CountOnly
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-HardwareVendorsInventoryCount​

Retrieves hardware vendors inventory count.

Type: SwitchParameter
Parameter Sets: HardwareVendors
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-BiosVendorsInventoryCount​

Retrieves BIOS vendors inventory count.

Type: SwitchParameter
Parameter Sets: BiosVendors
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ProcessorVendorsInventoryCount​

Retrieves processor vendors inventory count.

Type: SwitchParameter
Parameter Sets: ProcessorVendors
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.

INPUTS​

OUTPUTS​

System.Object[]​

Returns an array of product objects from TVM.​

System.Int64​

When -CountOnly is specified, returns the total count as an integer.​

System.Management.Automation.PSCustomObject​

When vendor inventory parameters are specified, returns a summary object.​

Suppress false positive: Switch parameters are used via $PSCmdlet.ParameterSetName, not direct reference​

NOTES​