Backup-SPFarm

  • Ссылка
Модуль:
sharepoint-server
Применяется к:
SharePoint Server Subscription Edition

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

Синтаксис

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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-ConfigurationOnly

Если этот параметр установлен, резервная копия каждого копируемого объекта будет содержать только параметры конфигурации (без данных).

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-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 Subscription Edition

-Force

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

Если резервное копирование выполняется с параметром ShowTree, параметр Force не используется.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition