Cmdlets > New-DtJob

New-DtJob

Creates a job

Syntax

New-DtJob [-ServiceHost] <Server> [-Source] <Server> [-JobType] <String> [-JobOptions] <JobOptions> [[-OtherServers] <Server[]>] [<CommonParameters>]

 

New-DtJob [-ServiceHost] <Server> [-CreateOptions] <CreateOptions> [<CommonParameters>]

Detailed Description

This cmdlet creates the specified job type on 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 should be your target server.

true false
Source Server

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

true false
JobType String

Specify the type of job from the following list.

  • ClusterAwareDTHV—Cluster-aware agentless Hyper-V job
  • ClusterAwareExchange—Cluster-aware Exchange job
  • ClusterAwareFilesAndFolders—Cluster-aware files and folders job
  • ClusterAwareHV2V—Cluster-aware virtual to Hyper-V job
  • ClusterAwareMultiSelectDthv—Cluster-aware agentless Hyper-V job
  • ClusterAwareSql—Cluster-aware SQL job
  • DataOnlyImageProtection—DR data protection job
  • DataOnlyImageRecovery—DR data recovery job
  • Diagnostics—Throughput Diagnostic Utility job
  • DTHV—Agentless Hyper-V job
  • Exchange—Exchange job
  • FilesAndFolders—Files and folders job
  • FullServerFailover—Full server job
  • FullServerImageProtection—DR full server protection job
  • FullServerImageRecovery—DR full server recovery job
  • Legacy—GeoCluster jobs
  • LinuxFullServerFailover—Full server for Linux job
  • Lvra—Full server to ESX appliance job
  • MoveDataOnlyMigration—Data migration job
  • MoveServerMigration—Full server migration job
  • MultiSelectDTHV—Agentless Hyper-V job
  • OrphanedConnection—Old, orphaned connection (if Double-Take was uninstalled and then reinstalled on a target server or possibly after failover, depending on the state of your servers before failover occurred)
  • SQL—SQL job
  • UnmanagedConnection—Double-Take versions 5.2.x and earlier
  • UVRA—Double-Take version 7.0.1 or earler full server to ESX appliance job
  • V2V—V to ESX or V to Hyper-V job
  • VRA—Full server to ESX or full server to Hyper-V job
  • VraMove—Full server to ESX migration or full server to Hyper-V migration job
true false
JobOptions JobOptions

Specify the JobOptions returned from the Get-DtRecommendedJobOptions cmdlet.

false false
Other
Servers
Server

Specify the server object returned from the New-DtServer cmdlet. Specify multiple server objects in an array using the format @($server1, $server2).

false false
Create
Options
Create
Options

Specify the create options available in DoubleTake.Jobs.Contract.CreateOptions. Use the Windows PowerShell New-Object cmdlet to create this object.

true false

Outputs

Guid

Examples

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

$DtServerObjectBeta = New-DtServer -Name beta -UserName domain\administrator -Password password

$DtWorkloadGuid = New-DtWorkload -ServiceHost $DtServerObjectAlpha -WorkloadTypeName FilesAndFolders

$DtWorkload = Get-DtWorkload -ServiceHost $DtServerObjectAlpha -WorkloadId $DtWorkloadGuid

$DtJobOptions = Get-DtRecommendedJobOptions -ServiceHost $DtServerObjectBeta -Source $DtServerObjectAlpha -JobType FilesAndFolders -Workload $DtWorkload

$DtFnFJobGuid = New-DtJob -ServiceHost $DtServerObjectBeta -Source $DtServerObjectAlpha -JobType FilesAndFolders -JobOptions $DtJobOptions.JobOptions

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha

Disconnect-DtServer -ServiceHost $DtServerObjectBeta

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. A server object is created for the server beta using the domain\administrator and password credentials. It assigns the server object to the variable called DtServerObjectBeta. The script then creates a workload on the server for a files and folders job, returning a global unique ID for the workload, and assigns that ID to the variable DtWorkloadGuid. The workload definition for the workload type and the server is then stored in the DtWorkload variable. The recommended job options for the servers and the workload type are then stored in the variable DtJobOptions. A new files and folders job is created using the servers and the job options. The job ID is stored in the variable DtFnFJobGuid. The connections for the server object are then closed.