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