Cmdlets > Get-DtJobActionStatus

Get-DtJobActionStatus

Returns the status of a job action

Syntax

Get-DtJobActionStatus [-ServiceHost] <Server> [[-JobId] <Guid>] [<CommonParameters>]

 

Get-DtJobActionStatus [-ServiceHost] <Server> [-Action] <ActivityToken> [<CommonParameters>]

 

Detailed Description

This cmdlet returns the status of a job action that has been queued for job. The first syntax returns the status of all of the actions queued for the specified job. The second syntax returns the status for the job action object specified.

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
JobId Guid

Specify the job GUID returned from the New-DtJob cmdlet or the Id within the job information returned from the Get-DtJob cmdlet.

false false
Action ActivityToken

Specify a Double-Take job action object.

true false

Outputs

ActivityStatusEntry

Examples

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

$DtJobForAlpha = Get-DtJob -ServiceHost $DtServerObjectBeta | Where-Object { $_.Statistics.CoreConnectionDetails.SourceMachineName -eq $DtServerObjectAlpha}

Get-DtJobActionStatus -ServiceHost $DtServerObjectBeta -JobId $DtJobForAlpha.Id

Disconnect-DtServer -ServiceHost $DtServerObjectBeta

The job(s) are retrieved from DtServerObjectBeta, but only the job information where the source machine name is equivalent to the name stored in the variable DtServerObjectAlpha is retrieved. That information is then stored in the variable DtJobForAlpha. 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. Finally, the status of the job action is returned. The connections for the server object are then closed.