Backup-SqlDatabase
Sauvegarde des objets de base de données SQL Server.
Syntaxe
ByPath (Par défaut)
Backup-SqlDatabase
[-Database] <String>
[[-BackupFile] <String[]>]
[-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>]
[-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]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByDBObject
Backup-SqlDatabase
[-DatabaseObject] <Database>
[[-BackupFile] <String[]>]
[-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>]
[-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>]
ByName
Backup-SqlDatabase
[-Database] <String>
[[-BackupFile] <String[]>]
-ServerInstance <String[]>
[-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>]
[-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]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Backup-SqlDatabase
[-Database] <String>
[[-BackupFile] <String[]>]
-InputObject <Server[]>
[-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>]
[-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>]
ByBackupContainer
Backup-SqlDatabase
[[-BackupFile] <String[]>]
[-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>]
[-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 les sauvegardes complètes des bases de données, les sauvegardes de journal des transactions et les sauvegardes de fichiers de base de données.
Cette applet de commande est modélisée après 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 chemin d’accès d’instance de serveur et nom de base de données, spécifiez le chemin d’accès de l’instance de serveur dans le paramètre Path et le nom de la base de données dans le paramètre de base de données.
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, directement ou à l’aide de l’opérateur de pipeline et du nom de la base de données dans le paramètre de base de données.
Pour sauvegarder une base de données par instance de serveur et par nom de base de données, spécifiez l’instance de serveur dans le paramètre ServerInstance et le nom de la base de données dans le paramètre de base de données.
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 journal. 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 complète de la base de données nommée « MainDB » à l’emplacement de sauvegarde par défaut de l’instance de serveur « 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 » vers l’emplacement de sauvegarde par défaut de l’instance de serveur « Computer\Instance ». Le répertoire de travail actuel est utilisé pour déterminer l’instance de serveur où se produit la sauvegarde.
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 » vers l’emplacement de sauvegarde par défaut de l’instance de serveur « 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 complète de la base de données « MainDB » à l’aide de la connexion SQL Server « sa ». Cette commande invite un mot de passe à terminer l’authentification.
Exemple 5 : Sauvegarder une base de données dans 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 dans une instance de serveur
PS C:\> Get-ChildItem "SQLSERVER:\SQL\Computer\Instance\Databases" | Backup-SqlDatabase
Cette commande sauvegarde toutes les bases de données de l’instance de serveur « Computer\Instance » à l’emplacement de sauvegarde par défaut. Les fichiers de sauvegarde sont nommés <nom> de base de données.bak.
Exemple 7 : Sauvegarder toutes les bases de données d’une instance de serveur vers 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 l’instance de serveur « Computer\Instance » sur le partage « \\mainserver\databasebackup ». Les fichiers de sauvegarde sont nommés <nom> de 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 complète des fichiers 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 de l’instance de serveur « Computer\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 de bande « \\.\tape0 ». Pour représenter cet appareil, la commande construit une 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 transmis au paramètre BackupDevice de l’applet de commande Backup-SqlDatabase .
Exemple 11 : Sauvegarder une base de données dans 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 Stockage Blob Windows Azure. Il 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 est utilisé pour spécifier le nom des informations d’identification SQL Server qui stocke les informations d’authentification.
Exemple 12 : Sauvegarder une base de données dans 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 sur le service Stockage Blob Windows Azure. Il utilise le paramètre BackupFile pour spécifier l’emplacement (URL) et le nom du fichier de sauvegarde. Le paramètre SqlCredential est utilisé pour spécifier le nom des informations d’identification SQL Server.
Exemple 13 : Sauvegarder toutes les bases de données dans 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 de l’instance de serveur « Computer\Instance » à l’emplacement du service Stockage Blob Windows Azure à l’aide du paramètre BackupContainer. Les noms de 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 l’utilise comme valeur de paramètre dans Backup-SqlDatabase pour créer une sauvegarde chiffrée.
Paramètres
-AccessToken
Jeton d’accès utilisé pour s’authentifier auprès de SQL Server, comme alternative à l’authentification utilisateur/mot de passe ou Windows.
Cela peut être utilisé, par exemple, pour se connecter à SQL Azure DBSQL Azure Managed Instance un Service Principal ou un Managed Identity.
Le paramètre à utiliser peut être une chaîne représentant le jeton ou un PSAccessToken objet tel qu’il est retourné en exécutant Get-AzAccessToken -ResourceUrl https://database.windows.net.
Ce paramètre est nouveau dans v22 du module.
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 |
-BackupAction
Spécifie le type d’opération de sauvegarde à effectuer. Les valeurs valides sont les suivantes :
- 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.
Propriétés du paramètre
| Type: | BackupActionType |
| Valeur par défaut: | None |
| Valeurs acceptées: | Database, Files, Log |
| 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 |
-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 (/).
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 |
-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 sauvegardez sur 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 et le ou les noms de fichiers 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.
Lors de la sauvegarde sur plusieurs fichiers, séparez les noms de fichiers par des virgules, par exemple : -BackupFile C:\Backups\databasename2.bak,C:\Backups\databasename2.bak
Ce paramètre ne peut pas être utilisé avec le ou -BackupDevice les -BackupContainer paramètres.
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: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-BackupSetDescription
Spécifie la description du jeu de sauvegarde. Ce paramètre est facultatif.
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 |
-BackupSetName
Spécifie le nom du jeu de sauvegarde.
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 |
-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 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 de mémoires 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 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 |
-CompressionOption
Spécifie les options de compression de l’opération de sauvegarde.
Propriétés du paramètre
| Type: | BackupCompressionOptions |
| Valeur par défaut: | None |
| Valeurs acceptées: | Default, On, Off |
| 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. 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 |
-CopyOnly
Indique que la sauvegarde est une sauvegarde en copie seule. Une sauvegarde en copie seule n’affecte pas la séquence normale de vos sauvegardes conventionnelles planifiées régulièrement.
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. 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 aux ressources en dehors de SQL Server.
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 à 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.
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: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
ByName
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
ByObject
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 Files. Lorsque BackupAction est défini sur Files, le paramètre DatabaseFileGroups ou DatabaseFiles 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: | 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 sauvegarde. Ce paramètre est utilisé uniquement lorsque la propriété BackupAction est définie sur Files. Lorsque le paramètre BackupAction est défini sur Files, le paramètre DatabaseFileGroups ou DatabaseFiles 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: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DatabaseObject
Spécifie l’objet de base de données pour l’opération de sauvegarde.
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: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 v22 du module.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Valeurs acceptées: | Mandatory, Optional, Strict |
| 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 |
-EncryptionOption
Spécifie les options de chiffrement pour l’opération de sauvegarde.
Propriétés du paramètre
| Type: | BackupEncryptionOptions |
| 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 |
-ExpirationDate
Spécifie la date et l’heure à laquelle le jeu de sauvegarde expire et 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 périphériques de disque ou de bande. Les jeux de sauvegarde antérieurs à la date d’expiration sont disponibles pour être remplacés par une sauvegarde ultérieure.
Propriétés du paramètre
| Type: | DateTime |
| 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 |
-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.
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 |
-HostNameInCertificate
Nom d’hôte à utiliser pour valider le certificat SQL Server TLS/SSL. Vous devez passer ce paramètre si votre instance SQL Server est activée pour Forcer le chiffrement et que vous souhaitez vous connecter à une instance à l’aide du nom d’hôte/shortname. Si ce paramètre est omis, le passage du nom de domaine complet (FQDN) à -ServerInstance est nécessaire pour se connecter à une instance SQL Server activée pour Forcer le chiffrement.
Ce paramètre est nouveau dans v22 du module.
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 |
-Incremental
Indique qu’une sauvegarde différentielle est effectuée.
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 |
-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.
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 |
-InputObject
Spécifie l’objet serveur pour l’emplacement de sauvegarde.
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 |
-LogTruncationType
Spécifie le comportement de troncation pour les sauvegardes de journaux. Les valeurs valides sont les suivantes :
-- TruncateOnly -- NoTruncate -- Tronquer
La valeur par défaut est Tronquer.
Propriétés du paramètre
| Type: | BackupTruncateLogType |
| Valeur par défaut: | None |
| Valeurs acceptées: | TruncateOnly, NoTruncate, Truncate |
| 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 de 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 |
-MediaDescription
Spécifie la description du support qui contient le jeu de sauvegarde. Ce paramètre est facultatif.
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 |
-MediaName
Spécifie le nom utilisé pour identifier le 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 |
-MirrorDevices
Spécifie un tableau d’objets BackupDeviceList utilisés par la sauvegarde mise en miroir.
Propriétés du paramètre
| Type: | BackupDeviceList[] |
| 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 fin du journal n’est pas sauvegardée. Lors de la restauration, la base de données est dans l’état de restauration. Lorsqu’il n’est pas défini, la fin du journal est sauvegardée. Cela s’applique uniquement lorsque le paramètre BackupAction est défini sur Log.
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 sauvegarde est terminée. Lorsqu’elle n’est pas définie, la bande est rewound une fois l’opération terminée. Cela ne s’applique pas aux sauvegardes de disque ou d’URL.
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 l’applet de commande génère l’objet Smo.Backup qui a effectué la 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 |
-Path
Spécifie le chemin d’accès à l’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.
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 |
-Restart
Indique que l’applet de commande continue de traiter une opération de sauvegarde partiellement terminée. S’il n’est pas défini, l’applet de commande redémarre une opération de sauvegarde 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 |
-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 périphériques de disque ou de bande.
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 |
-Script
Indique que cette applet de commande génère un script Transact-SQL qui effectue l’opération 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 |
-ServerInstance
Spécifie le nom d’une instance SQL Server. Cette instance de serveur devient la cible de l’opération de sauvegarde.
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 |
-SkipTapeHeader
Indique que l’en-tête de bande n’est pas lu.
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 |
-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 |
-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 n’est pas en cours d’expiration.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | 0 |
| 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 |
-TrustServerCertificate
Indique si le canal sera chiffré lors du contournement de la marche à pied de 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 v22 du module.
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 |
-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.
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 l’appareil de bande est rewound et déchargé lorsque l’opération se termine. 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 ou d’URL.
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 n’est pas exécutée. 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
Microsoft.SqlServer.Management.Smo.Database
Microsoft.SqlServer.Management.Smo.Server
Spécifie un SMO. Objet serveur faisant référence à l’instance de SQL Server sur laquelle l’opération de sauvegarde se produit.