Common vic-machine Options

This section describes the options that are common to all vic-machine commands. The common options that vic-machine requires relate to the vSphere environment in which you deployed the virtual container host (VCH), and to the VCH itself.

Wrap any option arguments that include spaces or special characters in quotes. For information about option arguments that might require quotes, see Specifying Option Arguments.

You can set environment variables for the --target, --user, --password, and --thumbprint options. For information about setting environment variables, see Set Environment Variables for Key vic-machine Options.

--id

Short name: None

The vSphere Managed Object Reference, or moref, of the VCH, for example vm-100. You obtain the ID of a VCH by running vic-machine ls. If you specify the id option in vic-machine commands, you do not need to specify the --name or --compute-resource options. This option is not used by vic-machine create or vic-machine version.

--id vch_id

--target

Short name: -t

The IPv4 address, fully qualified domain name (FQDN), or URL of the ESXi host or vCenter Server instance on which you deployed the VCH. This option is always mandatory. You specify this option in the same way as you specify the vic-machine create --target option.

--user

Short name: -u

The ESXi host or vCenter Server user account with which to run the vic-machine command. The user account that you specify in --user must have vSphere administrator privileges. You specify this option in the same way as you specify vic-machine create --user.

--password

Short name: -p

The password for the user account on the vCenter Server on which you deployed the VCH, or the password for the ESXi host if you deployed directly to an ESXi host. You specify this option in the same way as you specify vic-machine create --password.

--thumbprint

Short name: None

The thumbprint of the vCenter Server or ESXi host certificate. You specify this option in the same way as you specify vic-machine create --thumbprint.

--compute-resource

Short name: -r

The relative path to the host, cluster, or resource pool in which you deployed the VCH. You specify this option in the same way as you specify vic-machine create --compute-resource.

NOTE: If you specify the id option in vic-machine commands, you do not need to specify the compute-resource option.

--name

Short name: -n

The name of the VCH. This option is mandatory if the VCH has a name other than the default name, virtual-container-host, or if you do not use the id option. You specify this option in the same way as you specify vic-machine create --name.

--timeout

Short name: none

The timeout period for performing operations on the VCH. Specify a value in the format XmYs if the default timeout is insufficient.

--timeout 5m0s

results matching ""

    No results matching ""