PowerCLI Reference

Add-VMHost

Synopsis

This cmdlet adds a host to be managed by a vCenter Server system.

Syntax

Add-VMHost [-Name] <String> [-Port <Int32>] [-Location] <VIContainer> [-Credential <PSCredential>] [-User <String>] [-Password <String>] [-Force] [-RunAsync] [-Server <VIServer[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-VMHost
Move-VMHost
Remove-VMHost
Restart-VMHost
Set-VMHost
Start-VMHost
Stop-VMHost
Suspend-VMHost

Detailed Description

This cmdlet adds a host to be managed by a vCenter Server system. The host is added to the datacenter or folder specified by the Location parameter. One of the User/Password and Credential parameters must be provided in order to authenticate with the host. If both are specified, the Credential parameter is used and the User and Password parameters are ignored.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
NameStringSpecifies the name of the host you want to add to a vCenter Server system.truefalse
LocationVIContainerSpecifies a datacenter or folder where you want to place the host.truetrue (ByValue)
ConfirmSwitchParameterIf the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.falsefalse
CredentialPSCredentialSpecifies a PSCredential object that contains credentials for authenticating with the virtual machine host.falsefalse
ForceSwitchParameterIndicates that the cmdlet runs even if the authenticity of the host SSL certificate cannot be verified.falsefalse
PasswordStringSpecifies the password you want to use for authenticating with the host.falsefalse
PortInt32Specifies the port on the host you want to use for the connection.falsefalse
RunAsyncSwitchParameterIndicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter run "help About_RunAsync" in the VMware PowerCLI console.falsefalse
ServerVIServer[]Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.falsefalse
UserStringSpecifies the user name you want to use for authenticating with the host.falsefalse
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

The newly added VMHost object

Notes

Add-VMHost works only if there is a connection to vCenter Server.

Examples

-------------- Example 1 --------------

$myServer = Connect-VIServer -Server 10.23.112.235
Add-VMHost -Server $myServer -Name MyVMHost1 -Location MyDatacenter1 -User MyUsername1 -Password MyPassword1

Adds a VM host to a specified vCenter Server system and provides a username and password for authentication.

-------------- Example 2 --------------

$myCredentials = Get-VICredentialStoreItem -File "C:\MyCredentials.xml"
$myServer = Connect-VIServer -Server 10.23.112.235
Add-VMHost -Server $myServer -Name MyVMHost1 -Location MyDatacenter1 -Credentials $myCredentials

Adds a VM host to a vCenter Server system and specifies a PSCredential object that contains authentication credentials.

-------------- Example 3 --------------

$myCredentials = Get-VICredentialStoreItem -File "C:\MyCredentials.xml"
$myServer = Connect-VIServer -Server 10.23.112.235
Add-VMHost -Server $server -Name MyVMHost1 -Location MyDatacenter1 -Credentials $myCredentials -Port MyVMHostPortNumber1 -Confirm:$false

Adds a VM host to a vCenter Server system without asking for confirmation and specifies a port on the host for connecting.

-------------- Example 4 --------------

$myCredentials = Get-VICredentialStoreItem -File "C:\MyCredentials.xml"
$myServer = Connect-VIServer -Server 10.23.112.235
Add-VMHost -Server $myServer -Name MyVMHost1 -Location MyDataCenter1 -Credentials $myCredentials -Port MyVMHostPortNumber1 -Force

Adds a VM host to a vCenter Server system even if the authenticity of the host SSL certificate cannot be verified.


Copyright © VMware, Inc. All rights reserved.