Backup-SqlDatabase

Ссылка

Модуль:: SQLServer

Резервное копирование объектов базы данных 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>]
      [-ProgressAction <ActionPreference>]
      [-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>]
      [-ProgressAction <ActionPreference>]
      [-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>]
      [-ProgressAction <ActionPreference>]
      [-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>]
      [-ProgressAction <ActionPreference>]
      [-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>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Backup-SqlDatabase выполняет операции резервного копирования в базе данных SQL Server.

Сюда входят полные резервные копии базы данных, резервные копии журналов транзакций и резервные копии файлов базы данных.

Этот командлет моделиируется после класса Microsoft.SqlServer.Management.Smo.Backup.

Параметры этого класса обычно соответствуют свойствам этого объекта Smo.

Чтобы создать резервную копию базы данных по пути экземпляра сервера и имени базы данных, укажите путь экземпляра сервера в параметре Path и имя базы данных в параметре Базы данных.

Чтобы создать резервную копию базы данных с помощью объекта 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 в расположение резервного копирования экземпляра сервера Computer\Instance. Файл резервной копии называется "MainDB.bak".

Пример 2. Резервное копирование базы данных на основе расположения

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

Эта команда создает полную резервную копию базы данных MainDB в расположении резервного копирования по умолчанию экземпляра сервера Computer\Instance. Текущий рабочий каталог используется для определения экземпляра сервера, в котором выполняется резервное копирование.

Пример 3. Резервное копирование журнала транзакций

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

Эта команда создает резервную копию журнала транзакций базы данных MainDB в расположение резервного копирования экземпляра сервера Computer\Instance. Файл резервной копии называется 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 в расположение резервного копирования экземпляра сервера "Computer\Instance". Файл резервной копии называется "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 в службе хранилища BLOB-объектов Windows 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 в службе хранилища BLOB-объектов Windows 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"

Эта команда создает резервную копию всех баз данных на экземпляре сервера "Computer\Instance" в расположение службы хранилища BLOB-объектов Windows 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 модуля.

Тип:	PSObject
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BackupAction

Указывает тип выполняемой операции резервного копирования. Допустимые значения:

База данных. Резервное копирование всех файлов данных в базе данных.
Файлы. Резервное копирование файлов данных, указанных в параметрах DatabaseFile или DatabaseFileGroup.
Журнал. Резервное копирование журнала транзакций.

Тип:	BackupActionType
Допустимые значения:	Database, Files, Log
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BackupContainer

Указывает папку или расположение, в котором командлет сохраняет резервные копии. Это может быть папка на диске или URL-адресе контейнера BLOB-объектов Azure. Этот параметр может быть полезен при резервном копировании нескольких баз данных в определенном экземпляре. Этот параметр нельзя использовать с параметром BackupDevice. Параметр BackupContainer нельзя использовать с параметром BackupFile.

Путь, используемый для указания расположения, должен заканчиваться косой чертой (/).

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BackupDevice

Указывает устройства, на которых хранятся резервные копии. Этот параметр нельзя использовать с параметром BackupFile. Используйте этот параметр, если выполняется резервное копирование на ленту.

Тип:	BackupDeviceItem[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BackupFile

Указывает расположение и имена файлов для резервной копии.

Это необязательный параметр.

Если это не указано, резервные копии хранятся в расположении резервного копирования по умолчанию сервера под именем databasename.bak для полных резервных копий файлов или databasename.trn для резервных копий журналов.

При резервном копировании в несколько файлов разделите имена файлов запятыми, например -BackupFile C:\Backups\databasename2.bak,C:\Backups\databasename2.bak

Этот параметр нельзя использовать с параметрами -BackupDevice или -BackupContainer.

Тип:	String[]
Position:	2
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BackupSetDescription

Указывает описание резервного набора данных. Этот параметр является необязательным.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BackupSetName

Указывает имя резервного набора данных.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BlockSize

Задает размер физического блока для резервной копии в байтах. Поддерживаемые размеры: 512, 1024, 2048, 4096, 8192, 16384, 32768 и 65536 (64 КБ) байт. Значение по умолчанию — 65536 для ленточных устройств и 512 для всех остальных устройств.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BufferCount

Указывает количество буферов ввода-вывода, используемых для операции резервного копирования. Можно указать любое положительное целое число. Если в процессе Sqlservr.exe для буферов недостаточно виртуального адресного пространства, вы получите ошибку из памяти.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Checksum

Указывает, что значение контрольной суммы вычисляется во время операции резервного копирования.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CompressionOption

Задает параметры сжатия для операции резервного копирования.

Тип:	BackupCompressionOptions
Допустимые значения:	Default, On, Off
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

Запрашивает подтверждение перед запуском командлета. Запрашивает подтверждение перед запуском командлета.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ConnectionTimeout

Указывает количество секунд, ожидающее подключения к серверу до сбоя времени ожидания. Значение времени ожидания должно быть целым числом от 0 до 65534. Если задано значение 0, попытки подключения не истекает.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ContinueAfterError

Указывает, что операция продолжается при возникновении ошибки контрольной суммы. Если не задано, операция завершится ошибкой после ошибки контрольной суммы.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CopyOnly

Указывает, что резервная копия является резервной копией только для копирования. Резервная копия только для копирования не влияет на обычную последовательность регулярных запланированных резервных копий.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Credential

Указывает объект PSCredential, содержащий учетные данные для имени входа SQL Server с разрешением на выполнение этой операции. Это не объект учетных данных SQL, используемый для хранения данных проверки подлинности внутри SQL Server при доступе к ресурсам за пределами SQL Server.

Тип:	PSCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Database

Указывает имя базы данных для резервного копирования. Этот параметр нельзя использовать с параметром DatabaseObject. Если этот параметр указан, необходимо также указать параметры Path, InputObject или ServerInstance.

Тип:	String
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DatabaseFile

Указывает один или несколько файлов базы данных для резервного копирования. Этот параметр используется только в том случае, если параметр BackupAction имеет значение Files. Если параметр BackupAction имеет значение Files, необходимо указать параметр DatabaseFileGroups или DatabaseFiles.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DatabaseFileGroup

Указывает группы файлов базы данных, предназначенные для операции резервного копирования. Этот параметр используется только в том случае, если для свойства BackupAction задано значение Files. Если параметр BackupAction имеет значение Files, необходимо указать параметр DatabaseFileGroups или DatabaseFiles.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DatabaseObject

Указывает объект базы данных для операции резервного копирования.

Тип:	Database
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Encrypt

Тип шифрования, используемый при подключении к SQL Server.

Это значение сопоставляется со свойством EncryptSqlConnectionEncryptOption в объекте SqlConnection драйвера Microsoft.Data.SqlClient.

В версии 22 модуля по умолчанию используется Optional (для совместимости с версией 21). В версии 23+ модуля значение по умолчанию будет "Обязательный", которое может создать критическое изменение для существующих скриптов.

Этот параметр является новым в версии 22 модуля.

Тип:	String
Допустимые значения:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EncryptionOption

Задает параметры шифрования для операции резервного копирования.

Тип:	BackupEncryptionOptions
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ExpirationDate

Указывает дату и время истечения срока действия резервного набора данных, а данные резервной копии больше не считаются допустимыми. Это можно использовать только для резервных копий, хранящихся на дисках или ленточных устройствах. Резервные наборы старше даты окончания срока действия доступны для перезаписи более поздней резервной копии.

Тип:	DateTime
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FormatMedia

Указывает, что лента отформатирована как первый шаг операции резервного копирования. Это не относится к резервному копированию дисков.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-HostNameInCertificate

Имя узла, используемое при проверке TLS/SSL-сертификата SQL Server. Этот параметр необходимо передать, если экземпляр SQL Server включен для принудительного шифрования и требуется подключиться к экземпляру с помощью имени узла или короткого имени. Если этот параметр опущен, передача полного доменного имени (FQDN) в -ServerInstance необходима для подключения к экземпляру SQL Server, включенного для принудительного шифрования.

Этот параметр является новым в версии 22 модуля.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Incremental

Указывает, что выполняется разностная резервная копия.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Initialize

Указывает, что устройства, связанные с операцией резервного копирования, инициализированы. Это перезаписывает все существующие резервные наборы на носителе и делает эту резервную копию первым резервным набором на носителе.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

Указывает объект сервера для расположения резервного копирования.

Тип:	Server[]
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-LogTruncationType

Указывает поведение усечения для резервных копий журналов. Допустимые значения:

-- TruncateOnly -- NoTruncate -- Усечение

Значение по умолчанию — Усечение.

Тип:	BackupTruncateLogType
Допустимые значения:	TruncateOnly, NoTruncate, Truncate
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MaxTransferSize

Указывает максимальное количество байтов, передаваемых между носителем резервного копирования и экземпляром SQL Server. Возможные значения — несколько из 65536 байт (64 КБ), до 4194304 байтов (4 МБ).

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MediaDescription

Указывает описание для среды, содержащей резервный набор данных. Этот параметр является необязательным.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MediaName

Указывает имя, используемое для идентификации набора носителей.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MirrorDevices

Задает массив объектов BackupDeviceList, используемых зеркальной резервной копией.

Тип:	BackupDeviceList[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-NoRecovery

Указывает, что конечный конец журнала не резервируется. При восстановлении база данных находится в состоянии восстановления. Если не задано, резервная копия хвоста журнала выполняется. Это применяется только в том случае, если для параметра BackupAction задано значение Log.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-NoRewind

Указывает, что ленточный диск остается открытым в конечной позиции после завершения резервного копирования. Если не задано, лента перенастроится после завершения операции. Это не относится к резервным копиям дисков или URL-адресов.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PassThru

Указывает, что командлет выводит объект Smo.Backup, который выполнил резервную копию.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Path

Указывает путь к экземпляру SQL Server для выполнения операции резервного копирования. Это необязательный параметр. Если этот параметр не указан, значение этого параметра по умолчанию соответствует текущему рабочему расположению.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ProgressAction

Определяет, как PowerShell реагирует на обновления хода выполнения, созданные скриптом, командлетом или поставщиком, например индикаторами хода выполнения, созданными командлетом Write-Progress. Командлет Write-Progress создает индикаторы хода выполнения, показывающие состояние команды.

Тип:	ActionPreference
Aliases:	proga
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Restart

Указывает, что командлет продолжает обработку частично завершенной операции резервного копирования. Если этот параметр не задан, командлет перезапускает прерванную операцию резервного копирования в начале резервного набора данных.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RetainDays

Указывает количество дней, которое должно пройти до перезаписи резервного набора. Это можно использовать только для резервных копий, хранящихся на дисках или ленточных устройствах.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Script

Указывает, что этот командлет выводит скрипт Transact-SQL, выполняющий операцию резервного копирования.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ServerInstance

Указывает имя экземпляра SQL Server. Этот экземпляр сервера становится целевым объектом операции резервного копирования.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-SkipTapeHeader

Указывает, что заголовок ленты не считывается.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SqlCredential

Указывает объект учетных данных SQL Server, в котором хранятся сведения о проверке подлинности. При резервном копировании в службу хранилища BLOB-объектов необходимо указать этот параметр. Данные проверки подлинности, хранящиеся, включают имя учетной записи хранения и связанные значения ключей доступа. Не указывайте этот параметр для диска или ленты.

Тип:	PSObject
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-StatementTimeout

Задайте время ожидания (в секундах) для операции резервного копирования.

Если значение равно 0 или параметру StatementTimeout не указано, операция восстановления не будет истекать.

Тип:	Int32
Position:	Named
Default value:	0
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-TrustServerCertificate

Указывает, будет ли канал зашифрован при обходе цепочки сертификатов для проверки доверия.

В версии 22 модуля по умолчанию используется $true (для совместимости с версией 21). В версии 23+ модуля значение по умолчанию будет иметь значение "$false", которое может создать критическое изменение для существующих скриптов.

Этот параметр является новым в версии 22 модуля.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UndoFileName

Указывает имя файла отмены, используемого для хранения незафиксированных транзакций, откат которых выполняется во время восстановления.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UnloadTapeAfter

Указывает, что ленточное устройство перезагружается и выгружается после завершения операции. Если не задано, попытка перемотки и выгрузки ленточного носителя не выполняется. Это не относится к резервным копиям дисков или URL-адресов.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется. Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

SMO.Server

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

Указывает SMO. Объект сервера, ссылающийся на экземпляр SQL Server, на котором выполняется операция резервного копирования.

System.String[]

Выходные данные

System.Object

Restore-SqlDatabase

Поделиться через

Backup-SqlDatabase

Синтаксис

Описание

Примеры

Пример 1. Резервное копирование полной базы данных

Пример 2. Резервное копирование базы данных на основе расположения

Пример 3. Резервное копирование журнала транзакций

Пример 4. Резервное копирование базы данных и запрос учетных данных

Пример 5. Резервное копирование базы данных в сетевую общую папку

Пример 6. Резервное копирование всех баз данных в экземпляре сервера

Пример 7. Резервное копирование всех баз данных в экземпляре сервера в сетевую общую папку

Пример 8. Резервное копирование всех файлов в дополнительных группах файлов

Пример 9. Создание разностной резервной копии

Пример 10. Создание резервной копии на ленточный диск

Пример 11. Резервное копирование базы данных в службу хранилища BLOB-объектов Azure

Пример 12. Резервное копирование базы данных в службу хранилища BLOB-объектов Azure и указание имени файла

Пример 13. Резервное копирование всех баз данных в службу хранилища BLOB-объектов Azure

Пример 14. Создание зашифрованной резервной копии

Параметры

-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

-ProgressAction

-Restart

-RetainDays

-Script

-ServerInstance

-SkipTapeHeader

-SqlCredential

-StatementTimeout

-TrustServerCertificate

-UndoFileName

-UnloadTapeAfter

-WhatIf

Входные данные

Выходные данные

Связанные ссылки

Обратная связь

Обратная связь

Дополнительные ресурсы