Updated: July 30, 2015
Applies To: Azure, Office 365, Windows Intune
- The cmdlets were previously known as the Microsoft Online Services Module for Windows PowerShell cmdlets.
Convert-MsolFederatedUser -UserPrincipalName <string> [-NewPassword <string>] [-TenantId <Guid>] [<CommonParameters>
-NewPassword <string> The new password of the user. Required? false Position? named Default value Accept pipeline input? true (ByPropertyName) Accept wildcard characters? false -TenantId <Guid> The unique ID of the tenant to perform the operation on. If this is not provided then it will default to the tenant of the current user. This parameter is only applicable to partner users. Required? false Position? named Default value Accept pipeline input? true (ByPropertyName) Accept wildcard characters? false -UserPrincipalName <string> The MicorosftOnlineUserID for the user to convert. Required? true Position? named Default value Accept pipeline input? true (ByPropertyName) Accept wildcard characters? false <CommonParameters> This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer and OutVariable. For more information, type, "get-help about_commonparameters".
The following command will convert a standard user (firstname.lastname@example.org) into a federated user:
Convert-MsolFederatedUser -userprincipalname email@example.com
If a new password is not supplied with the command, a new password will be generated automatically and displayed when the command is run.
There are several other places you can get more information and help. These include:
Manage Azure Active Directory by using Windows PowerShell
Error message when an Office 365 administrator tries to reset the password of a user who is a member of a domain that was formerly configured for federated authentication: "Unable to reset this user’s password"