1.10 DTKIMPDP.EXE(Systemwalker Desktop Patrol構成情報取り込み)

機能説明

Systemwalker Desktop Patrolで作成した「構成情報ファイル」を元に、Systemwalker Desktop Keeperの構成情報を更新します。
CTグループ情報、クライアント(CT)の位置情報を更新します。
また、オプション機能として、以下の機能をサポートしています。

廃棄フォルダ情報の更新
ユーザーグループ情報の更新
クライアント(CT)の位置情報と同じ階層構成に、登録済のユーザーIDを移動
前回までのSystemwalker Desktop Patrol連携情報を削除し、新規として連携

また、以前にSystemwalker Desktop Patrol構成情報取り込みコマンドで連携していたSystemwalker Desktop Keeper上のCTグループ、ユーザーグループを削除することもできます。

記述形式

【形式1】構成情報の登録/更新

DTKIMPDP.EXE  /START  <構成情報ファイル名>
              [/E  <廃棄フォルダ情報ファイル名>  /G  “<グループ名>”]
              [/U  [/F  <対応ファイル名>  [/M] ] ] 
              [/R  <リトライ回数>]  [/L  <ログファイル名>]  [/T  <トレースレベル>]

【形式2】構成情報の削除

DTKIMPDP.EXE  /DELETE  [/R  <リトライ回数>]  [/L  <ログファイル名>]  [/T  <トレースレベル>]

オプション

/START <構成情報ファイル名>:

Systemwalker Desktop Patrol構成情報取り込み処理を実行します。形式1の場合、必ず指定してください。

<構成情報ファイル名> :: Systemwalker Desktop Patrolで作成した構成情報ファイル名を必ず指定します。任意の名前のパス、ファイル名が指定できます。
218文字以内で、ドライブレターからフルパスで指定してください。
ファイル名やパス中に空白を含む場合は、パス全体をダブルクォーテーションでくくってください。\\で始まるネットワークパスは指定できません。
ファイル名として使用できない文字があります。文字種の制限はWindowsの制限に準拠します。ファイルがオープンできなかったり、読み込めなかった場合、またはファイルフォーマットが規約とおりではなかった場合には、処理を中断します。

/E <廃棄フォルダ情報ファイル名> :

Systemwalker Desktop Patrolで作成した廃棄フォルダ情報ファイル名(ディスク消去PC一覧情報ファイル名)を指定します。
Systemwalker Desktop Patrolで廃棄処理されたPCの情報を、Systemwalker Desktop Keeperの構成情報ツリーに反映するために使用します。

<廃棄フォルダ情報ファイル名> :: 任意の名前のパス、ファイル名が指定できます。218文字以内で、ドライブレターからフルパスで指定してください。
ファイル名やパス中に空白を含む場合は、パス全体をダブルクォーテーションでくくってください。\\で始まるネットワークパスは指定できません。

/G “<グループ名>” :

廃棄フォルダ情報ファイルを指定した場合は、このオプションを必ず指定してください。
グループ名は取り込み時点ですでにグループとして作成されているものを指定してください。
構成情報取り込みで作成される予定のグループはグループ名に指定できません。

<グループ名> :

廃棄フォルダ情報ファイルで指定したCTに移動先グループ名を指定します。
グループ名には、自サーバ上のグループ名の名称をダブルクォーテーションでくくって指定します。
存在しないグループ名を指定した場合はコマンドがエラーとなります。なお、起動時には存在したが、実際の廃棄フォルダへの移動時にそのグループが存在しなくなっていた場合は、廃棄フォルダの処理だけをスキップし、後続の処理を継続します。
該当するグループ名が複数見つかった場合は、最初に見つけたグループ名を対象とします。なお、複数の中から1つを決定する方法は不定です。そのため、必ず1つに特定できるグループ名を指定してください。
グループ名には最大40バイトが指定できます。空白を含むグループ名も指定できます。ダブルクォーテーションを含むグループ名を指定する場合、各ダブルクォーテーション記号の前に\記号を指定してください。 (例「東京”副”都心」というグループ名は、” 東京\”副\”都心”と指定)
Localグループ配下に任意に作成したグループ名を指定できます。Systemwalker Desktop Patrol連携にて作成したグループ名でなくてもかまいません。ただし、Active Directory連携で作成したグループ名は指定できません。

グループ名として「削除したCT」は指定できません。
指定するとエラーになります。

/U :: ユーザーグループに対しても、構成情報を反映させたい場合に指定します。
省略可能です。
なお、データ一元管理時で、かつ、下位の管理サーバでこのオプションが指定されると、エラーとなります。

/F <対応ファイル> :: /U オプションを指定している場合にだけ指定できます。省略可能です。
ユーザーを、コンピュータの位置と同じ階層構成に配置したい場合、「<コンピュータとユーザーの>対応ファイル」を指定します。
対応ファイルには、任意の名前のパス、ファイル名が指定できます。
218文字以内で、ドライブレターからフルパスで指定してください。
ファイル名やパス中に空白を含む場合は、パス全体をダブルクォーテーションでくくってください。

/M :: /U /F オプションを指定している場合にだけ指定できます。省略可能です。
ユーザーを、コンピュータの位置と同じ階層構成に配置したい場合、「<コンピュータとユーザーの>対応ファイル」を指定しますが、ファイル上に指定しているユーザーIDがデータベース上にない場合(ドメイン情報がLocalグループの範囲で)、新たにそのユーザーIDを作成し、指定位置に位置付けます。
なお、この時作成されるユーザーのポリシーは、所属する親グループのポリシーを元に作成されます。(ただし、ルート直下に作成する場合は、端末初期ポリシーが適用されます)
また、ユーザーID以外のユーザー情報は空欄となります。

/R <リトライ回数> :: コマンドの実行をリトライする場合に指定します。リトライ回数の範囲は、「1」～「60」です。省略時はリトライ動作を行いません。
コマンド実行時に、他の処理との排他制御を行っているため、統合管理サーバと管理サーバ間の通信処理時などに、本コマンドが即時に実行できない場合があります。
この場合に、/Rオプションを指定し、リトライ回数を設定してください。

/L <実行ログファイル> :: 実行中に画面表示される情報を、そのまま実行ログファイルに出力したい場合に指定します。省略可能です。
このオプションを指定しても画面への表示も行われます。
実行ログファイルには、任意の名前のパス、ファイル名が指定できます。
218文字以内で、ドライブレターからフルパスで指定してください。
ファイル名やパス中に空白を含む場合は、パス全体をダブルクォーテーションでくくってください。
ファイル名として使用できない文字があります。文字種の制限はWindowsの制限に準拠します。
ファイルがオープンできなかったり、書き込めなかった場合には、処理を中断します。

/T <トレースレベル> :: 実行トレースを採取したい場合に指定します。省略可能です。
富士通技術員からの指示がない場合には、指定しないでください。
トレースレベルは1～5の1ケタの数字で指定します。通常は3で概要レベル、5で詳細レベルのトレースを出力します。

/DELETE :: 以前に、Systemwalker Desktop Patrol構成情報取り込みコマンドを使用して取り込んだ、CTグループ、ユーザーグループを全て削除します。形式2の場合、必ず指定してください。
管理コンソールの「他システム連携」-「Systemwalket Desktop Patrol連携」で取り込んだグループ情報は削除しません。
削除グループ配下にあったクライアント(CT)、CTグループ、ユーザー、ユーザーグループは、各々のルートに移動します。
/DELETE オプションを指定した場合、同時に指定できるオプションは[/R リトライ回数 ] [/L 実行ログファイル ] [/T トレースレベル ]の3つだけです。

復帰値

[ERRORLEVEL] 0 :: 正常終了

[ERRORLEVEL] 1 :: オプションエラー

[ERRORLEVEL] 2 :: 入力ファイルエラー

[ERRORLEVEL] 3 :: その他のエラー

コマンド格納場所

OSがWindows Server® 2008 64ビット版、Windows Server® 2008 R2、Windows Server® 2003 x64 Edition、Windows Server® 2003 R2 x64 Edition、またはWindows Server® 2012のPCで実行する場合

%SystemRoot%\SYSWOW64\DTKIMPDP.EXE

OSがWindows Server® 2008 64ビット版、Windows Server® 2008 R2、Windows Server® 2003 x64 Edition、Windows Server® 2003 R2 x64 Edition、またはWindows Server® 2012以外のPCで実行する場合

%SystemRoot%\system32\DTKIMPDP.EXE

注）%SystemRoot%は、通常C:\Windowsです。

実行に必要な権限/実行環境

ローカルコンピュータのAdministratorsグループに所属するユーザー、またはドメインのDomain Adminsグループに所属するユーザーで行ってください。
管理サーバ、または統合管理サーバ上で実行してください。
このコマンドは、「Active Directory連携を行う」環境においても使用できます。
ただし、Active Directory連携との同時実行は行なえません。
バックアップツール、リストアツールが実行中は起動できません。
ただし、Systemwalker Desktop Patrol構成情報取り込みコマンドとバックアップコマンドは、お互いプログラム的な制限がかかっていないため起動できてしまいます。そのため、バックアップコマンド動作中にSystemwalker Desktop Patrol構成情報取り込みコマンドが動作しないように運用で回避してください。
OSがWindows Server® 2003 でジョブスケジューラ起動でこのコマンドを使用する場合、OSに他のターミナルサービスのセションが存在していたときは実行時にエラーとなります。
/E（廃棄フォルダ情報ファイル）オプションは下記の環境で指定してください。
- 2階層のシステム構成の場合
  管理サーバにて/Eオプションを実行してください。
- 3階層システム構成の場合
  各管理サーバで/Eオプションを実行してください。
/F（対応ファイル）オプションは下記の環境で指定してください。
- 2階層のシステム構成の場合
  管理サーバにて/Fオプションを実行してください。
- 3階層システム構成の場合(ユーザー情報を一元管理する場合)
  統合管理サーバにて/Fオプションを実行してください。各管理サーバでは実行できません。
- 3階層システム構成の場合(ユーザー情報を各管理サーバで管理する場合)
  統合管理サーバ、各管理サーバにて/Fオプションを実行してください。

注意

OSがWindows Server® 2008 64ビット版、Windows Server® 2008 R2、またはWindows Server® 2012のPCで実行する場合は、フルパスで指定するか、カレントフォルダを%SystemRoot%\SYSWOW64に変更してから実行してください。
Windows Server® 2008環境、またはWindows Server® 2012環境で本コマンドを実行する場合は、コマンドプロンプトを「管理者として実行」で起動する必要があります。

使用例/実行結果/出力形式

【CTグループ構成情報と、クライアント(CT)の位置情報を連携したい場合】

C:\WINDOWS\system32>DTKIMPDP.exe /START C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:13:43 Systemwalker Desktop Patrol構成情報取り込み処理・開始
2009/06/16 20:13:43 起動パラメーター    : /START
2009/06/16 20:13:43 構成情報ファイル名  : C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:13:43 オプション          :
2009/06/16 20:13:43
2009/06/16 20:13:43 構成情報ファイル 整合性チェック・開始
2009/06/16 20:13:43 バージョン情報  ・・・  OK
2009/06/16 20:13:43 ファイル形式    ・・・  OK
2009/06/16 20:13:43 チェック        ・・・  OK
2009/06/16 20:13:43 読み込み件数         5件
2009/06/16 20:13:43 正常判定件数         5件
2009/06/16 20:13:43 廃棄判定件数         0件
2009/06/16 20:13:43 構成情報ファイル 整合性チェック・終了
2009/06/16 20:13:43
2009/06/16 20:13:43 構成情報ファイル CSV形式チェック・開始
2009/06/16 20:13:43 構成情報ファイル CSV形式チェック (グループ情報) ・開始
2009/06/16 20:13:43 000001件目  (001,富士通株式会社,)  ・・・  OK
2009/06/16 20:13:43 000002件目  (002,営業部,001)  ・・・  OK
2009/06/16 20:13:43 構成情報ファイル CSV形式チェック (グループ情報) ・終了
2009/06/16 20:13:43 構成情報ファイル CSV形式チェック (CT情報) ・開始
2009/06/16 20:13:43 000003件目  (user001+DTPSV,001)  ・・・  OK
2009/06/16 20:13:43 000004件目  (dtp+dtkct2,002)  ・・・  OK
2009/06/16 20:13:43 構成情報ファイル CSV形式チェック (CT情報) ・終了
2009/06/16 20:13:43 正常判定件数         4件
2009/06/16 20:13:43 エラー判定件数       0件
2009/06/16 20:13:43 構成情報ファイル CSV形式チェック・終了

      ～～（略）～～

2009/06/16 20:13:44 CT情報移動・開始
2009/06/16 20:13:44 CT移動件数               1件
2009/06/16 20:13:44 CT情報移動・終了
2009/06/16 20:13:44
2009/06/16 20:13:44 正常終了しました。
2009/06/16 20:13:44
2009/06/16 20:13:44 Systemwalker Desktop Patrol構成情報取り込み処理・終了

【CTグループ構成情報と、クライアント(CT)の位置情報、廃棄フォルダ情報を連携したい場合】

C:\WINDOWS\system32>DTKIMPDP.exe /START C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv /E C:\DTPIMPORT\disposal.csv /G "廃棄"
2009/06/16 20:28:33 Systemwalker Desktop Patrol構成情報取り込み処理・開始
2009/06/16 20:28:33 起動パラメーター    : /START
2009/06/16 20:28:33 構成情報ファイル名  : C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:28:33 オプション          : /E C:\DTPIMPORT\disposal.csv /G 廃棄
2009/06/16 20:28:33
2009/06/16 20:28:33 構成情報ファイル 整合性チェック・開始
2009/06/16 20:28:33 バージョン情報  ・・・  OK
2009/06/16 20:28:33 ファイル形式    ・・・  OK
2009/06/16 20:28:33 チェック        ・・・  OK
2009/06/16 20:28:33 読み込み件数         5件
2009/06/16 20:28:33 正常判定件数         5件
2009/06/16 20:28:33 廃棄判定件数         0件
2009/06/16 20:28:33 構成情報ファイル 整合性チェック・終了
2009/06/16 20:28:33

      ～～（略）～～

2009/06/16 20:28:34
2009/06/16 20:28:34 CT情報移動・開始
2009/06/16 20:28:34 CT移動件数               0件
2009/06/16 20:28:34 CT情報移動・終了
2009/06/16 20:28:34
2009/06/16 20:28:34 廃棄フォルダ情報ファイル CT情報移動・開始
2009/06/16 20:28:34 CT移動件数               1件
2009/06/16 20:28:34 廃棄フォルダ情報ファイル CT情報移動・終了
2009/06/16 20:28:34
2009/06/16 20:28:34 正常終了しました。
2009/06/16 20:28:34
2009/06/16 20:28:34 Systemwalker Desktop Patrol構成情報取り込み処理・終了

【CTグループ構成情報と、クライアント(CT)の位置情報、ユーザーグループ構成情報を連携したい場合】

C:\WINDOWS\system32>DTKIMPDP.exe /START C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv /U
2009/06/16 20:31:05 Systemwalker Desktop Patrol構成情報取り込み処理・開始
2009/06/16 20:31:05 起動パラメーター    : /START
2009/06/16 20:31:05 構成情報ファイル名  : C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:31:05 オプション          : /U
2009/06/16 20:31:05
2009/06/16 20:31:06 構成情報ファイル 整合性チェック・開始
2009/06/16 20:31:06 バージョン情報  ・・・  OK
2009/06/16 20:31:06 ファイル形式    ・・・  OK
2009/06/16 20:31:06 チェック        ・・・  OK
2009/06/16 20:31:06 読み込み件数         5件

      ～～（略）～～

2009/06/16 20:31:06 構成情報ファイル データチェック (ユーザーグループ情報連携確認) ・終了
2009/06/16 20:31:06
2009/06/16 20:31:06 ユーザーグループ差分更新・開始
2009/06/16 20:31:07 ユーザーグループ追加       2件
2009/06/16 20:31:07 ユーザーグループ更新       0件
2009/06/16 20:31:07 ユーザーグループ削除       0件
2009/06/16 20:31:07 ユーザーグループ差分更新・終了
2009/06/16 20:31:07
2009/06/16 20:31:07 正常終了しました。
2009/06/16 20:31:07
2009/06/16 20:31:07 Systemwalker Desktop Patrol構成情報取り込み処理・終了

【CTグループ構成情報と、クライアント(CT)の位置情報、ユーザーグループ構成情報、ユーザー位置情報を連携したい場合】

C:\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構成情報取り込み処理・開始
2009/06/16 20:37:40 起動パラメーター    : /START
2009/06/16 20:37:40 構成情報ファイル名  : C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:37:40 オプション          : /U /F C:\DTPIMPORT\usercomp.csv
2009/06/16 20:37:40
2009/06/16 20:37:40 構成情報ファイル 整合性チェック・開始
2009/06/16 20:37:40 バージョン情報  ・・・  OK
2009/06/16 20:37:40 ファイル形式    ・・・  OK
2009/06/16 20:37:40 チェック        ・・・  OK
2009/06/16 20:37:40 読み込み件数         5件
2009/06/16 20:37:40 正常判定件数         5件
2009/06/16 20:37:40 廃棄判定件数         0件
2009/06/16 20:37:40 構成情報ファイル 整合性チェック・終了
2009/06/16 20:37:40

      ～～（略）～～

2009/06/16 20:37:41 ユーザー情報移動・開始
2009/06/16 20:37:41 ユーザー移動件数           1件
2009/06/16 20:37:41 ユーザー情報移動・終了
2009/06/16 20:37:41
2009/06/16 20:37:42 正常終了しました。
2009/06/16 20:37:42
2009/06/16 20:37:42 Systemwalker Desktop Patrol構成情報取り込み処理・終了

【CTグループ構成情報と、クライアント(CT)の位置情報を連携したい場合で、ジョブスケジューラ等に登録するため、10回のリトライ設定と、実行ログファイル指定をした場合】

C:\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構成情報取り込み処理・開始
2009/06/16 20:39:40 起動パラメーター    : /START
2009/06/16 20:39:40 構成情報ファイル名  : C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:39:40 オプション          : /R 10 /L C:\temp\exec.log
2009/06/16 20:39:40
2009/06/16 20:39:40 構成情報ファイル 整合性チェック・開始
2009/06/16 20:39:40 バージョン情報  ・・・  OK
2009/06/16 20:39:40 ファイル形式    ・・・  OK
2009/06/16 20:39:40 チェック        ・・・  OK
2009/06/16 20:39:40 読み込み件数         5件
2009/06/16 20:39:40 正常判定件数         5件
2009/06/16 20:39:40 廃棄判定件数         0件
2009/06/16 20:39:40 構成情報ファイル 整合性チェック・終了
2009/06/16 20:39:40

      ～～（略）～～

2009/06/16 20:39:40 CT情報移動・開始
2009/06/16 20:39:40 CT移動件数               0件
2009/06/16 20:39:40 CT情報移動・終了
2009/06/16 20:39:40
2009/06/16 20:39:41 正常終了しました。
2009/06/16 20:39:41
2009/06/16 20:39:41 Systemwalker Desktop Patrol構成情報取り込み処理・終了

【トレース出力設定をしたい場合】

C:\WINDOWS\system32>DTKIMPDP.exe /START C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv  /T 5
2009/06/16 20:41:32 Systemwalker Desktop Patrol構成情報取り込み処理・開始
2009/06/16 20:41:32 起動パラメーター    : /START
2009/06/16 20:41:32 構成情報ファイル名  : C:\DTPIMPORT\dtkdwn_0616201054125_admin.csv
2009/06/16 20:41:32 オプション          : /T 5
2009/06/16 20:41:32
2009/06/16 20:41:33 構成情報ファイル 整合性チェック・開始
2009/06/16 20:41:33 バージョン情報  ・・・  OK
2009/06/16 20:41:33 ファイル形式    ・・・  OK
2009/06/16 20:41:33 チェック        ・・・  OK
2009/06/16 20:41:33 読み込み件数         5件
2009/06/16 20:41:33 正常判定件数         5件
2009/06/16 20:41:33 廃棄判定件数         0件
2009/06/16 20:41:33 構成情報ファイル 整合性チェック・終了
2009/06/16 20:41:33
2009/06/16 20:41:33 構成情報ファイル CSV形式チェック・開始

      ～～（略）～～

2009/06/16 20:41:33 CT情報移動・開始
2009/06/16 20:41:33 CT移動件数               0件
2009/06/16 20:41:33 CT情報移動・終了
2009/06/16 20:41:33
2009/06/16 20:41:34 正常終了しました。
2009/06/16 20:41:34
2009/06/16 20:41:34 Systemwalker Desktop Patrol構成情報取り込み処理・終了

【以前のSystemwalker Desktop Patrol構成情報取り込みで取り込んだCTグループ情報、ユーザーグループ情報を削除したい場合】

C:\WINDOWS\system32>DTKIMPDP.exe /DELETE
2009/06/16 20:43:12 Systemwalker Desktop Patrol構成情報取り込み処理・開始
2009/06/16 20:43:12 起動パラメーター    : /DELETE
2009/06/16 20:43:12 オプション          :
2009/06/16 20:43:12
2009/06/16 20:43:12 Systemwalker Desktop Patrol構成情報取り込みコマンドで作成した情報を削除します。
2009/06/16 20:43:12
2009/06/16 20:43:12 CTグループ削除           2件
2009/06/16 20:43:12 CT情報移動               2件
2009/06/16 20:43:12 ユーザーグループ削除       2件
2009/06/16 20:43:12 ユーザー情報移動           1件
2009/06/16 20:43:12
2009/06/16 20:43:12 正常終了しました。
2009/06/16 20:43:12
2009/06/16 20:43:12 Systemwalker Desktop Patrol構成情報取り込み処理・終了