4.4.10 Unlocking user account in the Active Directory
Function
This plugin can unlock user account is controlled on Domain Controller, and make the state that can log on, for the Active Directory of the specified server.
The required server is shown as follows:
- Execution-target server
This is a server on which this plugin runs. The Active Directory instance as described in the prerequisites must have been set up.
The scripts in this plugin perform the following processing:
- Execute the following command.
net user "user-account-name (the value of the Windows.userAccountName property)"
/active
/domain
For details on the net user command, refer to the descriptions in the Microsoft library.
Use situation
Use this to unlock a user account that has been locked out by Active Directory, for example due to mistakes in password entry.
Prerequisites
For the most recent information about the prerequisite product in the system, prerequisite products on the execution-target server, and supported OSs for the execution-target server, see the Release Notes.
Prerequisite product in the system:
JP1/Automatic Operation 11-00 or later
Prerequisite products on the execution-target server:
(1) Active Directory domain services
(2) DNS server
Supported OSs for the execution-target server:
(1) Windows Server 2008 R2 Standard/Enterprise/Datacenter
(2) Windows Server 2012 Standard/Datacenter, Windows Server 2012 R2 Standard/Datacenter
(3) Windows Server 2016 Standard/Datacenter
(4) Windows Server 2019 Standard/Datacenter
Conditions for using the prerequisite products on the execution-target server:
None
Cautions
(1) Do not specify character strings containing double quotation marks (") or single quotation marks (') for properties of this plug-in.
(2) If this plug-in ends abnormally and the message "The syntax of this command is:" is output to the task log, the user account name might be incorrect. Check the user account name.
Execution privilege
(1) A user who wants to connect to the execution server must have the administrator privilege.
Version
02.10.00
Plug-in tags
Active Directory,Control Active Directory,Windows
Plug-in name displayed in the task log
adUnlockUserAccount
Return code
0: Normal
27: Error (Check with the task log regarding the error details.) Unidentified error
41: Error (error detected in the component) Property not entered (An error was detected in the component 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 |
Windows.userAccountName |
User account name |
Specify the account name of the user. |
-- |
Input |
R |
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |