get_blackouts

すべてのブラックアウト、または指定したターゲットあるいは1つ以上のホストのブラックアウトをリストします。ユーザーが表示権限を持つブラックアウトのみリストされます。

書式

emcli get_blackouts
      [-target=<name1:type1> | -hostnames=<host1;host2;...>]
      [-noheader]
      [-script | -format=
                        [name:<pretty|script|csv>];
                        [column_separator:<column_sep_string>];
                        [row_separator:<row_sep_string>];
      ]

[ ]  indicates that the parameter is optional

オプション

• target

  このターゲットのブラックアウトをリストします。このオプションも-hostnamesオプションも指定されていない場合、ユーザーが表示権限を持つすべてのブラックアウトがリストされます。

• hostnames

  指定されたホストの1つにターゲットを持つブラックアウトをリストします。ホスト名は、ホスト・ターゲットのターゲット名の部分です。たとえば、host.example.com:hostではなくhost.example.comと指定します。このオプションも-targetオプションも指定されていない場合、ユーザーが表示権限を持つすべてのブラックアウトがリストされます。

• noheader

  列見出しのない表形式の情報を表示します。

• script

  これは、-format="name:script"と同じです。

• format

  書式指定(デフォルトは-format="name:pretty")。

  • format="name:pretty"は、スクリプトによる解析を目的としない読取り可能な書式で出力表を出力します。

  • format="name:script"は、デフォルトの列セパレータをタブに、デフォルトの行セパレータを改行に設定します。列および行セパレータの文字列を指定して、これらのデフォルトを変更できます。

  • format="name:csv"は、列セパレータをカンマに、行セパレータを改行に設定します。

  • format="name:script;column_separator:<column_sep_string>"は、verb出力の列を<column_sep_string>で区切ります。行は改行で区切られます。

  • format="name:script;row_separator:<row_sep_string>"は、verb出力の行を<row_sep_string>で区切ります。列はタブ文字で区切られます。

出力列

名前、作成者、ステータス、ステータスID、次回開始、期間、理由、頻度、繰返し、開始時間、終了時間、前回終了時間、タイムゾーン・リージョン、タイムゾーン・オフセット

例

例1

この例では、ホストmyhost.example.comの一部のターゲットを対象とするすべてのブラックアウトを表示します。

emcli get_blackouts -hostnames=myhost.example.com

例2

この例では、ホストmyhost.example.comまたはホストyourhost.example.comの一部のターゲットを対象とするすべてのブラックアウトを表示します。

emcli get_blackouts -hostnames=myhost.example.com
-hostnames=yourhost.example.com