This cmdlet waits for the job validation process triggered by Confirm-DtJobOptions to complete before processing any additional cmdlets. For this cmdlet, the -ServiceHost should be your target server.

Syntax

Wait-DtConfirmJobOptions [-Token] <ActivityToken> [-Any] <SwitchParameter> [-Timeout] <Int32> [-ServiceHost] <Server> [<CommonParameters>]

Parameters

-Token<ActivityToken>

Specify the confirm action object returned from the Confirm-DtJobOption cmdlet.

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

-Any<SwitchParameter>

Only wait for the first validation to finish before continuing.

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

-Timeout<Int32>

Specify the length of time, in seconds, to wait for the process to complete. For example, 120 would wait two minutes and then the next cmdlet would processed. If you set the timeout to zero (0), there is no timeout delay and the next cmdlet is immediately processed. If you do not specify a timeout parameter, the timeout will default to forever.

Required?	false
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------------------

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 job options used by the job are confirmed, and the validation result is stored in DtValidation. The script then waits until the validation is complete before continuing. 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}

$DtValidation = Confirm-DtJobOptions -ServiceHost $DtServerObjectBeta -JobId $DtJobForAlpha.Id -JobOptions $DtJob.Options

Wait-DtConfirmJobOptions -ServiceHost $DtServerObjectBeta -Token $DtValidation

Disconnect-DtServer -ServiceHost $DtServerObjectBeta