ユーザー管理用コマンドライン版ツール

ユーザーの管理をコマンドラインで行うツールです。ご利用にはEVECLOUDの組織管理者権限が必要です。
インポート時、インポート結果がローカルにてログ出力されます。C:\Log\usermgr_YYYYMMDD.log

ツールデータは、以下よりダウンロードいただけます。

ユーザー管理用のコマンドライン版ツール

UserMgr.zip | 6.55 MB

ダウンロード

ユーザー管理用のコマンドライン版ツール（NoPass版）

パスワードを一切出力しないバージョンです。
-withpassコマンドが必要ありません。パスワードは全てアスタリスクでカバーされます。

UserMgr_NoPass.zip | 6.55 MB

ダウンロード

iniファイルの準備

ダウンロードした UserMgr.zip ファイルを解凍し、「UserMgr」フォルダ内の「usermgr.ini」ファイルをエディタ等で開きます。
iniファイルの内容は以下の通りです。必須項目である [account] セクションにカスタマIDと組織管理者権限のアカウント内容を記載します。

iniファイル詳細

キー	値	内容	必須
[server]
uri	文字列	通常は設定の必要はありません。デモ用途などで製品以外のサーバーを利用する場合は指定します。	―
proxy	文字列	社内のプロキシサーバーを経由して通信する場合は指定します。 https://[FQDN or IP]:[port]	―
authsetid	数値	パスワード認証ができる認証セットを指定します。基本的には「10000」の値から変更しないでください。	―
[account]
customerId	文字列	EVECLOUDのカスタマIDを指定します。	必須
userId	文字列	組織管理者アカウントのユーザーIDを指定します。	必須
password	文字列	組織管理者アカウントのパスワードを指定します。	必須
[log]
output	文字列	ログの出力方法を指定します。 none：出力しない（既定） console：画面に出力 file：ファイルに出力	―
folder	文字列	ログのファイル出力先フォルダを指定（output = file 時に有効）します。例: folder = C:\UserMgrLog ※指定しない場合は、usermgr.exeと同フォルダ内の log フォルダに出力されます。	―

使用方法

下記オプション一覧を参考にいずれかを引数として指定し、実行します。指定したグループやユーザーの情報を取得、または編集が出来ます。
※省略に「可」がついている引数を省略した場合、（省略時：）の内容の動きをします。

オプション一覧　※ "="[イコール] は省略できます。

引数	省略	内容
-list-group=all	―	グループの一覧を取得
-add-user=ユーザID	―	ユーザを追加
-password=パスワード	可	ユーザのパスワードを設定 add-user時に指定（省略時：ランダム生成）
-groupid=グループID	可	add-userの対象グループ（省略時："default-group"）
-role=権限	可	ユーザの権限を設定 add-user時に指定（省略時：1（一般ユーザー）） 1：一般ユーザー 2：グループ管理者 3：組織管理者
-delete-user=ユーザID	―	ユーザを削除
-get-user=ユーザID	―	ユーザ情報を取得
-list-user=グループID or all	―	グループ内のユーザ一覧を取得（all：カスタマ内のユーザ一覧を取得）
-search-user=検索文字列	―	ユーザを検索
-csv-import="ファイル名"	―	CSVからユーザをインポート（ファイル名はダブルクォートで囲ってください）
-csv-export=グループID or all	―	グループ内の全ユーザ情報をCSVにエクスポート（all：カスタマ内の全ユーザー情報をCSVにエクスポート）
-csv-validate="ファイル名"	―	CSV ファイルをサーバーに送信せず、全行を事前検証（ヘッダー・CSV 形式に加え、userid / groupid / mail などの値の妥当性も確認） ※ サーバー未接続・未認証でも実行できます ※ パスワード長・複雑さなど認証ポリシー依存の検証は送信時にサーバーで行われます
-withpass	可	get-user / csv-export 時に各アプリの平文パスワードを含めて出力（省略時はパスワードはマスク表示「******」または空で返します） ※ 出力内容には平文パスワードが含まれます。取り扱いには十分注意してください。 ※ NoPass版のツールでは`-withpass`コマンドが必要ありません。パスワードは全てアスタリスクでカバーされます。

使用例　※ "="[イコール] は省略できます。ファイルパスはご利用の環境に合わせてください。

usermgr.exe -list-group=all
usermgr.exe -add-user=taro -password=p@ssword -role=1
usermgr.exe -get-user taro
usermgr.exe -csv-import "users.csv"

CSVインポート

-csv-import 時のファイルは、文字コード［SHIFT-JIS］でインポートしてください。
CSVファイルの詳細は「ユーザーのインポート＞CSVファイルのレイアウト」を参照してください。

グループID指定（必須）

コマンドライン版を使用する際は「groupId」の指定が必須です。

CSVフィールド名	項目名	値	内容
groupId	グループID	文字列	必須項目。グループIDを指定

[注意事項]
コマンドライン版でのインポート時、CSVには「groupId」の指定が必須ですが、管理ツールからCSVでユーザーデータをインポートする際は、グループ選択の後にインポートを行うため「groupId」の記載は必要ありません。

顔画像インポート

以下の方法で顔認証用顔画像のインポートが可能です。

CSVフィールド名	項目名	値	内容
template54	顔認証の顔画像	文字列	顔画像のあるファイルパスを指定
template55	顔認証v2の顔画像	文字列	顔画像のあるファイルパスを指定

[補足事項１]顔画像の置き場所について
CSVインポートの「template54」または、「template55（顔認証v2 の場合）」フィールドに顔画像の置いてあるパスを正確に記入してください。

[補足事項２]登録する顔画像の条件

JPEG形式
顔全体＋顔周辺部（顔サイズｘ２倍程度）
顔のサイズは縦/横 200ピクセル以上
周辺部込みで縦/横 400ピクセル程度
マスクの着用がないもの
手ブレ・ボケ等のないもの
目を閉じたり、隠れていないもの

Windowsログオン情報一括削除

Windowsログオンの登録情報をCSVで一括削除が可能です。

CSVフィールド名	項目名	値	内容
winlogon_[インデックス番号]_delete^※１	Windowsログオンの登録情報削除	ブール	true：削除する^※２（mode=update のみ）

※１：[インデックス番号]はWindowsログオンアカウント単位で分類した重複していない任意の数値
※２：false の指定は無効（変化無し）

例：

mode,userid,groupid,winlogon_2_delete
update,taro,default-group,true

[注意事項]管理ツールからのインポートで使用する際は、必ずコマンドライン版からエクスポートして入手したCSVデータを利用してインポートを行ってください。エクスポート→インポートを1セットとして使用することがポイントです。
それ以外の方法ですとデータの順番が保証できないため、予想外のデータが削除される恐れがあります。