get_add_host_status

Displays the latest status of an Add Host session.

Format

emcli get_add_host_status
      -session_name="Session name"
      [-details]
      [-show_only_failed_hosts]
      [-host_name="Host name"]
      [-noheader]
      [-script | -format=
                 [name:<pretty|script|csv>];
                 [column_separator:"column_sep_string"];
                 [row_separator:"row_sep_string"];
        ]

[ ]  indicates that the parameter is optional.

Options

• session_name

  Name of the session whose status you want to view.

• details

  Displays additional information for the given session.

• show_only_failed_hosts

  Displays only the hosts on which the Add Host operation failed.

• host_name

  Displays the details of the provided host.

• noheader

  Display tabular output without column headers.

• script

  This is equivalent to -format="name:script".

• format

  Format specification (default is -format="name:pretty").

  • format="name:pretty" prints the output table in a readable format not intended to be parsed by scripts.

  • format="name:script" sets the default column separator to a tab and the default row separator to a newline. The column and row separator strings can be specified to change these defaults.

  • format="name:csv" sets the column separator to a comma and the row separator to a newline.

  • format=column_separator:"column_sep_string" column-separates the verb output by <column_sep_string>. Rows are separated by the newline character.

  • row_separator:"row_sep_string" row-separates the verb output by <row_sep_string>. Rows are separated by the tab character.

Output Columns

Host, Platform Name, Initialization, Remote Prerequisite, Agent Deployment, Error

Error Codes

0 - Success

1 and 223 - Syntax Error

Examples

Example 1

This example displays the detailed status of host 'example.com' for the session 'ADD_HOST_SYSMAN_Jun_6_2013_11:26:43_PM_PDT'.

emcli get_add_host_status
 -session_name=ADD_HOST_SYSMAN_Jun_6_2013_11:26:43_PM_PDT
 -host_name=example.com

Example 2

This example displays only the failed hosts for the session 'ADD_HOST_SYSMAN_Jun_6_2013_11:26:43_PM_PDT'.

emcli get_add_host_status
 -session_name=ADD_HOST_SYSMAN_Jun_6_2013_11:26:43_PM_PDT
 -show_only_failed_hosts