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

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

Espace de noms : Microsoft.SqlServer.Management.Smo
Assembly : Microsoft.SqlServer.SmoExtended (en Microsoft.SqlServer.SmoExtended.dll)

Syntaxe

'Déclaration
Public Function SqlVerify ( _
    srv As Server, _
    loadHistory As Boolean, _
    <OutAttribute> ByRef errorMessage As String _
) As Boolean
'Utilisation
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

Paramètres

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

loadHistory
Type : 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
Type : System.String%
A String value that contains the error message when the method has completed running. This is an output parameter.

Valeur de retour

Type : 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.

Exemples

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.")