< Back

Invoke-FreeIPAAPIuser_status

Sat Jan 18, 2020 11:27 am

NAME Invoke-FreeIPAAPIuser_status



SYNOPSIS





SYNTAX

Invoke-FreeIPAAPIuser_status [-all] [-raw] [[-version] <String>] [-login] <String> [-FullResultsOutput]

[<CommonParameters>]





DESCRIPTION

Lockout status of a user account



An account may become locked if the password is entered incorrectly too

many times within a specific time period as controlled by password

policy. A locked account is a temporary condition and may be unlocked by

an administrator.



This connects to each IPA master and displays the lockout status on

each one.



To determine whether an account is locked on a given server you need

to compare the number of failed logins and the time of the last failure.

For an account to be locked it must exceed the maxfail failures within

the failinterval duration as specified in the password policy associated

with the user.



The failed login counter is modified only when a user attempts a log in

so it is possible that an account may appear locked but the last failed

login attempt is older than the lockouttime of the password policy. This

means that the user may attempt a login again.





PARAMETERS

-all [<SwitchParameter>]

Retrieve and print all attributes from the server. Affects command output.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-raw [<SwitchParameter>]

Print entries as stored on the server. Only affects output format.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-version <String>

Client version. Used to determine if server will accept request.



Required? false

Position? 1

Default value

Accept pipeline input? false

Accept wildcard characters? false



-login <String>

User login



Required? true

Position? 2

Default value

Accept pipeline input? false

Accept wildcard characters? false



-FullResultsOutput [<SwitchParameter>]



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

System.Management.Automation.PSObject







RELATED LINKS