Set-MsolUserPassword

Article
12/08/2015

Updated: July 30, 2015

Applies To: Azure, Office 365, Windows Intune

Note

The cmdlets were previously known as the Microsoft Online Services Module for Windows PowerShell cmdlets.

The Set-MsolUserPassword cmdlet is used to change the password of a user. This cmdlet can only be used for users with standard identities.

Syntax

Set-MsolUserPassword -ObjectId <Guid> [-ForceChangePassword <Boolean>] [-NewPassword <string>] [-TenantId <Guid>] [<CommonParameters>]

Set-MsolUserPassword -UserPrincipalName <string> [-ForceChangePassword <Boolean>] [-NewPassword <string>] [-TenantId <Guid>] [<CommonParameters>]

Parameters

    -ForceChangePassword <Boolean>
        When true, the user will be required to change their password the next 
        time they sign in.
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       true (ByPropertyName)
        Accept wildcard characters?  false
        
    -NewPassword <string>
        The new password for the user. If the user is set to require a strong 
        password, then all of the following rules must be met:
        - The password must contain at least one lowercase letter
        - The password must contain at least one uppercase letter
        - The password must contain at least one non-alphanumeric character
        - The password cannot contain any spaces, tabs, or line breaks
        - The length of the password must be 8-16 characters
        - The user name cannot be contained in the password
        
        If this value is omitted, then a random password will be assigned to 
        the user.
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       true (ByPropertyName)
        Accept wildcard characters?  false
        
    -ObjectId <Guid>
        The unique ID of the user to set the password for.
        
        Required?                    true
        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 the value 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 user ID of the user to set the password for.
        
        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".

Examples

The following examples demonstrate how to use the cmdlet.

Example 1

The following command resets the password for user@contoso.com. A random password will be generated. The user will be required to reset the password on next sign in.

Set-MsolUserPassword -UserPrincipalName user@contoso.com

Example 2

This command resets the password for user@contoso.com. The user will be required to reset the password on next sign in.

Set-MsolUserPassword -userPrincipalName user@consoso.com -NewPassword Nula8787

Additional Resources

There are several other places you can get more information and help. These include:

Share via