Hitachi

JP1 Version 12 JP1/Automatic Operation Service Template Reference


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