Restore-SqlDatabase

Module:

SQLPS Module

Restaure une base de données à partir d’enregistrements de sauvegarde ou de journal des transactions.

Syntaxe

ByPath (Par défaut)

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-Path <String[]>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -InputObject <Server[]>
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByName

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -ServerInstance <String[]>
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-Credential <PSCredential>]
    [-ConnectionTimeout <Int32>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByDBObject

Restore-SqlDatabase
    [-DatabaseObject] <Database>
    [[-BackupFile] <String[]>]
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Restore-SqlDatabase effectue des opérations de restauration sur une base de données SQL Server. Cela inclut les restaurations complètes de bases de données, les restaurations de journaux des transactions et les restaurations de fichiers de base de données.

Cette applet de commande est modélisée après la classe Microsoft.SqlServer.Management.Smo.Restore . Les paramètres de cette applet de commande correspondent généralement aux propriétés de l’objet Smo.Restore .

Exemples

Exemple 1 : Restaurer une base de données à partir d’un fichier de sauvegarde sur un partage réseau

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.bak"

Cette commande restaure la base de données mainDB complète à partir du fichier \\mainserver\databasebackup\MainDB.bak sur l’instance de serveur Ordinateur\Instance.

Exemple 2 : Restaurer un journal des transactions de base de données

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log

Cette commande restaure le journal des transactions de la base de données MainDB à partir du fichier \\mainserver\databasebackup\MainDB.trn sur l’instance de serveur Ordinateur\Instance.

Exemple 3 : Restaurer une base de données et demander un mot de passe

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.bak" -Credential (Get-Credential "sa")

Cette commande restaure la base de données mainDB complète à partir du fichier \\mainserver\databasebackup\MainDB.trn sur l’instance de serveur Computer\Instance, à l’aide de la connexion SA SQL. Cette commande vous invite à entrer un mot de passe pour terminer l’authentification.

Exemple 4 : Restaurer un journal des transactions avec l’option NORECOVERY

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log -NoRecovery

Cette commande restaure le journal des transactions de la base de données MainDB avec l’option NORECOVERY à partir du fichier \\mainserver\databasebackup\MainDB.trn sur l’instance de serveur 'Computer\Instance'.

Exemple 5 : Restaurer les enregistrements du journal des transactions jusqu’à un point dans le temps

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log -ToPointInTime "Nov 11, 2011 11:11 AM"

Cette commande restaure le journal des transactions de la base de données MainDB jusqu’à la date passée au paramètre ToPointInTime , le 11 novembre 2011 11:11.

Exemple 6 : Restaurer une base de données et déplacer les fichiers journaux et les données

PS C:\> $RelocateData = New-Object Microsoft.SqlServer.Management.Smo.RelocateFile("MainDB_Data", "c:\MySQLServer\MainDB.mdf")
PS C:\> $RelocateLog = New-Object Microsoft.SqlServer.Management.Smo.RelocateFile("MainDB_Log", "c:\MySQLServer\MainDB.ldf")
PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RelocateFile @($RelocateData,$RelocateLog)

Cet exemple restaure la base de données mainDB complète sur l’instance de serveur Ordinateur\Instance, puis déplace les fichiers de données et les fichiers journaux. Pour chaque fichier déplacé, l’exemple construit une instance de la classe Microsoft.SqlServer.Management.Smo.RelocateFile . Chaque constructeur prend deux arguments, le nom logique du fichier et l’emplacement physique où le fichier sera placé sur le serveur cible. Les objets RelocateFile sont passés au paramètre RelocateFile de l’applet de commande Restore-SqlDatabase .

Exemple 7 : Restaurer une base de données à partir d’une bande

PS C:\> $TapeDevice = New-Object Microsoft.Sqlserver.Management.Smo.BackupDeviceItem("\\.\tape0", "Tape")
PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupDevice $TapeDevice

Cet exemple restaure la base de données MainDB à partir de l’appareil de bande nommé \\.\tape0 sur l’instance de serveur Ordinateur\Instance. Pour représenter cet appareil, l’exemple construit une instance de la classe Microsoft.Sqlserver.Management.Smo.BackupDeviceItem . Le constructeur prend deux arguments, le nom de l’appareil de sauvegarde et le type de l’appareil de sauvegarde. Cet objet BackupDeviceItem est ensuite passé au paramètre -BackupDevice de l’applet de commande Restore-SqlDatabase .

Exemple 8 : Restaurer une base de données à partir du service Stockage Blob Azure

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "https://mystorageaccountname.blob.core.windows.net/container/MyDB.bak" -SqlCredential "mySqlCredential"

Cette commande restaure la base de données mainDB complète à partir du fichier sur le service Stockage Blob Windows Azure sur l’ordinateur\instance de l’instance de serveur.

Paramètres

-BackupDevice

Spécifie les appareils où les sauvegardes sont stockées. Ce paramètre ne peut pas être utilisé avec le paramètre BackupFile . Utilisez ce paramètre si vous sauvegardez sur un appareil à bande.

Propriétés du paramètre

Type:	BackupDeviceItem[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-BackupFile

Spécifie l’emplacement ou les emplacements où sont stockés les fichiers de sauvegarde. Ce paramètre est facultatif. S’il n’est pas spécifié, l’emplacement de sauvegarde par défaut du serveur est recherché pour le nom <de la base de données name.trn> pour les restaurations de journaux ou <le nom> de la base de données.bak pour tous les autres types de restaurations. Ce paramètre ne peut pas être utilisé avec le paramètre BackupDevice . Si vous sauvegardez le service Stockage Blob Windows Azure (URL), ce paramètre ou le paramètre BackupDevice doit être spécifié.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	3
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-BlockSize

Spécifie la taille de bloc physique, en octets, pour la sauvegarde. Les tailles prises en charge sont 512, 1024, 2048, 4096, 8192, 16384, 32768 et 65536 (64 Ko) octets. La valeur par défaut est 65536 pour les appareils à bande et 512 pour tous les autres appareils.

Propriétés du paramètre

Type:	Int32
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-BufferCount

Spécifie le nombre total de tampons d'E/S à utiliser pour l'opération de sauvegarde. Vous pouvez spécifier n’importe quel entier positif. S’il y a un espace d’adressage virtuel insuffisant dans le processus de Sqlservr.exe pour les mémoires tampons, vous recevrez une erreur de mémoire insuffisante.

Propriétés du paramètre

Type:	Int32
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Checksum

Indique qu’une valeur de somme de contrôle est calculée pendant l’opération de restauration.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ClearSuspectPageTable

Indique que la table de pages suspecte est supprimée après l’opération de restauration.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	cf

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConnectionTimeout

Spécifie le nombre de secondes à attendre pour une connexion serveur avant un échec de délai d’expiration. La valeur de délai d’expiration doit être un entier compris entre 0 et 65534. Si 0 est spécifié, les tentatives de connexion ne expirent pas.

Propriétés du paramètre

Type:	Int32
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ByName

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ContinueAfterError

Indique que l’opération se poursuit lorsqu’une erreur de somme de contrôle se produit. Si elle n’est pas définie, l’opération échoue après une erreur de somme de contrôle.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Credential

Spécifie un objet PSCredential qui contient les informations d’identification d’une connexion SQL Server qui a l’autorisation d’effectuer cette opération.

Propriétés du paramètre

Type:	PSCredential
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ByName

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Database

Spécifie le nom de la base de données à restaurer. Cela ne peut pas être utilisé avec le paramètre DatabaseObject . Lorsque ce paramètre est utilisé, les paramètres Path, InputObject ou ServerInstance doivent également être spécifiés.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ByPath

Position:	2
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

ByObject

Position:	2
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

ByName

Position:	2
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DatabaseFile

Spécifie les fichiers de base de données ciblés par l’opération de restauration. Cela est utilisé uniquement lorsque le paramètre RestoreAction est défini sur Files. Lorsque le paramètre RestoreAction est défini sur Files, le paramètre DatabaseFileGroups ou DatabaseFiles doit également être spécifié.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DatabaseFileGroup

Spécifie les groupes de fichiers de base de données ciblés par l’opération de restauration. Cela est utilisé uniquement lorsque le paramètre RestoreAction est défini sur File. Lorsque le paramètre RestoreAction est défini sur Files, le paramètre DatabaseFileGroups ou DatabaseFiles doit également être spécifié.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DatabaseObject

Spécifie un objet de base de données pour l’opération de restauration.

Propriétés du paramètre

Type:	Database
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ByDBObject

Position:	2
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-FileNumber

Spécifie le numéro d’index utilisé pour identifier le jeu de sauvegarde ciblé sur le support de sauvegarde.

Propriétés du paramètre

Type:	Int32
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-InputObject

Spécifie l’objet serveur de l’instance SQL Server où la restauration se produit.

Propriétés du paramètre

Type:	Server[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ByObject

Position:	Named
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-KeepReplication

Indique que la configuration de réplication est conservée. Si elle n’est pas définie, la configuration de la réplication est ignorée par l’opération de restauration.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-MaxTransferSize

Spécifie le nombre maximal d’octets à transférer entre le support de sauvegarde et l’instance SQL Server. Les valeurs possibles sont des multiples de 65536 octets (64 Ko), jusqu’à 4194304 octets (4 Mo).

Propriétés du paramètre

Type:	Int32
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-MediaName

Spécifie le nom qui identifie un jeu de supports.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-NoRecovery

Indique que la base de données est restaurée dans l’état de restauration. Une opération de restauration ne se produit pas et des sauvegardes supplémentaires peuvent être restaurées.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-NoRewind

Indique qu’un lecteur de bande est laissé ouvert à la position de fin lorsque la restauration est terminée. S’il n’est pas défini, la bande est rewound une fois l’opération terminée. Cela ne s’applique pas aux restaurations de disque.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Offset

Spécifie les adresses de page à restaurer. Cela est utilisé uniquement lorsque le paramètre RestoreAction est défini sur OnlinePage.

Propriétés du paramètre

Type:	Int64[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Partial

Indique que l’opération de restauration est une restauration partielle.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-PassThru

Indique que cette applet de commande génère l’objet Smo.Backup utilisé pour effectuer l’opération de restauration.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Path

Spécifie le chemin d’accès de l’instance SQL Server sur laquelle exécuter l’opération de restauration. Ce paramètre est facultatif. S’il n’est pas spécifié, l’emplacement de travail actuel est utilisé.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ByPath

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-RelocateFile

Spécifie une liste d’objets de fichier Smo.Relocate . Chaque objet se compose d’un nom de fichier de sauvegarde logique et d’un emplacement de système de fichiers physique. La restauration déplace la base de données restaurée dans l’emplacement physique spécifié sur le serveur cible.

Propriétés du paramètre

Type:	RelocateFile[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ReplaceDatabase

Indique qu’une nouvelle image de la base de données est créée. Cela remplace toute base de données existante portant le même nom. Si elle n’est pas définie, l’opération de restauration échoue lorsqu’une base de données portant ce nom existe déjà sur le serveur.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Restart

Indique que cette applet de commande reprend une opération de restauration partiellement terminée. S’il n’est pas défini, l’applet de commande redémarre une opération de restauration interrompue au début du jeu de sauvegarde.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-RestoreAction

Spécifie le type d’opération de restauration qui est effectué. Les valeurs valides sont les suivantes :

• Base de données. La base de données est restaurée.
• Fichiers. Un ou plusieurs fichiers de données sont restaurés. Le paramètre DatabaseFile ou DatabaseFileGroup doit être spécifié.
• Rapport. Le journal de translaction est restauré.
• OnlinePage. Une page de données est restaurée en ligne afin que la base de données reste disponible pour les utilisateurs.
• OnlineFiles. Les fichiers de données sont restaurés en ligne afin que la base de données reste disponible pour les utilisateurs. Le paramètre DatabaseFile ou DatabaseFileGroup doit être spécifié.

Propriétés du paramètre

Type:	RestoreActionType
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-RestrictedUser

Indique que l’accès à la base de données restaurée est limité au rôle de base de données fixe db_owner et aux rôles serveur fixe dbcreator et sysadmin.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Script

Indique que cette applet de commande génère un script Transact-SQL qui effectue l’opération de restauration.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ServerInstance

Spécifie le nom d’une instance SQL Server. Cette instance de serveur devient la cible de l’opération de restauration.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ByName

Position:	Named
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-SqlCredential

Spécifie un objet d’informations d’identification SQL Server qui stocke les informations d’authentification. Si vous sauvegardez sur le service de stockage d’objets blob, vous devez spécifier ce paramètre. Les informations d’authentification stockées incluent le nom du compte de stockage et les valeurs de clé d’accès associées. Ne spécifiez pas ce paramètre pour le disque ou la bande.

Propriétés du paramètre

Type:	PSObject
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-StandbyFile

Spécifie le nom d’un fichier d’annulation utilisé dans le cadre de la stratégie d’imagerie d’une instance SQL Server.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-StopAtMarkAfterDate

Spécifie la date à utiliser avec le nom de marque spécifié par le paramètre StopAtMarkName pour déterminer le point d’arrêt de l’opération de récupération.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-StopAtMarkName

Spécifie la transaction marquée à laquelle arrêter l’opération de récupération. Cela est utilisé avec le paramètre StopAtMarkAfterDate pour déterminer le point d’arrêt de l’opération de récupération. Les données récupérées incluent la transaction qui contient la marque. Si la valeur StopAtMarkAfterDate n’est pas définie, la récupération s’arrête à la première marque avec le nom spécifié.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-StopBeforeMarkAfterDate

Spécifie la date à utiliser avec le paramètre StopBeforeMarkName pour déterminer le point d’arrêt de l’opération de récupération.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-StopBeforeMarkName

Spécifie la transaction marquée avant laquelle arrêter l’opération de récupération. Cela est utilisé avec le paramètre StopBeforeMarkAfterDate pour déterminer le point d’arrêt de l’opération de récupération.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ToPointInTime

Spécifie le point de terminaison pour la restauration des journaux de base de données. Cela s’applique uniquement lorsque le paramètre RestoreAction est défini sur Log.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-UnloadTapeAfter

Indique que le périphérique de bande est rewound et déchargé lorsque l’opération est terminée. S’il n’est pas défini, aucune tentative n’est effectuée pour rembobiner et décharger le support de bande. Cela ne s’applique pas aux sauvegardes de disque.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Wi

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

Smo.Server

Spécifie un SMO. Objet serveur qui décrit l’instance SQL Server sur laquelle l’opération de restauration se produit.

Liens associés

• Backup-SqlDatabase