Cmdlets > New-DtUvraServer

New-DtUvraServer

Creates a server object

Syntax

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

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

Detailed Description

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.

Parameters

Name	Type	Description	Required	Pipeline Input
Name	String	Specify the name or IP address of the server, cluster, or cluster node.	true	false
Username	String	Specify a user name. If you are using a domain, specify domain\user name.	true	false
Password	String	Specify the password associated with the user you have entered. This password will be visible in plain text.	true	false
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.	false	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.	false	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. See Hiding your password in a PowerShell script for basic details on using this cmdlet. See your Windows PowerShell documentation for detailed instructions.	true	false

Outputs

Server

Examples

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

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha

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.

$DtCredentialEncrypted = Get-Credential

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

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha

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.