Adds a vCenter Server system or ESXi host as a vMA target server.

vifp addserver <server>
[--authpolicy <fpauth | adauth>]
[--protocol <http | https>]
[--portnumber <portnum>]
[--servicepath <servicepath>]
[--username <username>]
[--password <password>]

After a server is added as a vMA target, you must run vifptarget server before you run vSphere CLI commands or vSphere SDK for Perl scripts against that system. The system remains a vMA target across vMA reboots, but running vifptarget again is required after each logout. See vifptarget Command for vi-fastpass Initialization.

After you run vifptarget, you can run vSphere CLI or vSphere SDK for Perl commands and scripts and you are no longer prompted for authentication information, as follows:

If you add a vCenter Server system as a vMA target, you can run most commands on all ESXi hosts that the vCenter Server system manages using the vSphere CLI --vihost command. The vSphere CLI Installation and Reference Guide includes a table that shows which commands cannot target a vCenter Server system.

If you add only one ESXi host, you can run commands without specifying the target.

If you add multiple ESXi hosts, specify the target to avoid confusion. See Add Target Servers to vMA and Running vSphere CLI for the Targets.

Note

If you change a target server’s name, you must remove it, and then add it to vMA with the new name.

Options

Option

Description

server

Name or IP address of the ESXi host or vCenter Server system to add as a vMA target.

authpolicy

Sets the authentication policy to fastpass authentication or the Active Directory authentication. The default value is fpauth.

protocol

Connection protocol. HTTPS by default.

portnumber

Connection port number of the target server. The default is 443.

servicepath

Service path URL of the target server. The default is /sdk.

username

User who connects to the target server. If the target server points to an ESXi host, the default is root. The user must have superuser privileges on the ESXi host. If the target server points to a vCenter Server system, there is no default. You are prompted for a user name if you do not specify one using this option. The user must have privileges to connect to the vCenter Server system.

password

Password of the user specified by username.

vifp addserver my_vCenter

Adds a vCenter Server system as a vMA target. You are prompted for a user name and password. The user must have login privileges on the vCenter Server system.

vifp addserver myESX42

Adds an ESXi host to vi-fastpass. You are prompted for the root password for the target system.