Set-DtOption

This cmdlet sets the value of the Double-Take server or job option for the specified server. For this cmdlet, the -ServiceHost could be your source or target server.

Syntax

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

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

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

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

Parameters

-Setting<Hashtable>

Specify a hash table using the format @{option1=value1; option2=value2}.

Required?	true
Position?	2
Accept Pipeline Input?	true (ByValue, ByPropertyName)
Accept Wildcard Characters?	false

-Name<String>

Specify the name of the job or server option.

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

-IntValue<Int64>

Specify an integer value for the server or job option.

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

-StringValue<String>

Specify a single string (text) value for the server or job option

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

-MultiStringValue<String[]>

Specify multiple string (text) values for the server or job option in an array using the format @(string1, string2).

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

-ServiceHost<Server>

Specify the server object returned from the New-DtServer cmdlet.

Required?	true
Position?	1
Accept Pipeline Input?	true (ByPropertyName)
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 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 -Setting @{MaxChecksumBlocks=64; MirrorChunkSize=131072}

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha

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

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.

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

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

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha