The scripts can be used to enable or disable multi-factor authentication for a user in Microsoft 365 (Office 365). To execute the scripts, use the Run a program or PowerShell script action in a Custom Command, Business Rule or Scheduled Task.
The scripts can be used only in Adaxes 2018.2 and later.
For the scripts to work, you need to install Microsoft Azure Active Directory Module for Windows PowerShell on each computer where Adaxes service is running.
Script 1: Enable MFA
PowerShell
Import-Module MsOnline
# Get Microsoft 365 Object ID
try
{
$objectId = [Guid]$Context.TargetObject.Get("adm-O365ObjectId")
}
catch
{
$Context.LogMessage("The user %fullname% doesn't have an Microsoft 365 account.", "Warning")
return
}
# Connect to Microsoft 365
Connect-MsolService -Credential $Context.GetOffice365Credential()
$authenticationRequirements = New-Object "Microsoft.Online.Administration.StrongAuthenticationRequirement"
$authenticationRequirements.RelyingParty = "*"
$authenticationRequirements.State = "Enabled"
# Set MFA state in Microsoft 365
Set-MsolUser -ObjectId $objectId -StrongAuthenticationRequirements $authenticationRequirementsScript 2: Disable MFA
PowerShell
Import-Module MsOnline
# Get Microsoft 365 Object ID
try
{
$objectId = [Guid]$Context.TargetObject.Get("adm-O365ObjectId")
}
catch
{
$Context.LogMessage("The user %fullname% doesn't have an Microsoft 365 account.", "Warning")
return
}
# Connect to Microsoft 365
Connect-MsolService -Credential $Context.GetOffice365Credential()
# Set MFA state in Microsoft 365
Set-MsolUser -ObjectId $objectId -StrongAuthenticationRequirements @()Script 3: Reset MFA
PowerShell
# Get Microsoft 365 Object ID
try
{
$objectId = [Guid]$Context.TargetObject.Get("adm-O365ObjectId")
}
catch
{
$Context.LogMessage("The user %fullname% doesn't have an Microsoft 365 account.", "Warning")
return
}
# Connect to Microsoft 365
Connect-MsolService -Credential $Context.GetOffice365Credential()
# Reset MFA
Reset-MsolStrongAuthenticationMethodByUpn -UserPrincipalName "%userPrincipalName%"
Hello,
How could we make a script to know the activation status of MFA and display it on the Adaxes screen?
Thanks.
Hello,
Have a look at the following script from our repository: https://www.adaxes.com/script-repository/check-multi-factor-authentication-status-for-a-user-in-office-365-s556.htm.
When I put this script in my action, I get error -
"User Not Found. User: . Stack trace: at <ScriptBlock>, <No file>: line 22"
If I then run the script from the Admin Console, it applied, but not during the user creation sequence.
The sequence also assigns an Exchange licence, and that applies correctly.
Hello Paul,
As we understand, you are using the Enable MFA script. It should be executed only for users that have an account in Office 365. If you want to use the script in a Business Rule triggering After creating a user, the action executing the script should follow the Activate an Office 365 account action.
Thanks. I actually had a put the script to sleep at the start for 15 seconds, script was trying to enable MFA quicker than it could sync the new O365 account with Azure.
Start-Sleep -s 15
Import-Module MsOnline
# Get Office 365 Object ID
...
Hi
MSOL has been deprecated and this will stop working when Microsoft remove basic authentication. Do you have a method which works with modern authentication?
Thanks
Hello Matt,
Basic authentication will be disabled only for Exchange Online. The scripts from this article will continue working. If you need to update your scripts for Exchange Online, please, take a look at the Exchange Online using EXO V2 module script on the following page in our repository: https://www.adaxes.com/script-repository/connect-to-exchange-with-powershell-s506.htm#exchange_online_using_exo_v2_module.