Recover To Latest Point In Time For A SQL DB

Description

Copies the latest recovery point of the specified SQL databases to the destination folder on a production server. Save this script as a .ps1 file and run it. Usage and examples of scripts can be found by calling them with ‘-?’ or ‘-help’ from inside DPM Management Shell.

This script was contributed by the System Center Data Protection Manager (DPM) team. 

Supported Platforms

Script Code

param ([string] $DPMServerName, [string[]] $DatabaseList, [string] $DestinationServerName, [string] $DestinationLocation)
if(("-?","-help") -contains $args[0])
{
    Write-Host "Description: This script copies the latest recovery point of the specified SQL databases to the destination " `
        "folder on a production server."

    Write-Host "Usage: Restore-SqlDatabase.ps1 [-DPMServerName] <Name of the DPM server> [-DatabaseList] <Array of SQL databases " `
        "to restore> [-DestinationServerName <Name of the server to copy the database files to>] " `
        "[-DestinationLocation] <Location on the destination server>"

    Write-Host "Example: Restore-SqlDatabase.ps1 mohitc02 `"mohitc04\* db`", `"mohitc04\reportservertempdb`" mohitc04 `"d:\recoverdir`""
    exit 0
}
if (!$DPMServerName)
{
    $DPMServerName = Read-Host "DPM server name"
    if (!$DPMServerName)
    {
        Write-Error "Dpm server name not specified."
        exit 1
    }
}
if (!$DatabaseList)
{
    $DatabaseList = Read-Host "SQL database to recover"
    if (!$DatabaseList)
    {
        Write-Error "SQL database(s) not specified."
        exit 1
    }
}
if (!$DestinationServerName)
{
    $DestinationServerName = Read-Host "Destination server"
    if (!$DestinationServerName)
    {
        Write-Error "Destination server not specified."
        exit 1
    }
}
if (!$DestinationLocation)
{
    $DestinationLocation = Read-Host "Location on the destination server"
    if (!$DestinationLocation)
    {
        Write-Error "Destination location not specified"
        exit 1
    }
}
if (!(Connect-DPMServer $DPMServerName))
{
    Write-Error "Failed to connect To DPM server $DPMServerName"
    exit 1
}
$datasourceList = @()
Get-ProtectionGroup $DPMServerName | % {Get-Datasource $_} | 
    % {if ($DatabaseList -contains $_.LogicalPath) {$datasourceList += $_}}
# Show all the SQL databases that could not be found as protected data sources.
foreach ($datasourceName in $DatabaseList)
{
    if (@($datasourceList | ? {$_.LogicalPath -ieq $datasourceName}).Length -eq 0)
    {
        Write-Error "Could not find datasource $datasourceName"
    }
}
# Restore the latest recovery point of each SQL data source.
foreach ($datasource in $datasourceList)
{
    # Select the latest recovery point that exists on disk and trigger the restore job.
    foreach ($rp in @(Get-RecoveryPoint -Datasource $datasource | sort -Property RepresentedPointInTime -Descending))
    {
        foreach ($rsl in $rp.RecoverySourceLocations)
        {
            if ($rsl -is [Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.ReplicaDataset])
            {
                $recoveryOption = New-RecoveryOption -TargetServer $DestinationServerName -TargetLocation `
                    $DestinationLocation -RecoveryLocation CopyToFolder -SQL -RecoveryType Restore
                $restoreJob = Recover-RecoverableItem -RecoverableItem $rp -RecoveryOption $recoveryOption `
                    -RecoveryPointLocation $rsl
                break
            }
        }
        if ($restoreJob)
        {
            break
        }
    }
    if ($restoreJob)
    {
        Write-Host "`nRunning restore of $($datasource.LogicalPath) from $($rp.RepresentedPointInTime) to " `
            "$DestinationServerName\$DestinationLocation"
        # Comment out the next seven lines to not wait for one restore job to finish before triggering the next one.
        while (!$restoreJob.HasCompleted)
        {
            Write-Host "." -NoNewLine
            sleep 3
        }
        Write-Host "`nJob status: $($restoreJob.Status)"
    }
    else
    {
        Write-Error "Could not find a recovery point on disk for $($datasource.LogicalPath)"
    }

}

For online peer support, join the microsoft.public.windows.server.scripting community on the msnews.microsoft.com news server. To provide feedback or report bugs in sample scripts or the Scripting Guide, please contact Microsoft TechNet.

Disclaimer

The sample scripts are not supported under any Microsoft standard support program or service. The sample scripts are provided AS IS without warranty of any kind. Microsoft further disclaims all implied warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The entire risk arising out of the use or performance of the sample scripts and documentation remains with you. In no event shall Microsoft, its authors, or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the sample scripts or documentation, even if Microsoft has been advised of the possibility of such damages.

Top of page