rmhostclustermember

Use the rmhostclustermember command to remove a host from a host cluster object.

Syntax

Read syntax diagramSkip visual syntax diagram rmhostclustermember -host host_id_listhost_name_listhost_uuid_list -keepmappings-removemappings-force hostcluster_idhostcluster_namehostcluster_uuid

Parameters

-host host_id_list | host_name_list| host_uuid_list
(Required) Specifies (by ID or name or UUID) the colon-separated host list to remove from the host cluster.
-keepmappings
(Optional) Specifies that the host that is removed from the host cluster retains the host cluster's shared volume mappings. The -keepmappings and -removemappings parameters are mutually exclusive.
-removemappings
(Optional) Specifies that the host that is removed from the host cluster does not retain the host cluster's shared volume mappings. The -keepmappings and -removemappings parameters are mutually exclusive.
-force
(Optional) Forces a removal. You must specify this parameter when you remove the last host from a host cluster.
hostcluster_id | hostcluster_name| hostcluster_uuid
(Required) Specifies (by ID or name) that the host cluster that the host is removed from. The value for the ID must be a number and the value for the name must be an alphanumeric string.

Description

This command removes a host from a host cluster object.

Note: This command is available during the upgrade process.
When using the partition IP address to run this command, consider the following:
  • The user must identify objects using the name or UUID. Short IDs cannot be specified when using the partition IP address.
  • Only objects belonging to the partition can be created or acted upon. When creating new objects, the -partition parameter will be auto-populated for the partition. You cannot move items out of a partition when using the partition IP address.

An invocation example that removes host 0 from host cluster 0 (and also removes the host mappings)

 rmhostclustermember -host 0 -removemappings 0

The detailed resulting output:

No feedback.