Get-DuoUserAuthenticationAttempts.md

external help file	Module Name	online version	schema
DuoSecurity-help.xml	DuoSecurity	https://duo.com/docs/adminapi#users-with-authentication-attempts-report	2.0.0

Get-DuoUserAuthenticationAttempts

SYNOPSIS

Users with Authentication Attempts Report

SYNTAX

Get-DuoUserAuthenticationAttempts [[-MaxTime] <String>] [[-MinTime] <String>] [<CommonParameters>]

DESCRIPTION

Retrieve counts of users with authentication attempts for a given time period (not to exceed 180 days), broken down by result. Each count is the number of users who had at least one authentication attempt ending with that result. Requires "Grant read information" API permission.

EXAMPLES

EXAMPLE 1

Get-DuoUserAuthenticationAttempts

PARAMETERS

-MaxTime

Limit report to events before this Unix timestamp. Defaults to the current time.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-MinTime

Limit report to events after this Unix timestamp. Defaults to thirty days before maxtime.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
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

NOTES

RELATED LINKS

https://duo.com/docs/adminapi#users-with-authentication-attempts-report