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 |