Click or drag to resize

Update-DtJobStatus

This cmdlet causes the target server to immediately retrieve a job status update from the source server rather than waiting for the next poll time. Note that the defualt polling interval is 3 seconds. This cmdlet is useful in situations where the interservice polling interval has been set high. For this cmdlet, the -ServiceHost should be your target server.

Syntax

Update-DtJobStatus [-JobId] <Guid> [-ServiceHost] <Server> [<CommonParameters>]

Update-DtJobStatus [-JobInfo] <JobInfo> [-ServiceHost] <Server> [<CommonParameters>]

Parameters
-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.

Required?

true

Position?

2

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-JobInfo<JobInfo>

Specify the job information returned from the Get-DtJob cmdlet. The job information can be piped from the Get-DtJob cmdlet.

Required?

true

Position?

named

Accept Pipeline Input?

true (ByValue)

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

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters.

Examples

------------------EXAMPLE------------------

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 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. The delete options are stored in DtDeleteOptions, then the specific delete option DiscardTargetQueue is set to true. Finally the job is removed using the delete options. The connections for the server object are then closed.

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

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

Update-DtJobStatus -ServiceHost $DtServerObjectBeta -JobId $DtJobForAlpha.Id

$DtJobForAlpha = Get-DtJob -ServiceHost $DtServerObjectBeta -JobId $DtJobForAlpha.Id

Disconnect-DtServer -ServiceHost $DtServerObjectBeta