Get-DSLoginAttempt

Synopsis

Get login attempts

Syntax

__AllParameterSets

Get-DSLoginAttempt [-DateFilter <DateFilter>] [-After <datetime>] [-Before <datetime>]
 [-Username <string>] [-PageNumber <int>] [-PageSize <int>] [<CommonParameters>]

Description

Get one or multiple login attempts. Optionally filter by username or time period. If no date filter is applied, login attempts from the last 7 days are fetched. Results are paginated; by default, retrieves one page of 10000 login attempts.

Examples

Example 1

PS C:\> Get-DSLoginAttempt -Username 'johndoe'

Gets login attempts and filters them by username.

Example 2

PS C:\> Get-DSLoginAttempt -DateFilter Last30Days

Gets login attempts from the last 30 days.

Example 3

PS C:\> Get-DSLoginAttempt -DateFilter Custom -After (Get-Date).AddDays(-14)

Gets login attempts from the last 14 days using a custom date range ('Before' defaults to now).

Example 4

PS C:\> Get-DSLoginAttempt -DateFilter Custom -After '2024-01-01' -Before '2024-01-31'

Gets login attempts for a specific date range.

Parameters

-After

Start date for custom date range (required when using -DateFilter Custom).

Type: System.Nullable`1[System.DateTime]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Before

End date for custom date range (use with -DateFilter Custom). Defaults to current date/time if not specified.

Type: System.Nullable`1[System.DateTime]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-DateFilter

Date filter for login attempts. Defaults to the last 7 days if not specified.

Type: Devolutions.RemoteDesktopManager.DateFilter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PageNumber

Page number for paginated results. Default: 1

Type: System.Int32
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PageSize

Number of results per page. Default: 10000

Type: System.Int32
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Username

Username to filter login attempts (client-side filtering applied after fetching from server).

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Outputs

Devolutions.RemoteDesktopManager.Business.Entities.LoginAttemptEntity

Notes

For more information, type "Get-Help Get-DSLoginAttempt -detailed". For technical information, type "Get-Help Get-DSLoginAttempt -full".