Functional Specification
Create the CT group tree, user group tree or user information of Systemwalker Desktop Keeper based on the user/computer management information of Active Directory.
In addition, through setting "Active Directory Linkage organization unit target list", it is possible to import only the organization of linkage target. When it is not set, all organization information will be linked. (however, only the CT information of the client (CT) existing on the Management Server will be imported).
When this command is executed in the Master Management Server of a 3-level structure, Active Directory Linkage will also be performed by each Management Server.
Command Format
DTKADCON /START [/R <Number>]
Option
Execute the processing of Active Directory Linkage. Make sure to specify.
Specify when retrying the execution of command. The range of retry times is from "1" to "60". It can be omitted.
When executing this command, due to the exclusion control when other processes are being executed, this command may not be executed immediately during the communication between the Master Management Server and Management Server, etc.
In this case, specify the /R option to set the retry times in <Number>.
During the installation of the Management Server, this file will be saved to the following folder. Define the names of the organization units (OU) to be extracted from the Active Directory. When defining the names, specify the organization units (OU) of 1-level. Even if 2-level and following levels are specified, they are not linked.
When linking all the organization units (OU), use only the line feed in the file.
DTKActiveDirectoryOUList.txt
When OS is Windows Server 2008, Windows Server 2012, or Windows Server 2016
%ALLUSERPROFILE%\Fujitsu\Systemwalker Desktop Keeper
Note) %ALLUSERPROFILE% is usually C:\ProgramData.
When OS is not Windows Server 2008, Windows Server 2012, or Windows Server 2016
%ALLUSERPROFILE%\Application Data\Fujitsu\Systemwalker Desktop Keeper
Note) %ALLUSERPROFILE% is usually C:\Documents and Settings\All Users.
Record in UTF-8 code.
Select the line feeding code to two character sets of 0x0D+0x0A2, or one character of 0x0A.
Halfwidth/Fullwidth can co-exist.
Set only 1 item of organization unit (OU) at one line.
Ignore blank lines (line with halfwidth space character or fullwidth space character only), and the line with only the line feeding code. In addition, space at both ends should be removed, and lines with more than 64 characters will not be taken as the linkage target.
If halfwidth space character or fullwidth space character appears between characters, it will be processed as a part of "Organization Unit" of the linkage target directly.
Return Value
Ended normally.
Ended abnormally.
Location for Saving Commands
When executing on the PC in which the OS is Windows Server 2008 64-bit edition, Windows Server 2008 R2, Windows Server 2012, or Windows Server 2016:
%SystemRoot%\SYSWOW64\DTKADCON.EXE
When executing on the PC in which the OS is not Windows Server 2008 64-bit edition, Windows Server 2008 R2, Windows Server 2012, or Windows Server 2016:
%SystemRoot%\system32\DTKADCON.EXE
Note) %SystemRoot% is usually C:\Windows.
Authority Required for Execution/Execution Environment
Execute with a user that belongs to the Administrators group of the local computer or a user that belongs to the Domain Admins group of the domain.
Execute on the Management Server/Master Management Server.
Note
Pay attention to the following two points before execution.
In the System Settings window of the Server Settings Tool, the Execute Active Directory Linkage option has already been selected.
In the Active Directory Linkage Settings window of the Server Settings Tool, the Active Directory server to be linked has already been registered.
In the user information read from Active Directory server, when the following information is contained, user information will not be read.
When the string before @ of "User logon Name (UserPrincipalName)" does not contain any character, or contains over 41 halfwidth characters (21 fullwidth characters)
In the process of executing this command, do not modify System Settings and Active Directory Linkage Settings in the Server Settings Tool.
When the organization name exceeds 41 halfwidth characters (21 fullwidth characters), only the name before the 40th halfwidth character (20 fullwidth characters) can be displayed in the database.
When executing on the PC in which the OS is Windows Server 2008 64-bit edition, Windows Server 2008 R2, Windows Server 2012, or Windows Server 2016, check if the specified path is full path, and execute after the current folder is modified to %SystemRoot%\SYSWOW64.
When executing this command in Windows Server 2008, Windows Server 2012, or Windows Server 2016, it is necessary to open the command prompt with "Run as Administrator".
Example of Use/Execution Results/Output Format
C:\WINDOWS\system32>DTKADCON.exe /START /R 5 2009/06/08 16:01:36 Link with Systemwalker Desktop Keeper Active Directory .Start 2009/06/08 16:01:36 Parameter: /START /R 5 2009/06/08 16:01:36 Operation settings: The view of CT registration location is "Match with the computer location of Active Directory" 2009/06/08 16:01:41 Operation settings: "Import all organization units (OU)" through Active Directory 2009/06/08 16:01:42 Start domain linkage processing. Domain address [DTK-DOMAIN.local] 2009/06/08 16:01:43 Start linkage of user information and user group information. 2009/06/08 16:02:24 Start linkage of CT information and CT group information. 2009/06/08 16:03:08 End domain linkage processing. Domain address [DTK-DOMAIN.local] 2009/06/08 16:03:08 Move the CT to which the Local that can perform domain management belongs. 2009/06/08 16:03:09 Ended normally. 2009/06/08 16:03:09 Link with Systemwalker Desktop Keeper Active Directory .End
