Backup-SPFarm
Создает резервную копию отдельной базы данных, веб-приложения или всей фермы.
Синтаксис
DefaultSet
Backup-SPFarm
-BackupMethod <String>
-Directory <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-BackupThreads <Int32>]
[-ConfigurationOnly]
[-Force]
[-Item <String>]
[-Percentage <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ShowTree
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, даже если было определено, что в ней недостаточно свободного места.
ПРИМЕР 4
Backup-SPFarm -ShowTree
В этом примере показаны доступные объекты для резервного копирования с помощью Backup-SPFarm.
Параметры
-AssignmentCollection
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.
Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.
Свойства параметра
| Тип: | SPAssignmentCollection |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-BackupMethod
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает тип создаваемого файла резервной копии.
Если резервное копирование выполняется с параметром -ShowTree, параметр BackupMethod не используется.
Полная резервная копия — это резервная копия всех выбранных данных. Разностная резервная копия — это резервная копия всех выбранных данных, которые изменились с момента последнего резервного копирования. Если элемент не поддерживает разностное резервное копирование, для него создается полная резервная копия.
Типом должно быть одно из следующих значений:
- Full
- Дифференциальный
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
DefaultSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-BackupThreads
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Количество потоков, которое используется во время резервного копирования. Чем меньше потоков, тем файл журнала резервного копирования проще для чтения и понимания. Чем больше потоков, тем больше резервных копий компонентов можно создавать одновременно, что может ускорить выполнение резервного копирования. Минимальное значение — 1, максимальное — 10.
Значение по умолчанию равно 3.
Если резервное копирование выполняется с параметром -ShowTree, параметр BackupMethod не используется.
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
DefaultSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConfigurationOnly
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Если этот параметр установлен, резервная копия каждого копируемого объекта будет содержать только параметры конфигурации (без данных).
SharePoint может завысить объем места, необходимого для резервной копии только для конфигурации, что может привести к тому, что SharePoint оценивает, что в ней недостаточно места для хранения резервной копии по указанному пути.
-Force Используйте параметр в этой ситуации, чтобы продолжить резервное копирование, если у вас достаточно места для хранения резервной копии только для конфигурации.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Перед запуском командлет запросит подтверждение.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Directory
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает путь, по которому продукты 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* создаются автоматически.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
DefaultSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Продолжает резервное копирование, даже если в папке назначения недостаточно места для резервной копии.
Если резервное копирование выполняется с параметром ShowTree, параметр Force не используется.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
DefaultSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Item
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает, какая часть фермы подлежит резервному копированию. Можно использовать полный путь к ферме, отображаемый в параметре ShowTree, или имя целевого компонента в пути, если имя компонента уникально. Если имя подходит для нескольких элементов, необходимо указать полный путь. По умолчанию выбирается верхний узел. Если элемент или путь содержит пробелы, необходимо заключить его в двойные кавычки. Если этот параметр не указан, выполняется резервное копирование всей фермы.
Тип должен быть допустимым элементом; например, Farm\Microsoft SharePoint Foundation Web Application\SharePoint — 80.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Percentage
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Запрашивает отображение обновлений хода выполнения операции резервного копирования с шагом в этом проценте; Например, значение 5 отображает обновления хода выполнения резервного копирования на каждые 5 процентов завершения, а значение 10 отображает обновления хода выполнения резервного копирования на каждые 10 процентов завершенных. Чтобы выводились выходные данные выполнения, необходимо указать параметр Verbose.
Этот процент не является точным, фактический процент выполнения может быть меньше или больше запрошенного. Обновления хода выполнения всегда заносятся в журнал резервного копирования.
Этот процент не является точным, фактический процент выполнения может быть меньше или больше запрошенного.
Значение по умолчанию равно 5. Для очень больших баз данных рекомендуется использовать значение 1.
Допустимыми значениями являются целые числа от 1 до 100.
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
DefaultSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ShowTree
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Показывает, какие объекты в ферме будут создаваться с учетом других параметров, переданных Backup-SPFarm cmdelt, а именно параметра Item. Имена элементов, исключаемых из резервного копирования на основе других параметров, переданных командлету Backup-SPFarm, будут содержать в начале символ звездочки (*). Имена элементов, резервное копирование которых невозможно выполнить, будут заключены в квадратные скобки ([ ]). Если задан параметр ShowTree, резервное копирование не выполняется.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ShowTree
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Отображает описание команды. При этом сама команда не выполняется.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | 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.