Backup-SqlDatabase

Модуль:: SQLPS Module

Резервное копирование объектов базы данных SQL Server.

Синтаксис

ByPath (по умолчанию)

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>]
    [-Path <String[]>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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>]
    [-Credential <PSCredential>]
    [-ConnectionTimeout <Int32>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByDBObject

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>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

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>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет 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 с помощью имени входа sa SQL Server. Эта команда задает пароль для завершения проверки подлинности.

Пример 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 для создания зашифрованной резервной копии.

Параметры

-BackupAction

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

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

Свойства параметра

Тип:	BackupActionType
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-BackupContainer

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

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-BackupDevice

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

Свойства параметра

Тип:	BackupDeviceItem[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-BackupFile

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

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	3
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-BackupSetDescription

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-BackupSetName

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-BlockSize

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

Свойства параметра

Тип:	Int32
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-BufferCount

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

Свойства параметра

Тип:	Int32
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Checksum

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-CompressionOption

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

По умолчанию
Включено
Выключено

Свойства параметра

Тип:	BackupCompressionOptions
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Confirm

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

Свойства параметра

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	cf

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ConnectionTimeout

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

Свойства параметра

Тип:	Int32
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ContinueAfterError

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-CopyOnly

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Credential

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

Свойства параметра

Тип:	PSCredential
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Database

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByPath

Position:	2
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByName

Position:	2
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByObject

Position:	2
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DatabaseFile

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

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DatabaseFileGroup

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

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DatabaseObject

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

Свойства параметра

Тип:	Database
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByDBObject

Position:	2
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-EncryptionOption

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

Свойства параметра

Тип:	BackupEncryptionOptions
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ExpirationDate

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

Свойства параметра

Тип:	DateTime
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-FormatMedia

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Incremental

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Initialize

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-InputObject

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

Свойства параметра

Тип:	Server[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByObject

Position:	Named
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-LogTruncationType

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

УсечениеOnly
NoTruncate
Усечение

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

Свойства параметра

Тип:	BackupTruncateLogType
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-MaxTransferSize

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

Свойства параметра

Тип:	Int32
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-MediaDescription

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-MediaName

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-MirrorDevices

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

Свойства параметра

Тип:	BackupDeviceList[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-NoRecovery

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-NoRewind

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-PassThru

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Path

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

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByPath

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Restart

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-RetainDays

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

Свойства параметра

Тип:	Int32
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Script

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ServerInstance

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

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByName

Position:	Named
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-SkipTapeHeader

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-SqlCredential

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

Свойства параметра

Тип:	PSObject
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-UndoFileName

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-UnloadTapeAfter

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-WhatIf

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

Свойства параметра

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	wi

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

SMO.Server

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

Restore-SqlDatabase

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

Была ли эта страница полезна?

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

Backup-SqlDatabase

Синтаксис

ByPath (по умолчанию)

ByName

ByDBObject

ByObject

ByBackupContainer

Описание

Примеры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметры

-BackupAction

Свойства параметра

Наборы параметров

-BackupContainer

Свойства параметра

Наборы параметров

-BackupDevice

Свойства параметра

Наборы параметров

-BackupFile

Свойства параметра

Наборы параметров

-BackupSetDescription

Свойства параметра

Наборы параметров

-BackupSetName

Свойства параметра

Наборы параметров

-BlockSize

Свойства параметра

Наборы параметров

-BufferCount

Свойства параметра

Наборы параметров

-Checksum

Свойства параметра

Наборы параметров

-CompressionOption

Свойства параметра

Наборы параметров

-Confirm

Свойства параметра

Наборы параметров

-ConnectionTimeout

Свойства параметра

Наборы параметров

-ContinueAfterError

Свойства параметра

Наборы параметров

-CopyOnly

Свойства параметра

Наборы параметров

-Credential

Свойства параметра

Наборы параметров

-Database

Свойства параметра

Наборы параметров

-DatabaseFile

Свойства параметра

Наборы параметров

-DatabaseFileGroup

Свойства параметра

Наборы параметров

-DatabaseObject