Backup-SqlDatabase
Резервное копирование SQL Server объектов базы данных.
Синтаксис
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>]
Описание
Командлет Backup-SqlDatabase выполняет операции резервного копирования в базе данных SQL Server.
К ним относятся операции полного резервного копирования базы данных, резервного копирования журнала транзакций и резервного копирования файлов базы данных.
Этот командлет создан в соответствии с классом Microsoft.SqlServer.Management.Smo.Backup.
Параметры в этом классе в основном соответствуют свойствам в этом объекте Smo.
Чтобы создать резервную копию базы данных по пути экземпляра сервера и имени базы данных, укажите путь к экземпляру сервера в параметре Path и имя базы данных в параметре Database.
Чтобы создать резервную копию базы данных с помощью объекта Smo.Server и имени базы данных, укажите объект Smo.Server в параметре InputObject напрямую или с помощью оператора конвейера, а имя базы данных — в параметре Database.
Чтобы создать резервную копию базы данных по экземпляру сервера и имени базы данных, укажите экземпляр сервера в параметре ServerInstance и имя базы данных в параметре Database.
Чтобы создать резервную копию базы данных с помощью объекта Smo.Database, укажите объект Smo.Database в параметре DatabaseObject напрямую или с помощью оператора конвейера.
По умолчанию этот командлет выполняет полное резервное копирование базы данных.
Задайте тип резервной копии с помощью параметра BackupAction.
По умолчанию файл резервной копии хранится в расположении резервного копирования сервера по умолчанию под именем databasename.bak для полных и (или) резервных копий файлов и под именем databasename.trn для резервных копий журналов. Чтобы указать другое имя файла, используйте параметр BackupFile.
Чтобы указать расположение файла резервной копии и использовать автоматически созданное имя файла, укажите расположение с помощью параметра BackupContainer.
Примеры
Пример 1. Резервное копирование полной базы данных
PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB"
Эта команда создает полную резервную копию базы данных с именем MainDB в расположении резервной копии по умолчанию экземпляра сервера "Компьютер\Экземпляр". Файл резервной копии называется "MainDB.bak".
Пример 2. Резервное копирование базы данных на основе расположения
PS C:\> Set-Location "SQLSERVER:\SQL\Computer\Instance"
PS SQLSERVER:\SQL\Computer\Instance> Backup-SqlDatabase -Database "MainDB"
Эта команда создает полную резервную копию базы данных MainDB в расположении резервной копии по умолчанию экземпляра сервера "Компьютер\Экземпляр". Текущий рабочий каталог используется для определения экземпляра сервера, на котором выполняется резервное копирование.
Пример 3. Резервное копирование журнала транзакций
PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupAction Log
Эта команда создает резервную копию журнала транзакций базы данных MainDB в расположении резервной копии по умолчанию экземпляра сервера "Компьютер\Экземпляр". Файл резервной копии называется MainDB.trn.
Пример 4. Резервное копирование базы данных и запрос учетных данных
PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -Credential (Get-Credential "sa")
Эта команда создает полную резервную копию базы данных MainDB с использованием имени входа SQL Server sa. Эта команда запрашивает пароль для завершения проверки подлинности.
Пример 5. Резервное копирование базы данных в сетевую общую папку
PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.bak"
Эта команда создает полную резервную копию базы данных MainDB в файле \\mainserver\databasebackup\MainDB.bak.
Пример 6. Резервное копирование всех баз данных в экземпляре сервера
PS C:\> Get-ChildItem "SQLSERVER:\SQL\Computer\Instance\Databases" | Backup-SqlDatabase
Эта команда создает резервную копию всех баз данных на экземпляре сервера «Computer\Instance» в заданном по умолчанию местоположении резервного копирования. Файлы резервных копий называются <именем> базы данных.bak.
Пример 7. Резервное копирование всех баз данных в экземпляре сервера в сетевую общую папку
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" }
Эта команда создает полную резервную копию для каждой базы данных на экземпляре сервера Computer\Instance в общей папке \\mainserver\databasebackup. Файлы резервных копий называются <именем> базы данных.bak.
Пример 8. Резервное копирование всех файлов во вторичных файловых группах
PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupAction Files -DatabaseFileGroup "FileGroupJan","FileGroupFeb"
Эта команда создает полную резервную копию каждого файла в дополнительных файловых группах FileGroupJan и FileGroupFeb.
Пример 9. Создание разностной резервной копии
PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -Incremental
Эта команда создает разностную резервную копию базы данных MainDB в расположении резервной копии по умолчанию экземпляра сервера "Компьютер\Экземпляр". Файл резервной копии называется "MainDB.bak".
Пример 10. Создание резервной копии на ленточный накопитель
PS C:\> $TapeDevice = New-Object Microsoft.Sqlserver.Management.Smo.BackupDeviceItem("\\.\tape0", "Tape")
PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupDevice $TapeDevice
Эта команда создает полную резервную копию базы данных MainDB на ленточное устройство "\.\tape0". Чтобы представить это устройство, команда создает экземпляр объекта Microsoft.Sqlserver.Management.Smo.BackupDeviceItem. Конструктор принимает два аргумента: имя устройства резервного копирования и тип устройства резервного копирования. Этот объект BackupDeviceItem передается в параметр BackupDevice командлета Backup-SqlDatabase .
Пример 11. Резервное копирование базы данных в службу Хранилище BLOB-объектов Azure
PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupContainer "https://storageaccountname.blob.core.windows.net/containername" -SqlCredential "SQLCredentialName"
Эта команда создает полную резервную копию базы данных MainDB в службе Windows Хранилище BLOB-объектов Azure. Он использует BackupContainer для указания расположения (URL-адреса) контейнера BLOB-объектов Windows Azure. Имя файла резервной копии создается автоматически. Параметр SqlCredential используется для указания имени объекта учетных данных SQL Server, в котором хранятся данные для проверки подлинности.
Пример 12. Резервное копирование базы данных в службу Хранилище BLOB-объектов Azure и указание имени файла
PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainyDB" -BackupFile "https://storageaccountname.blob.core.windows.net/containername/MainDB.bak" -SqlCredential "SQLCredentialName"
Эта команда создает полную резервную копию базы данных MainDB в службе Windows Хранилище BLOB-объектов Azure. Параметр BackupFile используется для указания расположения (URL-адреса) и имени файла резервной копии. Параметр SqlCredential используется для указания имени объекта учетных данных SQL Server.
Пример 13. Резервное копирование всех баз данных в службу Хранилище BLOB-объектов Azure
PS C:\> Get-ChildItem "SQLSERVER:\SQL\Computer\Instance\Databases" | Backup-SqlDatabase -BackupContainer "https://storageaccountname.blob.core.windows.net/containername" -SqlCredential "SQLCredentialName"
Эта команда создает резервную копию всех баз данных на экземпляре сервера "Компьютер\Экземпляр" в расположение службы Windows Хранилище BLOB-объектов Azure с помощью параметра BackupContainer. Имена файлов резервной копии формируются автоматически.
Пример 14. Создание зашифрованной резервной копии
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
В этом примере создаются параметры шифрования и они используются в качестве значения параметра в Backup-SqlDatabase для создания зашифрованной резервной копии.
Параметры
-AccessToken
Маркер доступа, используемый для проверки подлинности для SQL Server, в качестве альтернативы проверке подлинности пользователя или пароля или проверки подлинности Windows.
Его можно использовать, например, для подключения к SQL Azure DB
и SQL Azure Managed Instance
с помощью Service Principal
или Managed Identity
.
Используемый параметр может быть либо строкой, представляющей маркер, либо объектом, PSAccessToken
возвращаемым при выполнении команды Get-AzAccessToken -ResourceUrl https://database.windows.net
.
Этот параметр является новым в версии 22 модуля.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackupAction
Указывает тип выполняемой операции резервного копирования. Допустимые значения:
- база данных; создает резервную копию всех файлов данных в базе данных.
- Файлы Резервное копирование файлов данных, указанных в параметрах DatabaseFile или DatabaseFileGroup.
- Журнала. Создает резервную копию журнала транзакций.
Type: | BackupActionType |
Accepted values: | Database, Files, Log |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackupContainer
Указывает папку или расположение, в котором командлет хранит резервные копии. Это может быть папка на диске или URL-адрес контейнера BLOB-объектов Azure. Этот параметр может применяться при резервном копировании нескольких баз данных в указанном экземпляре. Этот параметр нельзя указывать с параметром BackupDevice. Параметр BackupContainer нельзя использовать с параметром BackupFile.
Путь, используемый для указания расположения, должен заканчиваться символом косой черты (/).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackupDevice
Указывает устройства, на которых хранятся резервные копии. Этот параметр нельзя использовать с параметром BackupFile. Используйте этот параметр при резервном копировании на ленточный носитель.
Type: | BackupDeviceItem[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackupFile
Указывает расположение и имя файла резервной копии. Этот параметр является необязательным. Если не указано, резервные копии хранятся в расположении резервного копирования сервера по умолчанию под именем databasename.bak для полных резервных копий и резервных копий файлов или databasename.trn для резервных копий журналов. Этот параметр нельзя использовать с параметрами BackupDevice или BackupContainer.
Type: | String[] |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackupSetDescription
Указывает описание резервного набора данных. Этот параметр является необязательным.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackupSetName
Указывает имя резервного набора данных.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BlockSize
Задает физический размер блока для резервной копии в байтах. Поддерживаются размеры 512, 1024, 2048, 4096, 8192, 16 384, 32 768 и 65 536 байт (64 КБ). Значение по умолчанию — 65536 для ленточных устройств и 512 для всех остальных устройств.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BufferCount
Указывает количество буферов ввода-вывода, используемых для операции резервного копирования. Можно задать любое положительное целое число. Если в процессе Sqlservr.exe буферов недостаточно виртуального адресного пространства, вы получите ошибку нехватки памяти.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Checksum
Указывает, что во время операции резервного копирования вычисляется значение контрольной суммы.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CompressionOption
Задает параметры сжатия для операции резервного копирования.
Type: | BackupCompressionOptions |
Accepted values: | Default, On, Off |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Запрашивает подтверждение перед выполнением командлета. Запрашивает подтверждение перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionTimeout
Указывает время ожидания подключения к серверу в секундах до сбоя времени ожидания. Значение времени ожидания должно быть целым числом от 0 до 65 534. Если задано значение 0, время ожидания для попыток подключения не истекает.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueAfterError
Указывает, что операция продолжается при возникновении ошибки контрольной суммы. Если не задано, выполнение операции завершится ошибкой после возникновения ошибки контрольной суммы.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CopyOnly
Указывает, что резервная копия является резервной копией только для копирования. Резервная копия только для копирования не влияет на обычную последовательность регулярно запланированных обычных резервных копий.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Указывает объект PSCredential, содержащий учетные данные для имени входа SQL Server с разрешением на выполнение этой операции. Это не объект учетных данных SQL, который используется для внутреннего хранения сведений о проверке подлинности путем SQL Server при доступе к ресурсам за пределами SQL Server.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Database
Указывает имя базы данных для резервного копирования. Этот параметр нельзя использовать с параметром DatabaseObject. Если указан этот параметр, необходимо также указать параметры Path, InputObject или ServerInstance.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatabaseFile
Указывает один или несколько файлов базы данных для резервного копирования. Этот параметр используется только в том случае, если для параметра BackupAction задано значение Files. Если параметр BackupAction имеет значение Files, необходимо указать параметр DatabaseFileGroups или DatabaseFiles.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatabaseFileGroup
Указывает группы файлов базы данных, предназначенные для операции резервного копирования. Этот параметр используется только в том случае, если для свойства BackupAction задано значение Files. Если для параметра BackupAction задано значение Файлы, необходимо указать параметр DatabaseFileGroups или DatabaseFiles.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatabaseObject
Указывает объект базы данных для операции резервного копирования.
Type: | Database |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Encrypt
Тип шифрования, используемый при подключении к SQL Server.
Это значение сопоставляется со свойством Encrypt
SqlConnectionEncryptOption
объекта SqlConnection драйвера Microsoft.Data.SqlClient.
В модуле версии 22 значение по умолчанию — Optional
(для совместимости с версией 21). В версии 23 и более поздних версий модуля значением по умолчанию будет "Обязательно", что может привести к критическому изменению для существующих скриптов.
Этот параметр является новым в версии 22 модуля.
Type: | String |
Accepted values: | Mandatory, Optional, Strict |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptionOption
Задает параметры шифрования для операции резервного копирования.
Type: | BackupEncryptionOptions |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpirationDate
Указывает дату и время истечения срока действия резервного набора данных, а данные резервного копирования больше не считаются допустимыми. Его можно использовать только для резервного копирования данных, хранящихся на дисках или ленточных устройствах. Резервные наборы данных старше даты окончания срока действия могут быть перезаписаны более поздней резервной копией.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FormatMedia
Указывает, что лента отформатирована в качестве первого шага операции резервного копирования. Это не относится к резервной копии диска.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HostNameInCertificate
Имя узла используется для проверки TLS/SSL-сертификата SQL Server. Этот параметр необходимо передать, если экземпляр SQL Server включен для принудительного шифрования и вы хотите подключиться к экземпляру с помощью имени узла или shortname. Если этот параметр опущен, необходимо передать полное доменное имя (FQDN) в -ServerInstance для подключения к экземпляру SQL Server, включенного для принудительного шифрования.
Этот параметр является новым в версии 22 модуля.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Incremental
Указывает, что выполняется разностное резервное копирование.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Initialize
Указывает, что устройства, связанные с операцией резервного копирования, инициализируются. Это перезаписывает все существующие резервные наборы данных на носителе и делает эту резервную копию первым резервным набором данных на носителе.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Указывает объект сервера для расположения резервной копии.
Type: | Server[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LogTruncationType
Указывает поведение усечения для резервных копий журналов. Допустимые значения:
-- TruncateOnly -- NoTruncate -- Truncate
Значение по умолчанию — Truncate.
Type: | BackupTruncateLogType |
Accepted values: | TruncateOnly, NoTruncate, Truncate |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxTransferSize
Указывает максимальное количество байтов, передаваемых между носителем резервной копии и экземпляром SQL Server. Поддерживаются значения, кратные 65 536 байтам (64 КБ), вплоть до 4 194 304 байт (4 МБ).
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MediaDescription
Указывает описание среды, содержащей резервный набор данных. Этот параметр является необязательным.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MediaName
Указывает имя, используемое для идентификации набора носителей.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MirrorDevices
Указывает массив объектов BackupDeviceList, используемых для создания зеркальных резервных копий.
Type: | BackupDeviceList[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoRecovery
Указывает, что резервная копия заключительного конца журнала не создана. При восстановлении база данных находится в состоянии восстановления. Если не задано, резервная копия конца журнала создается. Это применимо, только если для параметра BackupAction задано значение Log.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoRewind
Указывает, что ленточный накопитель остается открытым в конечной позиции после завершения резервного копирования. Если не задано, лента перематывается после завершения выполнения операции. Это не относится к резервным копиям дисков или URL-адресов.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Указывает, что командлет выводит объект Smo.Backup, который выполнил резервное копирование.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Указывает путь к экземпляру SQL Server для выполнения операции резервного копирования. Этот параметр является необязательным. Если этот параметр не указан, его значение по умолчанию соответствует текущему рабочему расположению.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Restart
Указывает, что командлет продолжает обработку частично завершенной операции резервного копирования. Если этот параметр не задан, командлет перезапускает прерванную операцию резервного копирования в начале резервного набора данных.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RetainDays
Указывает количество дней, которое должно пройти до того, как резервный набор данных может быть перезаписан. Его можно использовать только для резервного копирования данных, хранящихся на дисках или ленточных устройствах.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Script
Указывает, что этот командлет выводит скрипт Transact-SQL, выполняющий операцию резервного копирования.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerInstance
Указывает имя экземпляра SQL Server. Этот экземпляр сервера становится целевым объектом операции резервного копирования.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkipTapeHeader
Указывает, что заголовок ленты не считывается.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SqlCredential
Указывает объект SQL Server учетных данных, в котором хранятся сведения о проверке подлинности. При резервном копировании в службу хранилища BLOB-объектов необходимо указать этот параметр. Хранимые сведения о проверке подлинности включают имя учетной записи хранения и связанные значения ключа доступа. Не указывайте этот параметр для диска или ленты.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StatementTimeout
Задайте время ожидания (в секундах) для операции резервного копирования.
Если значение равно 0 или параметр StatementTimeout не указан, время ожидания операции восстановления не истекло.
Type: | Int32 |
Position: | Named |
Default value: | 0 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrustServerCertificate
Указывает, будет ли канал зашифрован при обходе цепочки сертификатов для проверки доверия.
В модуле версии 22 значение по умолчанию — $true
(для совместимости с версией 21). В модуле версии 23+ значение по умолчанию будет "$false", что может привести к критическому изменению для существующих скриптов.
Этот параметр является новым в версии 22 модуля.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UndoFileName
Указывает имя файла отмены, используемого для хранения незафиксированных транзакций, откат которых выполняется во время восстановления.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UnloadTapeAfter
Указывает, что ленточное устройство перематывается и выгружается после завершения операции. Если не задано, перемотка и выгрузка ленты не выполняются. Это не относится к резервным копиям дисков или URL-адресов.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется. Показывает, что произойдет при выполнении командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
SMO.Server
Microsoft.SqlServer.Management.Smo.Database
Microsoft.SqlServer.Management.Smo.Server[]
Указывает объект SMO. Объект сервера, ссылающийся на экземпляр SQL Server, на котором выполняется операция резервного копирования.
System.String[]
Выходные данные
System.Object