Backup-SPFarm
Создает резервную копию отдельной базы данных, веб-приложения или всей фермы.
Синтаксис
Backup-SPFarm
-BackupMethod <String>
-Directory <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-BackupThreads <Int32>]
[-ConfigurationOnly]
[-Force]
[-Item <String>]
[-Percentage <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Backup-SPFarm
[-ShowTree]
[-AssignmentCollection <SPAssignmentCollection>]
[-ConfigurationOnly]
[-Item <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Описание
Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров; использование параметров из разных наборов не допускается. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.
Командлет Backup-SPFarm создает резервную копию всей фермы или ее отдельных компонентов. Его также можно применять для резервного копирования только параметров конфигурации фермы, чтобы их можно было использовать как шаблон для других ферм SharePoint. Если необходимо создать резервную копию одного семейства сайтов, используйте командлет Backup-SPSite.
Чтобы просмотреть доступные объекты для резервного копирования, используйте -ShowTree набор параметров.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
--------------------ПРИМЕР 1---------------------
Backup-SPFarm -Directory \\file_server\share\Backup -BackupMethod full -ConfigurationOnlyВ данном примере выполняется резервное копирование параметров конфигурации фермы в каталог \\file_server\share\Backup.
--------------------ПРИМЕР 2---------------------
Backup-SPFarm -ShowTree -Item "Microsoft SharePoint Foundation Web Application" -VerboseВ данном примере показаны компоненты фермы на узле Microsoft SharePoint Foundation Web Application, для которых должно быть выполнено резервное копирование (без фактического выполнения резервного копирования).
--------------------ПРИМЕР 3---------------------
Backup-SPFarm -Directory C:\Backup -BackupMethod full -BackupThreads 10 -ForceВ данном примере выполняется резервное копирование фермы с использованием 10 потоков, а копия принудительно сохраняется в папку C:\Backup, даже если было определено, что в ней недостаточно свободного места.
--------------------EXAMPLE 4---------------------
Backup-SPFarm -ShowTreeВ этом примере показаны доступные объекты для резервного копирования с помощью Backup-SPFarm.
Параметры
-AssignmentCollection
Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.
Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-BackupMethod
Указывает тип создаваемого файла резервной копии.
Если резервное копирование выполняется с параметром -ShowTree, параметр BackupMethod не используется.
Полная резервная копия — это резервная копия всех выбранных данных. Разностная резервная копия — это резервная копия всех выбранных данных, которые изменились с момента последнего резервного копирования. Если элемент не поддерживает разностное резервное копирование, для него создается полная резервная копия.
Типом должно быть одно из следующих значений:
- Full
- Дифференциальный
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-BackupThreads
Количество потоков, которое используется во время резервного копирования. Чем меньше потоков, тем файл журнала резервного копирования проще для чтения и понимания. Чем больше потоков, тем больше резервных копий компонентов можно создавать одновременно, что может ускорить выполнение резервного копирования. Минимальное значение — 1, максимальное — 10.
Значение по умолчанию равно 3.
Если резервное копирование выполняется с параметром -ShowTree, параметр BackupMethod не используется.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ConfigurationOnly
Если этот параметр установлен, резервная копия каждого копируемого объекта будет содержать только параметры конфигурации (без данных).
SharePoint может завысить объем места, необходимого для резервной копии только для конфигурации, что может привести к тому, что SharePoint оценивает, что в ней недостаточно места для хранения резервной копии по указанному пути. -Force Используйте параметр в этой ситуации, чтобы продолжить резервное копирование, если у вас достаточно места для хранения резервной копии только для конфигурации.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Confirm
Перед запуском командлет запросит подтверждение.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Directory
Указывает путь, по которому продукты SharePoint хранят пакет резервной копии, который он создает. Если у вас есть компьютер, на котором установлены SQL Server и экземпляр продуктов SharePoint, можно использовать локальные пути к диску. Это относится и к базовой установке. Однако если SQL Server и Продукты SharePoint установлены на нескольких компьютерах или если у вас есть несколько серверов с продуктами SharePoint, необходимо использовать UNC-пути к общим папкам, чтобы SQL Server базы данных и компоненты поиска записылись в одно расположение, например \\computer_name\volume\Backup.
В одной папке могут храниться несколько пакетов резервных копий. Используется тот же путь, который указан с помощью параметра Directory командлета Restore-SPFarm.
Тип должен быть одним из следующих допустимых путей:
- C:\folder_name
- \\server_name\folder_name
Папки spbr* создаются автоматически.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Force
Продолжает резервное копирование, даже если в папке назначения недостаточно места для резервной копии.
Если резервное копирование выполняется с параметром ShowTree, параметр Force не используется.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Item
Указывает, какая часть фермы подлежит резервному копированию. Можно использовать полный путь к ферме, отображаемый в параметре ShowTree, или имя целевого компонента в пути, если имя компонента уникально. Если имя подходит для нескольких элементов, необходимо указать полный путь. По умолчанию выбирается верхний узел. Если элемент или путь содержит пробелы, необходимо заключить его в двойные кавычки. Если этот параметр не указан, выполняется резервное копирование всей фермы.
Тип должен быть допустимым элементом; например, Farm\Майкрософт SharePoint Foundation Web Application\SharePoint — 80.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Percentage
Запрашивает отображение обновлений хода выполнения операции резервного копирования с шагом в этом проценте; Например, значение 5 отображает обновления хода выполнения резервного копирования на каждые 5 процентов завершения, а значение 10 отображает обновления хода выполнения резервного копирования на каждые 10 процентов завершенных. Чтобы выводились выходные данные выполнения, необходимо указать параметр Verbose.
Этот процент не является точным, фактический процент выполнения может быть меньше или больше запрошенного. Обновления хода выполнения всегда заносятся в журнал резервного копирования.
Этот процент не является точным, фактический процент выполнения может быть меньше или больше запрошенного.
Значение по умолчанию равно 5. Для очень больших баз данных рекомендуется использовать значение 1.
Допустимыми значениями являются целые числа от 1 до 100.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ShowTree
Показывает, какие объекты в ферме будут создаваться с учетом других параметров, переданных Backup-SPFarm cmdelt, а именно параметра Item. Имена элементов, исключаемых из резервного копирования на основе других параметров, переданных командлету Backup-SPFarm, будут содержать в начале символ звездочки (*). Имена элементов, резервное копирование которых невозможно выполнить, будут заключены в квадратные скобки ([ ]). Если задан параметр ShowTree, резервное копирование не выполняется.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WhatIf
Отображает описание команды. При этом сама команда не выполняется.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |