Get-MtUserAuthenticationMethod

SYNOPSIS

Get the authentication methods for the specified user

SYNTAX

Get-MtUserAuthenticationMethod [-UserId] <Object> [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

Get the authentication method from the /users/{id}/authentication/methods endpoint and appends the typeDisplayName and isMfa properties to each authentication method.

The user authentication method returned by Graph is missing key information such as the display name and whether an auth method is a multi-factor authentication method or not.

This cmdlet also returns an IsMfa status for the overall user object and is set to true if the user has at least one MFA method enabled.

Note: The overall IsMfa status may not be accurate in tenants that identity federation or authentication methods like Certificate Based Authentication that don’t have a state registered against the user object.

EXAMPLES

EXAMPLE 1

Get-MtUserAuthenticationMethod -UserId '[email protected]'

Get the authentication methods for the specified user

PARAMETERS

-UserId

The GUID or user principal name of the user to get Authentication Methods for.

Type: Object
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-ProgressAction

Determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider, such as the progress bars generated by Write-Progress.

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

NOTES

RELATED LINKS

https://maester.dev/docs/commands/Get-MtUserAuthenticationMethod