This cmdlet creates a server object with specific credentials associated with it. This cmdlet is specific to the full server to ESX appliance job type. The server object may be one of the following types of servers: Double-Take server, virtual recovery appliance, or VMware host. The object is used to communicate with the Double-Take Management Service.

Syntax

New-DtUvraServer [-UserName] <String> [-Password] <String> [-Port] <Int32> [-Name] <String> [-Role] <String> [<CommonParameters>]

New-DtUvraServer [-Credential] <PSCredential> [-Port] <Int32> [-Name] <String> [-Role] <String> [<CommonParameters>]

Parameters

-Port<Int32>

Specify the port for the XML web service protocol. By default, that is 443. Use 6325 for Double-Take servers and appliances, unless you changed the default Double-Take port. Do not specify a port for VMware hosts.

Required?	false
Position?	named
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Name<String>

Specify the name or IP address of the server, cluster, or cluster node.

Required?	true
Position?	1
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-UserName<String>

Specify a user name. If you are using a domain, specify domain\user name.

Required?	false
Position?	2
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Password<String>

Specify the password associated with the user you have entered. This password will be visible in plain text.

Required?	false
Position?	3
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Credential<PSCredential>

Specify the credential object returned from the Windows PowerShell Get-Credential cmdlet. This password will not be visible because Windows stores an encrypted password.

Required?	true
Position?	named
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Role<String>

Specify one of the following roles for the server object you are creating. These servers are used when you specify the -OtherServers parameter in other cmdlets.

TargetVimServer - This is the ESX server or vCenter that will host the replica virtual machine after failover. If you are using vCenter, specify your vCenter. Only specify an ESX host if you are using ESX standalone.

ReverseVimServer - This is the ESX server or vCenter server that will host the replica virtual after reverse and failover. If you are using vCenter, specify your vCenter. Only specify an ESX host if you are using ESX standalone.

ReverseHelperRole - This is the target where data will be replicated after a reverse.

Required?	false
Position?	named
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters.

Examples

------------------EXAMPLE 1------------------

A server object is created for the server alpha using port 6325 and the domain\administrator and password credentials. It assigns the server object to the variable called DtServerObject. The connections for the server object are then closed.

$DtServerObjectAlpha= New-DtUvraServer -Name alpha -UserName domain\administrator -Password password -Port 6325

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha

------------------EXAMPLE 2------------------

User credentials are stored in a variable called $DtCredential. The script will prompt you to supply the username and password and the credentials will be encrypted. Then the stored credentials are used to create a new server object for the server alpha using port 6325. It assigns the server object to the variable called DtServerObject. The connections for the server object are then closed.

$DtCredentialEncrypted = Get-Credential

$DtServerObjectAlpha = New-DtUvraServer -Name alpha -Credential $DtCredential -Port 6325

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha