Backup-SqlDatabase

Référence

Module:: SQLServer

Sauvegarde SQL Server objets de base de données.

Syntax

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-Database] <String>
      [-Path <String[]>]
      [[-BackupFile] <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]
      [-AccessToken <PSObject>]
      [-TrustServerCertificate]
      [-HostNameInCertificate <String>]
      [-Encrypt <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-DatabaseObject] <Database>
      [[-BackupFile] <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]
      [-AccessToken <PSObject>]
      [-TrustServerCertificate]
      [-HostNameInCertificate <String>]
      [-Encrypt <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-Database] <String>
      -ServerInstance <String[]>
      [-Credential <PSCredential>]
      [-ConnectionTimeout <Int32>]
      [[-BackupFile] <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]
      [-AccessToken <PSObject>]
      [-TrustServerCertificate]
      [-HostNameInCertificate <String>]
      [-Encrypt <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [-Database] <String>
      -InputObject <Server[]>
      [[-BackupFile] <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]
      [-AccessToken <PSObject>]
      [-TrustServerCertificate]
      [-HostNameInCertificate <String>]
      [-Encrypt <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Backup-SqlDatabase
      [-BackupContainer <String>]
      [-MirrorDevices <BackupDeviceList[]>]
      [-BackupAction <BackupActionType>]
      [-BackupSetName <String>]
      [-BackupSetDescription <String>]
      [-CompressionOption <BackupCompressionOptions>]
      [-CopyOnly]
      [-ExpirationDate <DateTime>]
      [-FormatMedia]
      [-Incremental]
      [-Initialize]
      [-LogTruncationType <BackupTruncateLogType>]
      [-MediaDescription <String>]
      [-RetainDays <Int32>]
      [-SkipTapeHeader]
      [-UndoFileName <String>]
      [-EncryptionOption <BackupEncryptionOptions>]
      [-StatementTimeout <Int32>]
      [[-BackupFile] <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]
      [-AccessToken <PSObject>]
      [-TrustServerCertificate]
      [-HostNameInCertificate <String>]
      [-Encrypt <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L'applet de commande Backup-SqlDatabase effectue des opérations de sauvegarde sur une base de données SQL Server.

Cela inclut des sauvegardes de base de données complètes, des sauvegardes de journal des transactions et des sauvegardes de fichiers de base de données.

Cette applet de commande est modelée sur la classe Microsoft.SqlServer.Management.Smo.Backup.

Les paramètres de cette classe correspondent généralement aux propriétés de cet objet SMO.

Pour sauvegarder une base de données par serveur instance chemin d’accès et nom de base de données, spécifiez le chemin d’accès instance serveur dans le paramètre Path et le nom de la base de données dans le paramètre Database.

Pour sauvegarder une base de données à l’aide d’un objet Smo.Server et d’un nom de base de données, spécifiez l’objet Smo.Server dans le paramètre InputObject, soit directement, soit à l’aide de l’opérateur de pipeline, et le nom de la base de données dans le paramètre Database.

Pour sauvegarder une base de données par serveur instance et le nom de la base de données, spécifiez le instance serveur dans le paramètre ServerInstance et le nom de la base de données dans le paramètre Database.

Pour sauvegarder une base de données à l’aide d’un objet Smo.Database, spécifiez l’objet Smo.Database dans le paramètre DatabaseObject, directement ou à l’aide de l’opérateur de pipeline.

Par défaut, cette applet de commande effectue une sauvegarde complète de la base de données.

Définissez le type de sauvegarde à l’aide du paramètre BackupAction.

Par défaut, le fichier de sauvegarde est stocké dans l’emplacement de sauvegarde du serveur par défaut sous le nom databasename.bak pour les sauvegardes complètes et/ou de fichiers et sous le nom databasename.trn pour les sauvegardes de journaux. Pour spécifier un autre nom de fichier, utilisez le paramètre BackupFile.

Pour spécifier un emplacement de fichier de sauvegarde et utiliser un nom de fichier généré automatiquement, spécifiez l’emplacement à l’aide du paramètre BackupContainer.

Exemples

Exemple 1 : Sauvegarder une base de données complète

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB"

Cette commande crée une sauvegarde de base de données complète de la base de données nommée « MainDB » à l’emplacement de sauvegarde par défaut du serveur instance « Computer\Instance ». Le fichier de sauvegarde est nommé « MainDB.bak ».

Exemple 2 : Sauvegarder une base de données en fonction de l’emplacement

PS C:\> Set-Location "SQLSERVER:\SQL\Computer\Instance" 
PS SQLSERVER:\SQL\Computer\Instance> Backup-SqlDatabase -Database "MainDB"

Cette commande crée une sauvegarde complète de la base de données « MainDB » à l’emplacement de sauvegarde par défaut du serveur instance « Computer\Instance ». Le répertoire de travail actuel est utilisé pour déterminer le serveur instance où la sauvegarde a lieu.

Exemple 3 : Sauvegarder le journal des transactions

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupAction Log

Cette commande crée une sauvegarde du journal des transactions de la base de données « MainDB » à l’emplacement de sauvegarde par défaut du serveur instance « Computer\Instance ». Le fichier de sauvegarde est nommé « MainDB.trn ».

Exemple 4 : Sauvegarder une base de données et demander des informations d’identification

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -Credential (Get-Credential "sa")

Cette commande crée une sauvegarde de base de données complète de la base de données « MainDB » à l’aide de la connexion « sa » SQL Server. Cette commande invite un mot de passe pour terminer l’authentification.

Exemple 5 : Sauvegarder une base de données sur un partage de fichiers réseau

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

Cette commande crée une sauvegarde complète de la base de données « MainDB » dans le fichier « \\mainserver\databasebackup\MainDB.bak ».

Exemple 6 : Sauvegarder toutes les bases de données d’un serveur instance

PS C:\> Get-ChildItem "SQLSERVER:\SQL\Computer\Instance\Databases" | Backup-SqlDatabase

Cette commande sauvegarde toutes les bases de données sur l'instance de serveur 'Computer\Instance' à l'emplacement de sauvegarde par défaut. Les fichiers de sauvegarde sont nommés <nom> de la base de données.bak.

Exemple 7 : Sauvegarder toutes les bases de données d’un serveur instance dans un partage de fichiers réseau

PS C:\> Set-Location "SQLSERVER:\SQL\Computer\Instance\Databases"
PS SQLSERVER:\SQL\Computer\Instance\Databases> foreach ($database in (Get-ChildItem)) {
     $dbName = $database.Name
     Backup-SqlDatabase -Database $dbName -BackupFile "\\mainserver\databasebackup\$dbName.bak" }

Cette commande crée une sauvegarde complète pour chaque base de données sur le serveur instance 'Computer\Instance' sur le partage « \\mainserver\databasebackup ». Les fichiers de sauvegarde sont nommés <nom> de la base de données.bak.

Exemple 8 : Sauvegarder tous les fichiers dans des groupes de fichiers secondaires

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupAction Files -DatabaseFileGroup "FileGroupJan","FileGroupFeb"

Cette commande crée une sauvegarde de fichier complète de chaque fichier dans les groupes de fichiers secondaires « FileGroupJan » et « FileGroupFeb ».

Exemple 9 : Créer une sauvegarde différentielle

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -Incremental

Cette commande crée une sauvegarde différentielle de la base de données « MainDB » à l’emplacement de sauvegarde par défaut du serveur instance « Ordinateur\Instance ». Le fichier de sauvegarde est nommé « MainDB.bak ».

Exemple 10 : Créer une sauvegarde sur un lecteur de bande

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

Cette commande crée une sauvegarde complète de la base de données MainDB sur le périphérique à bande « \\.\tape0 ». Pour représenter cet appareil, la commande construit un instance de l’objet 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 passé au paramètre BackupDevice de l’applet de commande Backup-SqlDatabase .

Exemple 11 : Sauvegarder une base de données sur le service Stockage Blob Azure

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupContainer "https://storageaccountname.blob.core.windows.net/containername" -SqlCredential "SQLCredentialName"

Cette commande crée une sauvegarde complète de la base de données « MainDB » dans le service Windows Stockage Blob Azure. Elle utilise BackupContainer pour spécifier l’emplacement (URL) du conteneur d’objets blob Windows Azure. Le nom du fichier de sauvegarde est généré automatiquement. Le paramètre SqlCredential permet de spécifier le nom des informations d'identification de SQL Server qui stockent les informations d'authentification.

Exemple 12 : Sauvegarder une base de données sur le service Stockage Blob Azure et spécifier le nom de fichier

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainyDB" -BackupFile "https://storageaccountname.blob.core.windows.net/containername/MainDB.bak" -SqlCredential "SQLCredentialName"

Cette commande crée une sauvegarde complète de la base de données MainDB dans le service Windows Stockage Blob Azure. Elle utilise le paramètre BackupFile pour spécifier l'emplacement (URL) et le nom du fichier de sauvegarde. Le paramètre SqlCredential permet de spécifier le nom des informations d'identification de SQL Server.

Exemple 13 : Sauvegarder toutes les bases de données sur le service Stockage Blob Azure

PS C:\> Get-ChildItem "SQLSERVER:\SQL\Computer\Instance\Databases" | Backup-SqlDatabase -BackupContainer "https://storageaccountname.blob.core.windows.net/containername" -SqlCredential "SQLCredentialName"

Cette commande sauvegarde toutes les bases de données sur le serveur instance ' Computer\Instance' dans l’emplacement du service Windows Stockage Blob Azure à l’aide du paramètre BackupContainer. Les noms des fichiers de sauvegarde sont générés automatiquement.

Exemple 14 : Créer une sauvegarde chiffrée

PS C:\> $EncryptionOption = New-SqlBackupEncryptionOption -Algorithm Aes256 -EncryptorType ServerCertificate -EncryptorName "BackupCert"
PS C:\> Backup-SqlDatabase -ServerInstance "." -Database "MainDB" -BackupFile "MainDB.bak" -CompressionOption On -EncryptionOption $EncryptionOption

Cet exemple crée les options de chiffrement et les utilise comme valeur de paramètre dans Backup-SqlDatabase pour créer une sauvegarde chiffrée.

Paramètres

-AccessToken

Le jeton d’accès utilisé pour s’authentifier auprès de SQL Server, en guise d’alternative à l’authentification utilisateur/mot de passe ou à l’authentification Windows.

Cela peut être utilisé, par exemple, pour se connecter à et à SQL Azure DB l’aide d’un Service Principal ou d’un Managed Identity.SQL Azure Managed Instance

Le paramètre à utiliser peut être une chaîne représentant le jeton ou un PSAccessToken objet retourné en exécutant Get-AzAccessToken -ResourceUrl https://database.windows.net.

Ce paramètre est nouveau dans v22 du module.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupAction

Spécifie le type d’opération de sauvegarde à effectuer. Les valeurs autorisées sont :

Base de données. Sauvegarde tous les fichiers de données de la base de données.
Fichiers. Sauvegarde les fichiers de données spécifiés dans les paramètres DatabaseFile ou DatabaseFileGroup.
Rapport. Sauvegarde le journal des transactions.

Type:	BackupActionType
Accepted values:	Database, Files, Log
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupContainer

Spécifie le dossier ou l’emplacement où l’applet de commande stocke les sauvegardes. Il peut s’agir d’un dossier sur un disque ou une URL pour un conteneur d’objets blob Azure. Ce paramètre peut être utile lors de la sauvegarde de plusieurs bases de données dans une instance donnée. Ce paramètre ne peut pas être utilisé avec un paramètre BackupDevice. Le paramètre BackupContainer ne peut pas être utilisé avec le paramètre BackupFile.

Le chemin utilisé pour spécifier l’emplacement doit se terminer par une barre oblique (/).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupDevice

Spécifie les appareils sur lesquels les sauvegardes sont stockées. Ce paramètre ne peut pas être utilisé avec le paramètre BackupFile. Utilisez ce paramètre si vous effectuez une sauvegarde sur bande.

Type:	BackupDeviceItem[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupFile

Spécifie l’emplacement et le nom de fichier de la sauvegarde. Il s'agit d'un paramètre facultatif. Si elles ne sont pas spécifiées, les sauvegardes sont stockées à l’emplacement de sauvegarde par défaut du serveur sous le nom databasename.bak pour les sauvegardes complètes et de fichiers, ou databasename.trn pour les sauvegardes de journaux. Ce paramètre ne peut pas être utilisé avec les paramètres BackupDevice ou BackupContainer.

Type:	String[]
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupSetDescription

Spécifie la description du jeu de sauvegarde. Ce paramètre est facultatif.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupSetName

Spécifie le nom du jeu de sauvegarde.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BlockSize

Spécifie la taille de bloc physique de la sauvegarde, en octets. 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 périphériques à bande et 512 pour tous les autres appareils.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BufferCount

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Checksum

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CompressionOption

Spécifie les options de compression pour l’opération de sauvegarde.

Type:	BackupCompressionOptions
Accepted values:	Default, On, Off
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionTimeout

Spécifie le nombre de secondes d’attente d’une connexion serveur avant l’échec d’un délai d’attente. La valeur du délai d'attente doit être un entier compris entre 0 et 65534. Si 0 est spécifié, les tentatives de connexion n’expirent pas.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContinueAfterError

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CopyOnly

Indique que la sauvegarde est une sauvegarde de copie uniquement. Une sauvegarde en copie seule n’affecte pas la séquence normale de vos sauvegardes conventionnelles planifiées régulièrement.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Spécifie un objet PSCredential qui contient les informations d’identification d’une connexion SQL Server autorisée à effectuer cette opération. Il ne s’agit pas de l’objet d’informations d’identification SQL utilisé pour stocker les informations d’authentification en interne par SQL Server lors de l’accès à des ressources en dehors de SQL Server.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseFile

Spécifie un ou plusieurs fichiers de base de données à sauvegarder. Ce paramètre est utilisé uniquement lorsque BackupAction est défini sur Fichiers. Lorsque BackupAction est défini sur Files, le paramètre DatabaseFileGroups ou DatabaseFiles doit être spécifié.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseFileGroup

Spécifie les groupes de fichiers de base de données ciblés par l’opération de sauvegarde. Ce paramètre est utilisé uniquement lorsque la propriété BackupAction est définie sur Fichiers. Lorsque le paramètre BackupAction est défini sur Files, le paramètre DatabaseFileGroups ou DatabaseFiles doit être spécifié.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseObject

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

Type:	Database
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Encrypt

Type de chiffrement à utiliser lors de la connexion à SQL Server.

Cette valeur est mappée à la Encrypt propriété SqlConnectionEncryptOption sur l’objet SqlConnection du pilote Microsoft.Data.SqlClient.

Dans la version 22 du module, la valeur par défaut est Optional (pour la compatibilité avec v21). Dans la version 23+ du module, la valeur par défaut est « Obligatoire », ce qui peut créer une modification cassant pour les scripts existants.

Ce paramètre est nouveau dans la version 22 du module.

Type:	String
Accepted values:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionOption

Spécifie les options de chiffrement pour l’opération de sauvegarde.

Type:	BackupEncryptionOptions
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExpirationDate

Spécifie la date et l’heure à laquelle le jeu de sauvegarde expire et que les données de sauvegarde ne sont plus considérées comme valides. Cela ne peut être utilisé que pour les données de sauvegarde stockées sur des disques ou des périphériques à bande. Les jeux de sauvegarde antérieurs à la date d’expiration peuvent être remplacés par une sauvegarde ultérieure.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FormatMedia

Indique que la bande est mise en forme comme première étape de l’opération de sauvegarde. Cela ne s’applique pas à une sauvegarde de disque.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostNameInCertificate

Nom d’hôte à utiliser pour valider le certificat SQL Server TLS/SSL. Vous devez passer ce paramètre si votre SQL Server instance est activé pour Forcer le chiffrement et que vous souhaitez vous connecter à un instance à l’aide de nom d’hôte/nom_court. Si ce paramètre est omis, le passage du nom de domaine complet (FQDN) à -ServerInstance est nécessaire pour se connecter à un SQL Server instance activé pour forcer le chiffrement.

Ce paramètre est nouveau dans la version 22 du module.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Incremental

Indique qu’une sauvegarde différentielle est effectuée.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Initialize

Indique que les appareils associés à l’opération de sauvegarde sont initialisés. Cela remplace tous les jeux de sauvegarde existants sur le support et fait de cette sauvegarde le premier jeu de sauvegarde sur le support.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Spécifie l’objet serveur pour l’emplacement de sauvegarde.

Type:	Server[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-LogTruncationType

Spécifie le comportement de troncation pour les sauvegardes de journaux. Les valeurs autorisées sont :

-- TruncateOnly -- NoTruncate -- Tronquer

La valeur par défaut est Truncate.

Type:	BackupTruncateLogType
Accepted values:	TruncateOnly, NoTruncate, Truncate
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxTransferSize

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MediaDescription

Spécifie la description du support qui contient le jeu de sauvegarde. Ce paramètre est facultatif.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MediaName

Spécifie le nom utilisé pour identifier le support.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MirrorDevices

Spécifie un tableau d'objets BackupDeviceList utilisés par la sauvegarde en miroir.

Type:	BackupDeviceList[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRecovery

Indique que la fin du journal n’est pas sauvegardée. Une fois restaurée, la base de données est dans l'état de restauration. Lorsque la valeur n'est pas définie, la fin du journal est sauvegardée. Cela s’applique uniquement lorsque le paramètre BackupAction est défini sur Log.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRewind

Indique qu’un lecteur de bande est laissé ouvert à la position de fin lorsque la sauvegarde est terminée. Lorsque la valeur n'est pas définie, la bande est rembobinée une fois l'opération terminée. Cela ne s’applique pas aux sauvegardes de disque ou d’URL.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Indique que l’applet de commande génère l’objet Smo.Backup qui a effectué la sauvegarde.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

Spécifie le chemin d’accès au instance de SQL Server pour exécuter l’opération de sauvegarde. Il s'agit d'un paramètre facultatif. Si elle n'est pas spécifiée, la valeur de ce paramètre est définie par défaut à l'emplacement de travail actuel.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Restart

Indique que l’applet de commande continue de traiter une opération de sauvegarde partiellement terminée. Si elle n’est pas définie, l’applet de commande redémarre une opération de sauvegarde interrompue au début du jeu de sauvegarde.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RetainDays

Spécifie le nombre de jours qui doivent s’écouler avant qu’un jeu de sauvegarde puisse être remplacé. Cela ne peut être utilisé que pour les données de sauvegarde stockées sur des disques ou des périphériques à bande.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Script

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerInstance

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

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SkipTapeHeader

Indique que l’en-tête de bande n’est pas lu.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SqlCredential

Spécifie un objet d’informations d’identification SQL Server qui stocke les informations d’authentification. Si vous effectuez une sauvegarde dans le service de stockage 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.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StatementTimeout

Définissez le délai d’expiration (en secondes) pour l’opération de sauvegarde.

Si la valeur est 0 ou si le paramètre StatementTimeout n’est pas spécifié, l’opération de restauration ne va pas expirer.

Type:	Int32
Position:	Named
Default value:	0
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustServerCertificate

Indique si le canal sera chiffré tout en contournant la chaîne de certificats pour valider l’approbation.

Dans la version 22 du module, la valeur par défaut est $true (pour la compatibilité avec v21). Dans v23+ du module, la valeur par défaut est « $false », ce qui peut créer une modification cassant pour les scripts existants.

Ce paramètre est nouveau dans la version 22 du module.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UndoFileName

Spécifie le nom du fichier d’annulation utilisé pour stocker les transactions non validées qui sont restaurées pendant la récupération.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UnloadTapeAfter

Indique que le périphérique à bande est rewound et déchargé à la fin de l’opération. Si la valeur n'est pas définie, aucune tentative n'est faite pour rembobiner et décharger le support de bande. Cela ne s’applique pas aux sauvegardes de disque ou d’URL.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée. Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

SMO.Server

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

Spécifie un SMO. Objet serveur faisant référence à la instance de SQL Server sur laquelle l’opération de sauvegarde se produit.

System.String[]

Sorties

System.Object

Restore-SqlDatabase

Backup-SqlDatabase

Syntax

Description

Exemples

Exemple 1 : Sauvegarder une base de données complète

Exemple 2 : Sauvegarder une base de données en fonction de l’emplacement

Exemple 3 : Sauvegarder le journal des transactions

Exemple 4 : Sauvegarder une base de données et demander des informations d’identification

Exemple 5 : Sauvegarder une base de données sur un partage de fichiers réseau

Exemple 6 : Sauvegarder toutes les bases de données d’un serveur instance

Exemple 7 : Sauvegarder toutes les bases de données d’un serveur instance dans un partage de fichiers réseau

Exemple 8 : Sauvegarder tous les fichiers dans des groupes de fichiers secondaires

Exemple 9 : Créer une sauvegarde différentielle

Exemple 10 : Créer une sauvegarde sur un lecteur de bande

Exemple 11 : Sauvegarder une base de données sur le service Stockage Blob Azure

Exemple 12 : Sauvegarder une base de données sur le service Stockage Blob Azure et spécifier le nom de fichier

Exemple 13 : Sauvegarder toutes les bases de données sur le service Stockage Blob Azure

Exemple 14 : Créer une sauvegarde chiffrée

Paramètres

-AccessToken

-BackupAction

-BackupContainer

-BackupDevice

-BackupFile

-BackupSetDescription

-BackupSetName

-BlockSize

-BufferCount

-Checksum

-CompressionOption

-Confirm

-ConnectionTimeout

-ContinueAfterError

-CopyOnly

-Credential

-Database

-DatabaseFile

-DatabaseFileGroup

-DatabaseObject

-Encrypt

-EncryptionOption

-ExpirationDate

-FormatMedia

-HostNameInCertificate

-Incremental

-Initialize

-InputObject

-LogTruncationType

-MaxTransferSize

-MediaDescription

-MediaName

-MirrorDevices

-NoRecovery

-NoRewind

-PassThru

-Path

-Restart

-RetainDays

-Script

-ServerInstance

-SkipTapeHeader

-SqlCredential

-StatementTimeout

-TrustServerCertificate

-UndoFileName

-UnloadTapeAfter

-WhatIf

Entrées

Sorties

Liens associés

Ressources supplémentaires