:doc:`DirectoryService <../../ds>` / Client / reset_user_password

*******************
reset_user_password
*******************



.. py:method:: DirectoryService.Client.reset_user_password(**kwargs)

  

  Resets the password for any user in your Managed Microsoft AD or Simple AD directory. Disabled users will become enabled and can be authenticated following the API call.

   

  You can reset the password for any user in your directory with the following exceptions:

   

  
  * For Simple AD, you cannot reset the password for any user that is a member of either the **Domain Admins** or **Enterprise Admins** group except for the administrator user.
   
  * For Managed Microsoft AD, you can only reset the password for a user that is in an OU based off of the NetBIOS name that you typed when you created your directory. For example, you cannot reset the password for a user in the **Amazon Web Services Reserved** OU. For more information about the OU structure for an Managed Microsoft AD directory, see `What Gets Created <https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_getting_started_what_gets_created.html>`__ in the *Directory Service Administration Guide*.
  

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/ds-2015-04-16/ResetUserPassword>`_  


  **Request Syntax**
  ::

    response = client.reset_user_password(
        DirectoryId='string',
        UserName='string',
        NewPassword='string'
    )
    
  :type DirectoryId: string
  :param DirectoryId: **[REQUIRED]** 

    Identifier of the Managed Microsoft AD or Simple AD directory in which the user resides.

    

  
  :type UserName: string
  :param UserName: **[REQUIRED]** 

    The user name of the user whose password will be reset.

    

  
  :type NewPassword: string
  :param NewPassword: **[REQUIRED]** 

    The new password that will be reset.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`DirectoryService.Client.exceptions.DirectoryUnavailableException`

  
  *   :py:class:`DirectoryService.Client.exceptions.UserDoesNotExistException`

  
  *   :py:class:`DirectoryService.Client.exceptions.InvalidPasswordException`

  
  *   :py:class:`DirectoryService.Client.exceptions.UnsupportedOperationException`

  
  *   :py:class:`DirectoryService.Client.exceptions.EntityDoesNotExistException`

  
  *   :py:class:`DirectoryService.Client.exceptions.ClientException`

  
  *   :py:class:`DirectoryService.Client.exceptions.ServiceException`

  