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


Restore-SPFarm

Восстанавливает один или несколько элементов из резервной копии.

Синтаксис

Restore-SPFarm
       -Directory <String>
       -RestoreMethod <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-BackupId <Guid>]
       [-ConfigurationOnly]
       [-Confirm]
       [-FarmCredentials <PSCredential>]
       [-Force]
       [-Item <String>]
       [-NewDatabaseServer <String>]
       [-Percentage <Int32>]
       [-RestoreThreads <Int32>]
       [-WhatIf]
       [<CommonParameters>]
Restore-SPFarm
       -Directory <String>
       [-ShowTree]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-BackupId <Guid>]
       [-ConfigurationOnly]
       [-Confirm]
       [-Item <String>]
       [-WhatIf]
       [<CommonParameters>]

Описание

Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров. Совмещать параметры из разных наборов нельзя. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.

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

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

-------------------ПРИМЕР 1-----------------------

Restore-SPFarm -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -RestoreMethod new -ConfigurationOnly

В этом примере параметры конфигурации восстанавливались из резервного пакета в каталоге \\file_server\share\Backup в ферму.

-------------------ПРИМЕР 2-----------------------

Restore-SPFarm -ShowTree -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -Item "Microsoft SharePoint Foundation Web Application" -Verbose

В этом примере показано, какие компоненты фермы будут восстановлены в узле веб-приложения Майкрософт SharePoint Foundation, но не восстанавливаются.

-------------------EXAMPLE 3-----------------------

Restore-SPFarm -Directory C:\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef  -RestoreMethod overwrite -RestoreThreads 10 -Force

В этом примере выполняется восстановление фермы с использованием 10 потоков и подавление предупреждения о перезаписи.

Параметры

-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

-BackupId

Задает идентификатор GUID пакета резервной копии, который необходимо восстановить. С каждым пакетом резервной копии связан уникальный идентификатор GUID. Идентификатор GUID можно просмотреть с помощью командлета Get-SPBackupHistory для просмотра журнала резервного копирования. Если этот параметр опущен, будет использован последний пакет резервной копии, путь к которому указан с помощью параметра Directory.

Типом должен быть действительный идентификатор GUID в виде 12345678-90ab-cdef-1234-567890abcdef.

Type:Guid
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

-ConfigurationOnly

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

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

Предлагает подтвердить выполнение команды. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

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 установлены на нескольких компьютерах, необходимо использовать пути к общим папкам UNC, чтобы SQL Server и продукты SharePoint могли считывать данные из одного расположения (например, \\computer_name \volume\Backup).

Тип должен быть одним из следующих допустимых путей:

  • 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

-FarmCredentials

Указывает учетные данные, которые будут использоваться для всех восстанавливаемых компонентов. Например, учетные данные пула приложений для восстанавливаемых веб-приложений. Если восстанавливаемый пул приложений уже существует в ферме, учетные данные, указанные параметром FarmCredentials, игнорируются при восстановлении этого пула приложений.

Type:PSCredential
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

-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\Microsoft 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

-NewDatabaseServer

Задает допустимое имя сервера базы данных SQL. Значение будет использовано в качестве имени сервера базы данных по умолчанию для всех баз данных, участвующих в операции восстановления.

Этот параметр допустим только для восстановления в виде новых баз данных. Он не может быть использован для восстановления с перезаписью.

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. В противном случае вы можете увидеть ход выполнения в файле журнала восстановления.

Значение процента не точное, и реальные показатели обновления выполнения операции могут быть выше или ниже требуемого значения.

Для очень больших баз данных рекомендуется использовать значение 1.

Тип должен быть целым числом между 1 и 100.

Значение по умолчанию равно 5.

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

-RestoreMethod

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

Допустимые значения:

  • New; Specifies a new location to restore the content and is intended to be used when restoring to a different farm. Additional prompts will be presented to specify the new settings.
  • Overwrite; Restores content and settings to their original locations and is intended to be used when restoring to the same farm it was backed up from. If the Overwrite parameter is used, a confirmation prompt is displayed. If you want the confirmation prompt suppressed, use the Force parameter.
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

-RestoreThreads

Количество потоков, которые используются во время восстановления.

Чем меньше потоков восстановления, тем легче разбираться в журнале восстановления. Однако большее количество потоков восстановления позволяет одновременно восстановить большее количество компонентов, что может ускорить процесс восстановления.

Допустимым диапазоном является диапазон от 1 до 10. Значение по умолчанию равно 3.

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

Показывает, какие объекты в ферме будут восстановлены на основе других параметров, переданных командлету Restore-SPFarm , а именно параметров Item и ConfigurationOnly. Перед элементами, которые будут исключены из восстановления на основе других параметров, переданных Restore-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