core/api/entraid/msgraph/helpers/users/Get-MonkeyMSGraphPerUserMFA.ps1
|
# Monkey365 - the PowerShell Cloud Security Tool for Azure and Microsoft 365 (copyright 2022) by Juan Garrido # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. Function Get-MonkeyMSGraphPerUserMFA { <# .SYNOPSIS Get the per-user multifactor authentication state for a user .DESCRIPTION Get the per-user multifactor authentication state for a user .INPUTS .OUTPUTS .EXAMPLE .NOTES Author : Juan Garrido Twitter : @tr1ana File Name : Get-MonkeyMSGraphPerUserMFA Version : 1.0 .LINK https://github.com/silverhack/monkey365 #> [CmdletBinding()] Param ( [Parameter(Mandatory=$True, ParameterSetName = 'User', ValueFromPipeline = $True)] [Object]$User, [Parameter(Mandatory=$True, ParameterSetName = 'UserId')] [String]$UserId, [parameter(Mandatory=$false, HelpMessage="API version")] [ValidateSet("v1.0","beta")] [String]$APIVersion = "beta" ) Begin{ $Environment = $O365Object.Environment #Get Graph Auth $graphAuth = $O365Object.auth_tokens.MSGraph } Process{ If($PSCmdlet.ParameterSetName -eq 'UserId'){ $objectId = ('/users/{0}/authentication/requirements' -f $UserId); } Else{ $objectId = ('/users/{0}/authentication/requirements' -f $User.id); } $p = @{ Authentication = $graphAuth; ObjectId = $objectId; Environment = $Environment; ContentType = 'application/json'; Method = "GET"; APIVersion = $APIVersion; InformationAction = $O365Object.InformationAction; Verbose = $O365Object.verbose; Debug = $O365Object.debug; } #execute command Get-MonkeyMSGraphObject @p } } |