Export (0) Print
Expand All
Expand Minimize

Set-MsolUserPassword

Published: March 22, 2013

Updated: January 21, 2014

Applies To: Office 365, Windows Azure, Windows Intune

noteNote
  • This topic provides online help content for cloud services, such as Windows Intune and Office 365, which rely on Windows Azure Active Directory for identity and directory services.

  • The Windows Azure Active Directory Module for Windows PowerShell 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.

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

    -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".

The following examples demonstrate how to use the cmdlet.

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

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 "pa$$word"

See Also

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft