Cmdlets > Set-DtOption

Set-DtOption

Sets server or job options

Syntax

Set-DtOption [-ServiceHost] <Server> [-Setting] <Hashtable>] [<CommonParameters>]

Set-DtOption [-ServiceHost] <Server> [-Name] <String> -MultiStringValue <String[]> [<CommonParameters>]

Set-DtOption [-ServiceHost] <Server> [-Name] <String> -IntValue <Int64> [<CommonParameters>]

Set-DtOption [-ServiceHost] <Server> [-Name] <String> -StringValue <String> [<CommonParameters>]

Detailed Description

This cmdlet sets the value of the Double-Take server or job option for the specified server.

Parameters

Name	Type	Description	Required	Pipeline Input
Service Host	Server	Specify the server object returned from the New-DtServer cmdlet. For this cmdlet, the -ServiceHost could be your source or target server.	true	false
Setting	Hashtable	Specify a hash table using the format @{option1=value1; option2=value2}. See the Double-Take Reference Guide for details on each job and server option.	true	false
Name	String	Specify the name of the job or server option. See the Double-Take Reference Guide for details on each job and server option. .	true	false
IntValue	Int64	Specify an integer value for the server or job option. See the Double-Take Reference Guide for details on each job and server option.	true	false
StringValue	String	Specify a single string (text) value for the server or job option	true	false
MultiString Value	String	Specify multiple string (text) values for the server or job option in an array using the format @(string1, string2).	true	false

Outputs

None

Examples

$DtServerObjectAlpha= New-DtServer -Name alpha -UserName domain\administrator -Password password

Set-DtOption -ServiceHost $DtServerObjectAlpha -Setting @{MaxChecksumBlocks=64; MirrorChunkSize=131072}

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha

A server object is created for the server alpha using the domain\administrator and password credentials. It assigns the server object to the variable called DtServerObjectAlpha. Then the server settings MaxChecksumBlocks and MirrorChunkSize are set to 64 and 131072, respectively, on the server. The connections for the server object are then closed.

$DtServerObjectAlpha= New-DtServer -Name alpha -UserName domain\administrator -Password password

Set-DtOption -Servicehost $DtServerObjectAlpha -Name MirrorChunkSize -IntValue 64

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha

A server object is created for the server alpha using the domain\administrator and password credentials. It assigns the server object to the variable called DtServerObjectAlpha. Then it sets the MirrorChunkSize server setting to 64. The connections for the server object are then closed.

See Viewing and setting job and server options for a sample script that gathers and sets several Double-Take job and server options.