Reference Guide › Command-Line Scripting › CA VMware vCenter Server CLI Commands › dpmvc addesxhost Command--Add an ESX Host

dpmvc addesxhost Command--Add an ESX Host

The dpmvc addesxhost command adds an ESX host to a vCenter Server.

This command has the following format:

dpmvc addesxhost
-esx_host_name esxhostname
-vc_server vcservername
[-sc sc_url]
[-wait timeout]
[-pre]
[-post]
-esx_host_user esxhostuser
-esx_host_password esxhostpassword
[-management_ip managementip]
[-host_connect_port hostconnectport]
[-folder_name foldername]
[-datacenter_name datacentername]
[-cluster_name clustername]
[-vim_account_user vimaccountuser]
[-vim_account_password vimaccountpassword]
[-locale iso639value]

-esx_host_name esxhostname

Specifies the name of the ESX server that hosts a VM.

-vc_server vcservername

Specifies the vCenter Server to access when you have multiple vCenter Servers. Optional for single vCenter Server environments.

-sc sc_url

(Optional) Defines the URL for the service controller host.

Example: https://hostname:port/...

hostname

Defines the fully qualified host where the service controller is installed.

Example: localhost.ca.com

port

Defines the listening port for the service controller server.

Example: 80

-wait timeout

(Optional) Indicates whether to display the status of the job and not return until the operation completes, fails, or the timeout period is met (if you specify a timeout value). If you do not specify this option, the CLI returns without waiting for completion. If there is no response, the optional timeout value defines the timeout period in minutes. If you enter the wait option with no timeout value, the CLI uses the default wait time from the caimgconf.cfg file or defaults to 120 minutes. In addition to any positive integer, the following timeout values are also possible:

""

No timeout value.

0

Wait indefinitely.

-pre

(Optional) Specifies whether to generate an event before the operation is performed.

-post

(Optional) Specifies whether to generate an event after the operation is performed.

-esx_host_user esxhostuser

(Optional) Specifies the user name to access the ESX host.

-esx_host_password esxhostpassword

Specifies the password used to access the ESX host.

-management_ip managementip

(Optional) Specifies the management IP.

-host_connect_port hostconnectport

(Optional) Specifies the port used by ESX host to communicate with vCenter Server.

-folder_name foldername

(Optional) Specifies the name of the folder where you can add the ESX host.

-datacenter_name datacentername

(Optional) Specifies the data center where the VM is located.

-cluster_name clustername

(Optional) Specifies the name of the cluster where you can add the ESX host.

-vim_account_user vimaccountuser

(Optional) Specifies the username of the VIM account.

-vim_account_password vimaccountpassword

(Optional) Specifies the password to access the VIM account.

-locale iso639value

(Optional) Specifies an IS0 639_3166 combination to override the default English output, for example, fr_FR for French. To use the locale of the command prompt, specify "native".

Example: Add an ESX Host

This example adds an ESX host, "esx1" to the vCenter Server "myvcenter."

dpmvc addesx -esx_host_name esx1 -vc_server myvcenter -esx_host_user admin
-esx_host_password topsecret