2.9.1 OSユーザーの一覧一括取得
機能
このサービステンプレートは，Windows/UNIXのOSユーザーの一覧を，CSVファイルからサーバ一覧を取得して一括取得します。
このサービステンプレートが前提とするサーバを次に示します。
・Windowsサーバ
・UNIXサーバ
次の作業を実施します。
(1) CSVファイルの指定した列から，Windows/UNIXサーバの一覧を取得します。CSVファイルの1行目は列名を記述してください。2行目から100行目までデータを記述してください。ホスト名またはIPアドレスを記述してある列が最低一つ必要です。
(例1)
ホスト名
hostVM001
hostVM002
(例2)
ホスト名,コメント
hostVM001,#Comment1
hostVM002,#Comment2
"172.16.254.7",#Comment3
(2) CSVファイルに記述できるホスト名またはIPアドレスの件数は99件以下で，かつ
（ホスト名またはIPアドレスの文字列長の合計値）+ホスト件数
が1017文字以下です。
(3) 読み込んだフィールドには次のチェックを行います。どれかの条件に当てはまると，タスクが失敗します。
(a)フィールドの文字列長が1024文字より大きい
(b)フィールドに次の特殊記号を含む
「,」(ローカルサーバがWindows環境の場合)，「<」，「>」，「|」，「;」，「&」，「*」，「?」，「`」，「%」，両端以外の「"」および末尾の「¥」
(c)フィールドに制御文字(0x00〜0x1f)を含む
(4) Windows/UNIXサーバごとにOSユーザーの一覧を，指定されたファイルにテキスト形式で出力します。ファイルの名称は「OS_Users_XXXX」です。XXXXにはCSVファイルの指定した列の記述内容に応じてホスト名またはIPアドレスが指定されます。Windowsの場合，ファイルの出力フォーマットは，net userコマンドの出力結果と同じ形式です。
(5) OSユーザー一覧ファイルをローカルサーバの指定されたフォルダに転送します。Windows/UNIXサーバ上の転送元ファイルは削除します。
CSVファイル読み込みに失敗した場合は，OS.fileOpenRetryIntervalプロパティに指定した秒数待ってファイル読み込みをリトライする処理を，OS.fileOpenRetryCountプロパティに指定した回数繰り返します。各プロパティの値は，利用している環境に合わせて調整してください。
JP1/AOサーバ，実行対象サーバのOSがWindowsの場合，このサービステンプレートの実行にはAdministratorユーザ(ビルトインAdministratorアカウント)が必要です。各サーバにadministratorユーザ(ビルトインAdministratorアカウント)が存在しない場合，または，無効の場合，システムアカウントで実行を行うサービス「OSユーザーの一覧一括取得(SYSTEM)」を実行してください。
前提条件
【サービステンプレート実行システム内前提製品】/【サービステンプレート実行システム内Windows/UNIXサーバの稼働OS】の最新のサポート状況については，リリースノートを参照してください。
また、OSおよび製品について略称を用いています。対象とするOSおよび製品については「はじめに」を参照してください。
【サービステンプレート実行システム内前提製品】
なし。
【サービステンプレート実行システム内Windows/UNIXサーバの稼働OS】
(1) Windows Server
(2) Red Hat Enterprise Linux Server
(3) Oracle Linux
【システム内前提製品の使用条件】
なし。
【サービステンプレート実行システム内前提製品の使用条件】
なし。
注意事項
【CSVファイルに関する注意事項】
・ローカルサーバがWindows環境の場合の注意事項
(1) CSVファイル中のIPアドレスは二重引用符号(")で囲んでおく必要があります。
(2) ODBCドライバの制限のため，CSVファイル名には「[」，「]」，「!」，「`」は使用できません。
(3) データの途中に空白行がある場合，空白行も行数としてカウントされます。データが記述された行が99行以内であっても，途中の空白行を含めた行数が100以上となる場合，タスクが異常終了するのでご注意ください。
・ローカルサーバがUNIX環境の場合の注意事項
(1) データの途中に空白行がある場合，空白行も行数としてカウントされます。データが記述された行が99行以内であっても，途中の空白行を含めた行数が100以上となる場合，タスクが異常終了するのでご注意ください。
(2) データには「,」は使用できません。使用した場合，列を正しく区切ることができないため，データを取得できません。
(3) CSVファイルの行の先頭または末尾に存在する半角スペースおよびタブ記号は，その個数に関係なく，存在しないものとみなします。
【CSVファイル以外の注意事項】
(1) このサービスを実行する場合，エージェントレス接続先としてローカルサーバ("localhost"で解決されるループバックアドレス)およびOSユーザーの一覧を取得するサーバを設定する必要があります。
(2) OSユーザーの一覧を取得するサーバのOSがUNIXの場合は，プロパティにマルチバイト文字を使用しないでください。
(3) OSユーザーの一覧を取得するサーバのOSがWindowsでマルチバイト文字を指定する場合は，Windows用出力フォルダ(リモート)プロパティの指定値は248バイト以内となるよう指定してください。
(4) マルチバイト文字を指定する場合は，出力フォルダ名(ローカル)プロパティの指定値は256バイト以内となるよう指定してください。
(5) 「サーバ名の列番号」プロパティには255以内の整数値を指定してください。途中の空白列も列数に含まれますのでご注意ください。
(6) リモートおよびローカルに指定するフォルダ名が既に存在する場合，既存のフォルダを上書きします。また，フォルダの下に同名のファイルが存在する場合も上書きします。そのため，指定したフォルダ名に誤りがないか，十分に確認してください。
(7) リモートに指定したパスのフォルダが存在しない場合は，そのフォルダを作成します。作成したフォルダは削除せずに残ります。定期的に使用しない場合は削除してください。
実行権限
ビルトイン Administrator
バージョン
04.00.00
タグ
Gather OS information,Linux,Windows
プロパティ一覧
［サービス設定］画面に表示されるプロパティの一覧を次に示します。
- （凡例）
-
○：プロパティの指定は必須です。
△：プロパティの指定は省略可能です。ただし，ほかのプロパティの指定内容によっては，指定が必須になります。各プロパティの「説明」を確認してください。
|
プロパティキー |
プロパティ名 |
説明 |
入出力種別 |
共有設定 |
必須区分 |
|---|---|---|---|---|---|
|
OS.fileOpenRetryCount |
ファイル読み込み時のリトライ回数:Windows固有 |
ファイルの読み込みに失敗した場合のリトライ回数を指定します(Windowsの場合だけ)。ファイル読み込み時のリトライ間隔と組み合わせて最大待ち時間となります。"0"を指定した場合はリトライしません。 |
入力 |
無効 |
○ |
|
OS.fileOpenRetryInterval |
ファイル読み込み時のリトライ間隔:Windows固有 |
ファイルの読み込みに失敗した場合のリトライ間隔を秒単位で指定します(Windowsの場合だけ)。 |
入力 |
無効 |
○ |
［サービス設定］画面および［サービス実行］画面に表示されるプロパティの一覧を次に示します。
|
プロパティキー |
プロパティ名 |
説明 |
入出力種別 |
共有設定 |
必須区分 |
|---|---|---|---|---|---|
|
OS.excelFileName |
CSVファイル名(ローカル) |
サーバ一覧を管理するCSVファイル名をフルパスで指定します。 |
入力 |
無効 |
○ |
|
OS.Column1 |
サーバ名の列番号 |
CSVファイルの列番号を1〜255で指定します。 |
入力 |
無効 |
○ |
|
OS.userType |
OSユーザー種別 |
操作対象のOSユーザー種別をlocal(ローカル)またはdomain(ドメイン)で指定します。このプロパティはOSユーザーの一覧を取得するサーバのOSがWindowsの場合だけ有効です。 |
入力 |
無効 |
△ |
|
OS.listOutputFolderNameRemote_Windows |
Windows用出力フォルダ(リモート) |
OSユーザーの一覧を出力するWindowsサーバのフォルダ名をフルパスで指定します。転送後にリモートのファイルは削除されます。 ユーザー一覧の取得先にWindowsサーバが含まれる場合には必ず指定してください。 |
入力 |
無効 |
△ |
|
OS.listOutputDirectoryNameRemote_Linux |
UNIX用出力ディレクトリ名(リモート) |
OSユーザーの一覧を出力するUNIXサーバのディレクトリ名をフルパスで指定します。転送後にリモートのファイルは削除されます。ユーザー一覧の取得先にUNIXサーバが含まれる場合には必ず指定してください。 |
入力 |
無効 |
△ |
|
OS.listOutputFolderNameLocal |
出力フォルダ名(ローカル) |
OSユーザーの一覧を出力するフォルダ名をフルパスで指定します。 |
入力 |
無効 |
○ |
［タスク詳細］画面にだけ表示されるプロパティの一覧を次に示します。
|
プロパティキー |
プロパティ名 |
説明 |
入出力種別 |
共有設定 |
|---|---|---|---|---|
|
common.taskResult |
繰り返しタスクの実行結果 |
タスクごとの成功(true)，失敗(false)をコンマ区切りで出力します。 |
出力 |
無効 |
［サービス設定］画面に表示されるプロパティの入力制限を次に示します。
|
プロパティキー |
入力可能文字 |
|---|---|
|
OS.fileOpenRetryCount |
0〜32767の整数値。 |
|
OS.fileOpenRetryInterval |
1〜60の整数値。 |
［サービス設定］画面および［サービス実行］画面に表示されるプロパティの入力制限を次に示します。
|
プロパティキー |
入力可能文字 |
|---|---|
|
OS.excelFileName |
256文字以内の文字列。ただし，「<」，「>」，「|」，「;」，「&」，「*」，「?」，「"」，「%」および末尾の「¥」を除く。 |
|
OS.Column1 |
数字だけ。 |
|
OS.userType |
次の値のどれかを選択する。 local,domain |
|
OS.listOutputFolderNameRemote_Windows |
248文字以内の文字列。ただし，「<」，「>」，「|」，「;」，「&」，「*」，「?」，「"」，「%」および末尾の「¥」を除く。 |
|
OS.listOutputDirectoryNameRemote_Linux |
256文字以内の文字列。ただし，「<」，「>」，「|」，「;」，「&」，「*」，「?」，「"」，「%」，「`」および末尾の「¥」を除く。 |
|
OS.listOutputFolderNameLocal |
248文字以内の文字列。ただし，「<」，「>」，「|」，「;」，「&」，「*」，「?」，「"」，「%」および末尾の「¥」を除く。 |
フロー仕様詳細
フロー仕様詳細を次の表に示します。
|
階層 |
[タスク詳細]画面での表示名 |
ステップ名 |
部品 |
||
|---|---|---|---|---|---|
|
部品名 |
説明 |
エラー時の回復方法 |
|||
|
1 |
OS種別の出力 |
OS種別の出力 |
OS種別の出力 |
ローカルサーバのOSを出力します。 |
エラー原因を取り除いたあと，サービスを再実行してください。 |
|
2 |
サーバ名一覧ファイル読み取り |
サーバ名一覧ファイル読み取り |
CSV・Excelの列データ取得 |
CSVファイルからWindows/UNIXサーバのホスト名またはIPアドレスのリストを取得します。 |
エラーの原因を取り除いたあと，サービスを再実行してください。 |
|
3 |
一括取得 |
一括取得 |
繰り返し実行部品 |
取得したホスト名に対して，繰り返しOSユーザーの一覧取得を行います。 |
エラーの原因を取り除いたあと，サービスを再実行してください。 |