Skip to main content

Get-XdrIncidentAssociatedAlert

SYNOPSIS

Retrieves alerts associated with a specific incident from Microsoft Defender XDR.

SYNTAX

Get-XdrIncidentAssociatedAlert [-IncidentId] <Int32> [-Force] [-ProgressAction <ActionPreference>]
[<CommonParameters>]

DESCRIPTION

Gets all alerts associated with a specific incident ID from Microsoft Defender XDR. This cmdlet automatically handles pagination to retrieve all associated alerts. The results are cached to improve performance.

EXAMPLES

EXAMPLE 1

Get-XdrIncidentAssociatedAlert -IncidentId 2824
Retrieves all alerts associated with incident 2824.

PARAMETERS

-IncidentId

The ID of the incident to retrieve associated alerts for.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: 0
Accept pipeline input: True (ByPropertyName, ByValue)
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.

INPUTS

OUTPUTS

Object[]

Returns an array of alert objects associated with the incident.

NOTES