Skip to main content

Get-XdrConfigurationAlertServiceSetting

SYNOPSIS

Retrieves alert service settings from Microsoft Defender XDR.

SYNTAX

Get-XdrConfigurationAlertServiceSetting [-Force] [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

Gets the alert service settings for various workloads from the Microsoft Defender XDR portal, showing which services have alerts disabled and the reasons for disablement. This function includes caching support with a 30-minute TTL to reduce API calls.

EXAMPLES

EXAMPLE 1

Get-XdrConfigurationAlertServiceSetting
Retrieves the alert service settings using cached data if available.

EXAMPLE 2

Get-XdrConfigurationAlertServiceSetting -Force
Forces a fresh retrieval of the alert service settings, bypassing the cache.

PARAMETERS

-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 the alert service settings for each workload with translated names and normalized reasons.

NOTES