4.10.3 Change password for OS user
Function
Changes the password for an OS user in a Windows or Linux environment. In a Windows environment, you can change the password for a local user or a domain user.
This plugin assumes the following server:
• Execution target server
This is the server on which this plugin is executed. Windows or Linux must have already been set up.
In a Windows environment, set one of the following values in the Windows.userType property to indicate the type of user whose password is to be changed:
For a local user: local
For a domain user: domain
Use situation
You use this plugin to change the password for a user for operations. In a Linux environment, you can create OS users by executing this plugin together with the following plugins:
osAddUser_Lin
Prerequisites
For the latest support information about [Required product in the System]/[Required products on the execution target system]/[Prerequisite product OS running in the execution target server], see the release notes.
[Required product in the System]
Job Management Partner 1/Automatic Operation 10-00 or later
[Required products on the execution target system]
None.
[Prerequisite product OS running in the execution target server]
(1) Windows Server 2003, Standard Edition/Enterprise Edition (x86/x64) SP1or later, Windows Server 2003 R2, Standard Edition/Enterprise Edition (x86/x64)
(2) Windows Server 2008 Standard/Enterprise (x86/x64), Windows Server 2008 R2 Standard/Enterprise/Datacenter
(3) Windows Server 2012 Standard/Datacenter, Windows Server 2012 R2 Standard/Datacenter
(4) Red Hat Enterprise Linux 5 Advanced Platform (x86), Red Hat Enterprise Linux 5 (x86), Red Hat Enterprise Linux 5 Advanced Platform (AMD/Intel 64), Red Hat Enterprise Linux 5 (AMD/Intel 64)
(5) Red Hat Enterprise Linux Server 6 (32-bit x86), Red Hat Enterprise Linux Server 6 (64-bit x86_64)
[Usage conditions for the target server]
None.
Cautions
(1) When you run this service in a Linux environment, do not use multi-byte characters in the properties.
Version
01.00.04
Category
OperatingSystem/Common/Basic
Plug-in name displayed in the task log
osChangePassword
Return code
0: Normal
12: Error (user error) Invalid property
21: Error (invalid environment) Command cannot be found (error detected in the plugin script)
27: Error (check task logs for the nature of error)
41: Error (error detected in plugin) Missing property (error detected in plugin script)
Property list
The following table lists the properties:
Property key |
Property name |
Description |
Default value |
I/O type |
Required |
---|---|---|---|---|---|
plugin.destinationHost |
Host name of the execution target server |
Specify the host name or IP address of the server on which this plugin will be executed. IPv6 addresses are not supported. |
-- |
Input |
R |
common.osUserName |
OS user name |
Specify the user name of the OS user whose password is to be changed. |
-- |
Input |
O |
common.osUserPassword |
OS user password |
Specify the new password for the OS user. |
-- |
Input |
O |
common.osUserPasswordReEnter |
Enter the new OS user password again |
Re-enter the new password for the OS user. |
-- |
Input |
O |
Windows.userType |
OS user's type |
Specify "local" or "domain" as the OS user type. If "domain" is specified, any operations will be performed for the primary domain controller for the domain of the target server. This property takes effect in only Windows. |
local |
Input |
O |
common.addOrChange |
command execution type |
Specify the name of the OS user to be created. |
-- |
Input |
O |
common.tmpFileID |
temporary file ID |
This property indicates the ID of temporary file. |
-- |
Input |
O |
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |