Hitachi

JP1 Version 12 JP1/Automatic Operation Service Template Reference


4.4.7 Changing the OU attribute of the Active Directory

Function

This plug-in changes the explanation of the Organizational Unit (OU) for the Active Directory of the specified server.

The prerequisite server for this plug-in is as follows:

- Execution target server

This server is used as the target for executing this plug-in. The Active Directory shown in the Prerequisite condition needs to be set up beforehand.

Scripts in this plug-in perform the following processing:

- Execution of the following command

dsmod ou

"value-of-OU-identifier(Windows.OUName-property)"

[-desc "value-of-explanation(Windows.description-property)"]

For details of the dsmod ou command, see the relevant sections in the Microsoft library.

Use situation

This plug-in is used to change the explanation of an OU in the Active Directory.

Prerequisites

For the latest support status of the following items, see the Release notes: Prerequisite product within the system, prerequisite products on the execution target server, and running OS on the execution target server.

Prerequisite product within the system:

- JP1/Automatic Operation 11-00 or later

Prerequisite products on the execution target server:

(1) Active Directory domain service

(2) DNS server

Running OS on 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 of using prerequisite products on the execution target server:

None

Cautions

(1) Do not use a character string containing a double quotation mark (") or a single quotation mark (') in a plug-in property.

(2) You cannot specify a null character for an explanation (Windows.description property).

Execution privilege

(1) When connecting to the execution server, the user needs to be a member of the Account Operators group, Domain Admins group, or Enterprise Admins group of the Active Directory domain service; and have proper authority.

Version

02.00.00

Plug-in tags

Configure Active Directory,Windows,Active Directory

Plug-in name displayed in the task log

adChangeOUAttribute

Return code

0: Normal

21: Abnormal (illegal environment), command unfound (error detected in plug-in script)

27: Abnormal (Check the error details from the task log.)

41: Abnormal (error detected within the plug-in), property not entered (error detected in the plug-in 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.OUName

OU identifier

Specify an identifier of the OU for which you want to change attributes, in a format beginning with OU=.

--

Input

R

Windows.description

Explanation

Specify an explanation

--

Input

R

common.returnValue

Return value for the plugin

The return value of this plugin stored.

--

Output

O