jssmemberlist(メンバー一覧出力)
機能
JP1/Service Supportに登録されているロールに所属するユーザー(メンバー)の一覧をCSVファイルで出力します。コマンドの実行中に処理を中止すると,中止する直前までのメンバー一覧を出力します。
形式
jssmemberlist -o メンバー一覧ファイル名 [-roleid ロールID] [-f]
実行権限
Administrators権限
格納先フォルダ
JP1/SSパス\bin\
引数
-o メンバー一覧ファイル名
出力するメンバー一覧ファイル名を255バイト以内で指定します。ファイル名は絶対パス,または相対パスで指定できますが,相対パスで指定した場合も,絶対パスに変換したあとの文字列が255バイト以下になるように指定してください。また,ファイル名に「-」で始まる文字列は指定できません。なお,メンバー一覧ファイル名に全角文字が含まれる場合,全角文字は2バイトに換算されます。
-roleid ロールID
特定のロールに登録されているメンバー一覧だけを出力する場合に,そのロールのロールIDを1〜64バイトの半角英数字またはシステムロールのロールIDで指定します。
-f
ファイルを上書きする場合に指定します。
戻り値
戻り値 |
意味 |
---|---|
0 |
正常終了 |
1 |
異常終了 |
メンバー一覧ファイルの内容
メンバー一覧ファイルには次のような形式でデータが出力されます。
なお,CSVファイルに出力されるボディ部の1行目には,属性名が出力されます。
出力される内容について説明します。
- ヘッダー部
-
出力順
項目の内容
出力する値
1
製品名
JP1/Service Support
2
出力されるファイルのバージョン
出力されるファイルのバージョンを6けたの文字列で表す
3
文字コード
出力されるファイルの文字コード
4
出力データの種別
MEMBERLIST
5
出力したメンバー数
Total Count of Members : 件数
(出力例)Total Count of Members : 2
- ボディ部
-
出力順
項目の内容
1
ロールID
2
ユーザーID
3
名前
4
英語名
5
所属組織
6
役職
7
役職順位
8
メールアドレス
9
電話番号
10
電話番号2
11
コメント
実行時の前提条件
-
コマンド実行時のサービスの状態については,「12. コマンド」の「コマンド実行時のサービスの状態」を参照してください。
-
jssmemberlistコマンドは,二つ以上同時に実行できません。
注意事項
-
jssmemberlistコマンドの実行中に[Ctrl]+[C]キーなどでコマンドの実行を打ち切った場合,メンバー一覧の出力に失敗するおそれがあります。このため,コマンドの実行中に[Ctrl]+[C]キーなどで実行を打ち切らないでください。もし実行を打ち切った場合は,しばらく時間を置いてからコマンドを再実行してください。
-
jssmemberlistコマンドで一度に出力できるメンバー数は最大65,530件です。65,531件以上のメンバー情報を出力したい場合は,-roleidオプションでメンバー数を絞り込み,jssmemberlistコマンドを複数回実行してください。
-
出力される情報に,UTF-8にはマッピングされていて,Shift-JISにはマッピングされていない文字を含む場合,出力されるCSVファイルの該当文字は「?」に変換されます。
使用例
ロールIDが「Role1」のロールに所属するユーザーの一覧を,メンバー一覧ファイル(c:\member\member01.csv)に出力する場合の実行例を次に示します。
jssmemberlist -o c:\member\member01.csv -roleid Role1