ITリソースの管理状態を変更するコマンドです。JP1/ITRMの探索機能によって発見されたITリソース，手動で追加されたITリソース，およびデプロイの予約がされたITリソースが変更対象になります。このコマンドは次のような場合に使用します。

• 業務システムの変更に伴うマシン入れ替え時に，一括で管理状態を変更する。
• 仮想化ソフトウェアの入れ替えに伴い，仮想化ソフトウェア上の仮想ホストの管理状態を変更する。

• JP1/ITRM ServiceおよびJP1/ITRM DB Serviceが起動している必要があります。
• クラスタ環境の場合は，実行系サーバでコマンドを実行する必要があります。待機系サーバで実行した場合は，エラーとなります。

jirmstatuschange {-res リソース名 | -rg リソースグループ名 |
                 -bg 業務グループ名}
                 -state {monitored |unmonitored |unmanaged |
                 trashed | deleted}
                 [-q]

-res リソース名

管理状態を変更するリソース名を指定します。

-rg リソースグループ名

管理状態を変更するリソースグループ名を指定します。

-bg 業務グループ名

管理状態を変更する業務グループ名を指定します。

-state {monitored | unmonitored | unmanaged | trashed | deleted}

変更後のITリソースの管理状態を指定します。

• monitored：ITリソースの状態を管理対象の監視に変更する。
• unmonitored：ITリソースの状態を管理対象の監視停止に変更する。
• unmanaged：ITリソースの状態を管理対象外に変更する。
• trashed：ITリソースの状態を削除待ちに変更する。
• deleted：ITリソースをJP1/ITRMから削除する。

なお，-rgオプションまたは-bgオプションを指定した場合，-stateオプションでunmanaged，trashed，およびdeletedは指定できません。

-q

非対話形式でコマンドを実行するときに指定します。コマンドを自動実行する場合など，ユーザーの確認を省略したいときに使用します

　

管理状態を変更できるITリソースを次の表に示します。

表1-20　変更対象機器

項番	機器	変更可否
1	物理ホスト	○
2	仮想ホスト	○
3	仮想化ソフトウェア	○
4	仮想化環境管理ソフトウェア	○
5	ネットワークデバイス	○
6	ストレージ	○
7	リソースプール	×
8	VMクラスタ	×
9	vApp	×
10	不明なITリソース	△

（凡例）

○：変更できる。

×：変更できない。

△：一部変更できる。

変更できる管理状態の遷移を次の表に示します。

表1-21　管理状態の遷移

項番	変更前の状態		変更後の状態
			発見	未処理	管理対象		管理対象外	削除待ち	削除/初期状態
					監視	監視停止
1	発見		−	×	○※1，※2	×	○	×	×
2	未処理		×	−	○※1，※2	×	○	×	×
3	管理対象	監視	×	×	−	○	×	○	×
4		監視停止	×	×	○※3	−	×	○	×
5	管理対象外		×	×	○※1	×	−	×	○
6	削除待ち		×	×	○※3，※4	○※5	×	−	○※6
7	削除/初期状態		×	×	×	×	×	×	−

（凡例）

○：遷移できる。

×：遷移できない。

−：変更前後の状態が同じ。

注※1

探索時に情報が取得できなかった不明なITリソースは，遷移できません。

注※2

操作対象のITリソースのホスト名が重複している場合は，遷移できません。

注※3

操作対象のITリソースが手動追加またはデプロイ予定の場合は，遷移できません。

注※4

操作対象のITリソースが仮想ホスト削除タスクによって削除されたITリソースの場合は，遷移できません。

注※5

操作対象のITリソースが手動追加またはデプロイ予定の場合は，遷移できます。

注※6

予約のあるITリソースの場合は削除できません。

• コマンドの実行中に［Ctrl］+［C］キーを押して処理を中止すると，処理が失敗するおそれがあります。正しく処理されているかどうかは，画面で確認してください。
• グループがフォルダによって階層化されているリソースグループまたは業務グループを引数に指定する場合は，最上位のフォルダ名からスラッシュ（/）を区切り文字としてパス形式で指定してください。
  例：フォルダA/フォルダB/リソースグループ1
  

0	正常終了
1	引数不正
2	JP1/ITRM ServiceまたはJP1/ITRM DB Serviceが起動していない
8	メモリ不足
12	通信エラー
16	実行権限がない
19	ユーザー問い合わせで処理を中止した
35	同時に実行できるコマンドの数を超えている
130	［Ctrl］+［C］キーを押してコマンドを中止した
137	指定したITリソース，リソースグループ，または業務グループが存在しない 指定したITリソースが操作対象外のITリソースである
145	操作対象のITリソースの変更に失敗
165	操作対象の一部のITリソースが処理に失敗
254	重複しているリソース名を指定した
255	その他のエラー

ITリソース「hostA」の管理状態を監視停止にする場合

jirmstatuschange -res hostA -state unmonitored

リソースグループ「RG1」の配下のITリソースの管理状態を監視にする場合

jirmstatuschange -rg RG1 -state monitored