Restore.SqlVerify Método (Server, Boolean, String%)

Artículo
04/26/2013

Checks the media on the instance of SQL Server that is represented by the specified Server object, loads backup history information into the history tables, and returns an error message.

Espacio de nombres: Microsoft.SqlServer.Management.Smo
Ensamblado: Microsoft.SqlServer.SmoExtended (en Microsoft.SqlServer.SmoExtended.dll)

Sintaxis

'Declaración
Public Function SqlVerify ( _
    srv As Server, _
    loadHistory As Boolean, _
    <OutAttribute> ByRef errorMessage As String _
) As Boolean
'Uso
Dim instance As Restore 
Dim srv As Server 
Dim loadHistory As Boolean 
Dim errorMessage As String 
Dim returnValue As Boolean 

returnValue = instance.SqlVerify(srv, _
    loadHistory, errorMessage)

public bool SqlVerify(
    Server srv,
    bool loadHistory,
    out string errorMessage
)

public:
bool SqlVerify(
    Server^ srv, 
    bool loadHistory, 
    [OutAttribute] String^% errorMessage
)

member SqlVerify : 
        srv:Server * 
        loadHistory:bool * 
        errorMessage:string byref -> bool

public function SqlVerify(
    srv : Server, 
    loadHistory : boolean, 
    errorMessage : String
) : boolean

Parámetros

srv
Tipo: Microsoft.SqlServer.Management.Smo.Server
A Server object that represents the instance of SQL Server that is targeted by the restore operation.

loadHistory
Tipo: System.Boolean
A Boolean value that specifies whether the history tables will be populated with pertinent backup information. If True, the history tables are populated. Otherwise, False.

errorMessage
Tipo: System.String%
A String value that contains the error message when the method has completed running. This is an output parameter.

Valor devuelto

Tipo: System.Boolean
A Boolean value that indicates whether targeted backup set is readable and complete.If True, the backup set was successfully verified. Otherwise, False.

Ejemplos

The following code example demonstrates how to create a backup of the AdventureWorks2012 database and verify that it is readable and complete.

Dim srv As Server = New Server("(local)")
Dim res As Restore = New Restore()
Dim backup As Backup = New Backup()

backup.Devices.AddDevice("C:\AdventureWorks2012Backup.bak", DeviceType.File)
backup.Database = "AdventureWorks2012"
backup.SqlBackup(srv)

res.Devices.AddDevice("C:\AdventureWorks2012Backup.bak", DeviceType.File)
res.Database = "AdventureWorks2012"
Console.WriteLine(res.SqlVerify(srv, true, "The verification has failed.").ToString())

Powershell

$srv = new-object Microsoft.SqlServer.Management.Smo.Server("(local)")
$res = new-object Microsoft.SqlServer.Management.Smo.Restore
$backup = new-object Microsoft.SqlServer.Management.Smo.Backup

$backup.Devices.AddDevice("C:\AdventureWorks2012Backup.bak", [Microsoft.SqlServer.Management.Smo.DeviceType]::File)
$backup.Database = "AdventureWorks2012"
$backup.SqlBackup($srv)

$res.Devices.AddDevice("C:\AdventureWorks2012Backup.bak", [Microsoft.SqlServer.Management.Smo.DeviceType]::File)
Write-Host $res.SqlVerify($srv, $TRUE, [ref]"The verification has failed.")