Functional Specification
Update the configuration information of Systemwalker Desktop Keeper based on the "Configuration Information File" created in Systemwalker Desktop Patrol.
Update CT group information and the location information of the client (CT).
In addition, as the option function, it supports the following functions.
Update of discarded file information
Update of user group information
Move the user ID registered in the same level composition as the location information of the client (CT)
Delete the Systemwalker Desktop Patrol linkage information until the last time and establish a new link
In addition, the CT group and user group on Systemwalker Desktop Keeper linked through Systemwalker Desktop Patrol configuration information command can also be deleted.
Command Format
DTKIMPDP.EXE /START <Configuration Information File Name>
[/E <discarded Folder Information File> /G "<Group Name>"]
[/U [/F <Correspondent File Name> [/M] ] ]
[/R <Retry Times>] [/L <Log File Name>] [/T <Trace Level>]DTKIMPDP.EXE /DELETE [/R <Retry Times>] [/L <Log Folder Name>] [/T <Trace Level>]
Option
Execute the process of importing configuration information of Systemwalker Desktop Patrol. In the case of format 1, be sure to specify.
Make sure to specify the name of configuration information file created in Systemwalker Desktop Patrol. The path of any name and filename can be specified.
Specify with a full path beginning from the drive letter with no more than 218 characters.
When the file name and path contains space, enclose the whole path with double quotations. A network path beginning with \\ cannot be specified.
Some characters cannot be used as file name. The restriction of character type is based on the restriction of Windows standard. When the file cannot be opened or read or the file format does not comply with the rules, processing will be interrupted.
Specify the discarded folder information file created in Systemwalker Desktop Patrol.
It is used for reflecting the PC information that is disposed in Systemwalker Desktop Patrol to the configuration information tree of Systemwalker Desktop Keeper.
The path of any name and filename can be specified. Specify with a full path beginning from a drive letter with no more than 218 characters.
When the file name and path contains space, enclose the whole path with double quotation. Network path beginning with \\ cannot be specified.
When the discarded folder information file is specified, make sure to specify this option.
Specify the group created as the group exists at the time of import as the group name.
The group of reservations created during the import of configuration information cannot be specified as group name.
Specify the group name to be moved in the client (CT) specified in the information file of discarded folder.
When specifying group name, enclose the names of group name on this server with double quotation.
An error will occur in the command when the group that does not exist is specified. In addition, if this group exists at startup, but it does not exist when actually moving it to the discarded folder, skip the processing of discarded folder and continue with the following process.
If multiple groups with the specified name are found, the processing will be interrupted as an error. Therefore, make sure to specify one specific group.
Up to 40 characters can be specified as group name. Group name with space can also be specified. When specifying the group name with double quotations, add the \ symbol before the double quotation. (Example: specify the group name of "Tokyo" Associate "City Center" as " Tokyo\"Associate\"City Center".)
If more than 40 characters (20 fullwidth characters) are specified for the group name, the first 40 characters (20 fullwidth characters) will be used and the processing will be performed if a group with the name is found. If the specified group name cannot be found, the processing will be interrupted as an error.
The group name created freely under the Local group can be specified. It can be the group name that is not created by linking with Systemwalker Desktop Patrol. However, the group name created through Active Directory Linkage cannot be specified.
"Deleted CT" cannot be specified as group name.
If specified, an error will occur.
Specify it when reflecting configuration information to user group.
It can be omitted.
In addition, an error will occur when managing data collectively and this option is specified in the lower-level Management Server.
It can be specified only when the /U option is specified. It can be omitted.
When you wish to configure the user in the same level composition as the location of computer, specify "Correspondent File <Of Computer and User>".
Path of any name and file name can be specified in correspondent file.
Specify with a full path beginning from the drive letter with no more than 218 characters.
When the file name and path contains space, enclose the whole path with double quotation.
It can be specified only after the /U and /F options have been specified. It can be omitted.
When it is expected to configure the user in the same level composition as the location of computer, specify "Correspondent File <Of Computer and User>". When the user ID specified in the file does not exist in the database (domain information is in the range of Local group), the user ID will be created again and directed to the specified location.
In addition, the user policy created at this moment is created based on the policy of parent group to which it belongs. (However, when created in root directory, the terminal initial policy will be applied)
The user information apart from user ID will be displayed as blank.
Specify it when retrying the command execution. The range of retry times is "1" - "60". When omitted, the retry operation will not be performed.
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.
When this problem occurs, specify the /R option to set retry times.
Specify this option when it is expected to output the information displayed in window during execution to result log file. It can be omitted.
When this option is specified, it will be displayed to the window at the same time.
Path of any name and file name can be specified for result log file.
Specify with a full path beginning from the drive letter with no more than 218 characters.
When the file name and path contains space, enclose the whole path with double quotation.
Some characters cannot be used as file name.
The restriction of character type is based on the restriction of Windows standard.
When the file cannot be opened or read or the file format does not comply with the rules, processing will be interrupted.
Specify it when it is expected to collect execution trace. It can be omitted.
Do not specify without instruction from Fujitsu's technical staff.
Specify one digit of 1-5 as the trace level. Generally, the output trace of 3 is the summary level and 5 is the detail level.
Delete all content of CT group and user group imported using configuration information of Systemwalker Desktop Patrol before. Make sure to specify in the case of format 2.
The group information imported in "Link with Other System"- "Link with Systemwalker Desktop Patrol" will not be deleted.
The client (CT), CT group, user, user group belonging to this deleted group will be moved to their root directory.
When the /DELETE option is specified, only three options that can be specified at the same time are [/R Number of Retries] [/L Result Log File] [/T Trace Level].
Return Value
Ended normally
Option error
Input file error
Other errors
Location for Saving Commands
When executing on the PC with OS that is Windows Server 2008 64-bit edition, Windows Server 2008 R2, Windows Server 2012, or Windows Server 2016
%SystemRoot%\SYSWOW64\DTKIMPDP.EXE
When executing on the PC with other OS apart from Windows Server 2008 64-bit edition, Windows Server 2008 R2, Windows Server 2012, or Windows Server 2016
%SystemRoot%\system32\DTKIMPDP.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.
This command can be used in "Execute Active Directory Linkage" environment.
However, it cannot be executed at the same time with Active Directory Linkage.
This command cannot be started in the process of backup tool and restoration tool.
However, Systemwalker Desktop Patrol configuration information import command and backup command have no program restriction for each other, so they can be used at the same time. Therefore, when executing backup command, avoid starting Systemwalker Desktop Patrol configuration information import command during the execution of backup command.
In the /E (discarded folder information file) option, specify the following environment.
In a 2-level system structure
Execute the /E option in Management Server.
In a 3-level system structure
Execute the /E option in each Management Server.
Specify the /F (correspondent folder) option in the following environment.
In a 2-level system structure
Execute the /F option in Management Server.
In a 3-level system structure (when managing user information collectively)
Specify the /F option in Master Management Server. It cannot be executed in each Management Server.
In a 3-level system structure (when managing user information in each Management Server)
Execute the /F option in Master Management Server and each Management Server.
Note
When executing on the PC with OS that is Windows Server 2008 64-bit edition, Windows Server 2008 R2, Windows Server 2012, or Windows Server 2016, execute after specifying with full path or modify the current folder 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>DTKIMPDP.exe /START C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:13:43 Systemwalker Desktop Patrol configuration information import process - Start
2009/06/16 20:13:43 Startup parameter : /START
2009/06/16 20:13:43 Configuration file name : C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:13:43 Option :
2009/06/16 20:13:43
2009/06/16 20:13:43 Configuration file integrity check - Start
2009/06/16 20:13:43 Version information ... OK
2009/06/16 20:13:43 File format ... OK
2009/06/16 20:13:43 Check ... OK
2009/06/16 20:13:43 Number of items read 5
2009/06/16 20:13:43 Number of items of normal judgment 5
2009/06/16 20:13:43 Number of items of discarding judgment 0
2009/06/16 20:13:43 Configuration file integrity check - End
2009/06/16 20:13:43
2009/06/16 20:13:43 Configuration file CSV format check - Start
2009/06/16 20:13:43 configuration file CSV format check (group information) - Start
2009/06/16 20:13:43 Item No. 000001 (001,Fujitsu Limited,) ... OK
2009/06/16 20:13:43 Item No. 000002 (002, Business Department,001) ... OK
2009/06/16 20:13:43 configuration file CSV format check (group information) - End
2009/06/16 20:13:43 configuration file CSV format check (CT information) - Start
2009/06/16 20:13:43 Item No. 000003 (user001+DTPSV,001) ... OK
2009/06/16 20:13:43 Item No. 000004 (dtp+dtkct2,002) ... OK
2009/06/16 20:13:43 configuration file CSV format check (CT information) - End
2009/06/16 20:13:43 Number of items of normal judgment 4
2009/06/16 20:13:43 Number of items of error judgment 0
2009/06/16 20:13:43 Configuration file CSV format check - End
~ ~ (Omitted) ~ ~
2009/06/16 20:13:44 Move CT information - Start
2009/06/16 20:13:44 Number of CTs moved 1
2009/06/16 20:13:44 Move CT information - End
2009/06/16 20:13:44
2009/06/16 20:13:44 Ended normally.
2009/06/16 20:13:44
2009/06/16 20:13:44 Systemwalker Desktop Patrol configuration information import process - EndC:\WINDOWS\system32>DTKIMPDP.exe /START C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv /E C:\DTPIMPORT\discarded.csv /G "Discarded"
2009/06/16 20:28:33 Systemwalker Desktop Patrol configuration information import process - Start
2009/06/16 20:28:33 Configuration file integrity check - Start
2009/06/16 20:28:33 Configuration file name : C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:28:33 Option : /E C:\DTPIMPORT\discarded.csv /G Discarded
2009/06/16 20:28:33
2009/06/16 20:28:33 Configuration file integrity check - Start
2009/06/16 20:28:33 Version information ... OK
2009/06/16 20:28:33 File format ... OK
2009/06/16 20:28:33 Check ... OK
2009/06/16 20:28:33 Number of items read 5
2009/06/16 20:28:33 Number of items of normal judgment 5
2009/06/16 20:28:33 Number of items of discarding judgment 0
2009/06/16 20:28:33 Configuration file integrity check - End
2009/06/16 20:28:33
~ ~ (Omitted) ~ ~
2009/06/16 20:28:34
2009/06/16 20:28:34 Move CT information - Start
2009/06/16 20:28:34 Number of CTs moved 0
2009/06/16 20:28:34 Move CT Information - End
2009/06/16 20:28:34
2009/06/16 20:28:34 Discarded folder information file Move CT Information - Start
2009/06/16 20:28:34 Number of CTs moved 1
2009/06/16 20:28:34 Discarded folder information file Move CT Information - End
2009/06/16 20:28:34
2009/06/16 20:28:34 Ended normally.
2009/06/16 20:28:34
2009/06/16 20:28:34 Systemwalker Desktop Patrol configuration information import process - EndC:\WINDOWS\system32>DTKIMPDP.exe /START C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv /U
2009/06/16 20:31:05 Systemwalker Desktop Patrol configuration information import process - Start
2009/06/16 20:31:05 Startup parameter : /START
2009/06/16 20:31:05 Configuration file name : C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:31:05 Option : /U
2009/06/16 20:31:05
2009/06/16 20:31:06 Configuration file integrity check - Start
2009/06/16 20:31:06 Version information ... OK
2009/06/16 20:31:06 File format ... OK
2009/06/16 20:31:06 Check ... OK
2009/06/16 20:31:06 Number of items read 5
~ ~ (Omitted) ~ ~
2009/06/16 20:31:06 Configuration file data check (User group information linkage confirmation) - End
2009/06/16 20:31:06
2009/06/16 20:31:06 User group increment update - Start
2009/06/16 20:31:07 Add user group 2
2009/06/16 20:31:07 Update user group 0
2009/06/16 20:31:07 Delete user group 0
2009/06/16 20:31:07 User group increment update - End
2009/06/16 20:31:07
2009/06/16 20:31:07 Ended normally.
2009/06/16 20:31:07
2009/06/16 20:31:07 Systemwalker Desktop Patrol configuration information import process - EndC:\WINDOWS\system32>DTKIMPDP.exe /START C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv /U /F C:\DTPIMPORT\usercomp.csv
2009/06/16 20:37:40 Systemwalker Desktop Patrol configuration information import process - Start
2009/06/16 20:37:40 Startup parameter : /START
2009/06/16 20:37:40 Configuration file name : C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:37:40 Option : /U /F C:\DTPIMPORT\usercomp.csv
2009/06/16 20:37:40
2009/06/16 20:37:40 Configuration file integrity check - Start
2009/06/16 20:37:40 Version information ... OK
2009/06/16 20:37:40 File format ... OK
2009/06/16 20:37:40 Check ... OK
2009/06/16 20:37:40 Number of items read 5
2009/06/16 20:37:40 Number of items of normal judgment 5
2009/06/16 20:37:40 Number of items of discarding judgment 0
2009/06/16 20:37:40 Configuration file integrity check - End
2009/06/16 20:37:40
~ ~ (Omitted) ~ ~
2009/06/16 20:37:41 Move user group - Start
2009/06/16 20:37:41 Number of users moved 1
2009/06/16 20:37:41 Move user group - End
2009/06/16 20:37:41
2009/06/16 20:37:42 Ended normally.
2009/06/16 20:37:42
2009/06/16 20:37:42 Systemwalker Desktop Patrol configuration information import process - EndC:\WINDOWS\system32>DTKIMPDP.exe /START C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv /R 10 /L C:\temp\exec.log
2009/06/16 20:39:40 Systemwalker Desktop Patrol configuration information import process - Start
2009/06/16 20:39:40 Startup parameter : /START
2009/06/16 20:39:40 Configuration file name : C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:39:40 Option : /R 10 /L C:\temp\exec.log
2009/06/16 20:39:40
2009/06/16 20:39:40 Configuration file integrity check - Start
2009/06/16 20:39:40 Version information ... OK
2009/06/16 20:39:40 File format ... OK
2009/06/16 20:39:40 Check ... OK
2009/06/16 20:39:40 Number of items read 5
2009/06/16 20:39:40 Number of items of normal judgment 5
2009/06/16 20:39:40 Number of items of discarding judgment 0
2009/06/16 20:39:40 Configuration file integrity check - End
2009/06/16 20:39:40
~ ~ (Omitted) ~ ~
2009/06/16 20:39:40 Move CT information - Start
2009/06/16 20:39:40 Number of CTs moved 0
2009/06/16 20:39:40 Move CT information - End
2009/06/16 20:39:40
2009/06/16 20:39:41 Ended normally.
2009/06/16 20:39:41
2009/06/16 20:39:41 Systemwalker Desktop Patrol configuration information import process - EndC:\WINDOWS\system32>DTKIMPDP.exe /START C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv /T 5
2009/06/16 20:41:32 Systemwalker Desktop Patrol configuration information import process - Start
2009/06/16 20:41:32 Startup parameter : /START
2009/06/16 20:41:32 Configuration file name : C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:41:32 Option : /T 5
2009/06/16 20:41:32
2009/06/16 20:41:33 Configuration file integrity check - Start
2009/06/16 20:41:33 Version information ... OK
2009/06/16 20:41:33 File format ... OK
2009/06/16 20:41:33 Check ... OK
2009/06/16 20:41:33 Number of items read 5
2009/06/16 20:41:33 Number of items of normal judgment 5
2009/06/16 20:41:33 Number of items of discarding judgment 0
2009/06/16 20:41:33 Configuration file integrity check - End
2009/06/16 20:41:33
2009/06/16 20:41:33 Configuration file CSV format check - Start
~ ~ (Omitted) ~ ~
2009/06/16 20:41:33 Move CT information - Start
2009/06/16 20:41:33 Number of CTs moved 0
2009/06/16 20:41:33 Move CT information - End
2009/06/16 20:41:33
2009/06/16 20:41:34 Ended normally.
2009/06/16 20:41:34
2009/06/16 20:41:34 Systemwalker Desktop Patrol configuration information import process - EndC:\WINDOWS\system32>DTKIMPDP.exe /DELETE 2009/06/16 20:43:12 Systemwalker Desktop Patrol configuration information import process - Start 2009/06/16 20:43:12 Startup parameter : /DELETE 2009/06/16 20:43:12 Option : 2009/06/16 20:43:12 2009/06/16 20:43:12 Delete the information created through Systemwalker Desktop Patrol configuration information import command. 2009/06/16 20:43:12 2009/06/16 20:43:12 Delete CT group 2 2009/06/16 20:43:12 Move CT information 2 2009/06/16 20:43:12 Delete user group 2 2009/06/16 20:43:12 Move User Information 1 2009/06/16 20:43:12 2009/06/16 20:43:12 Ended normally. 2009/06/16 20:43:12 2009/06/16 20:43:12 Systemwalker Desktop Patrol configuration information import process - End