Cmdlets > Get-DtRecommendedRestoreOptions

Get-DtRecommendedRestoreOptions

Returns the recommended restoration options

Syntax

Get-DtRecommendedRestoreOptions [-ServiceHost] <Server> [-JobId] <Guid> [-RestoreTarget <Server>] [- RequestCanClearRestoreRequired] [<CommonParameters>]

Get-DtRecommendedRestoreOptions [-ServiceHost] <Server> [-RestoreTarget <Server>] [- RequestCanClearRestoreRequired] -JobInfo <JobInfo> [<CommonParameters>]

Detailed Description

Returns the recommended restoration options for the specified job 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
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.	true	false
Restore Target	Server	Specify the server you wan to restore to. If you do not specify a server, the original source server will be used.	false	false
Request CanClear Restore Required	Switch Parameter	Sets RecommendedRestoreOptions.CanClearRestoreRequired on the RecommendedRestoreOptions object based on whether it is supported by the current job state. You still need to set ClearRestoreRequired on RestoreOptions to clear the restore required state of a job.	false	false
JobInfo	JobInfo	Specify the job information returned from the Get-DtJob cmdlet. The job information can be piped from the Get-DtJob cmdlet and used in this cmdlet.	true	false

Outputs

RecommendedRestoreOptions

Examples

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

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

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

Get-DtRecommendedRestoreOptions -ServiceHost $DtServerObjectBeta -JobId $DtJobForAlpha.Id -RestoreTarget $DtServerObjectAlpha

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 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. Then the recommended restore options for the specified job and server are returned. The connections for the server object are then closed.

If you want to clear the restore required flag, save your recommended restore options to a variable and then set ClearRestoreRequired to true.

$DtRecommendedRestoreOptions = Get-DtRecommendedRestoreOptions -ServiceHost $DtServerObjectBeta -JobId $DtJobForAlpha.Id -RestoreTarget $DtServerObjectAlpha -RequestCanClearRestoreRequired

$DtRestoreOptions = $DtRecommendedRestoreOptions.RestoreOptions

$DtRestoeOptions.ClearRestoreRequired = $true;