jirmstatuschange
機能
ITリソースの管理状態を変更するコマンドです。JP1/ITRMの探索機能によって発見されたITリソース,手動で追加されたITリソース,およびデプロイの予約がされたITリソースが変更対象になります。このコマンドは次のような場合に使用します。
実行時の前提条件
形式
jirmstatuschange {-res リソース名 | -rg リソースグループ名 |
-bg 業務グループ名}
-state {monitored |unmonitored |unmanaged |
trashed | deleted}
[-q]
引数
-res リソース名
管理状態を変更するリソース名を指定します。
-rg リソースグループ名
管理状態を変更するリソースグループ名を指定します。
-bg 業務グループ名
管理状態を変更する業務グループ名を指定します。
-state {monitored | unmonitored | unmanaged | trashed | deleted}
変更後のITリソースの管理状態を指定します。
なお,-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 | 削除/初期状態 | × | × | × | × | × | × | - |
注意事項
戻り値
0 | 正常終了 |
1 | 引数不正 |
2 | JP1/ITRM ServiceまたはJP1/ITRM DB Serviceが起動していない |
8 | メモリ不足 |
12 | 通信エラー |
16 | 実行権限がない |
19 | ユーザー問い合わせで処理を中止した |
35 | 同時に実行できるコマンドの数を超えている |
130 | [Ctrl]+[C]キーを押してコマンドを中止した |
137 |
|
145 | 操作対象のITリソースの変更に失敗 |
165 | 操作対象の一部のITリソースが処理に失敗 |
254 | 重複しているリソース名を指定した |
255 | その他のエラー |
使用例1
ITリソース「hostA」の管理状態を監視停止にする場合
jirmstatuschange -res hostA -state unmonitored
使用例2
リソースグループ「RG1」の配下のITリソースの管理状態を監視にする場合
jirmstatuschange -rg RG1 -state monitored