Restore-SPFarm
Восстанавливает один или несколько элементов из резервной копии.
Синтаксис
DefaultSet
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>]
ShowTree
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
В этом примере показано, какие компоненты фермы будут восстановлены с помощью узла Microsoft SharePoint Foundation Web Application, но фактически они не восстанавливаются.
ПРИМЕР 3
Restore-SPFarm -Directory C:\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -RestoreMethod overwrite -RestoreThreads 10 -Force
В этом примере выполняется восстановление фермы с использованием 10 потоков и подавляется предупреждение о перезаписи.
Параметры
-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 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-BackupId
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Задает идентификатор GUID пакета резервной копии, который необходимо восстановить.
С каждым пакетом резервной копии связан уникальный идентификатор GUID.
GUID можно просмотреть с Get-SPBackupHistory помощью командлета для просмотра журнала резервного копирования.
Если этот параметр опущен, будет использован последний пакет резервной копии, путь к которому указан с помощью параметра Directory.
Типом должен быть действительный идентификатор GUID в виде 12345678-90ab-cdef-1234-567890abcdef.
Свойства параметров
| Тип: | Guid |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConfigurationOnly
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает, что из пакета резервной копии необходимо восстановить только настройки и применить их к объектам в целевой ферме.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Предлагает подтвердить выполнение команды.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | 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 установлены на нескольких компьютерах, необходимо использовать пути к совместному использованию UNC, чтобы SQL Server и продукты SharePoint могли считывать данные из одного и того же расположения (например, \\computer_name \том\Резервное копирование).
Тип должен быть одним из следующих допустимых путей:
- C:\folder_name
- \\server_name\folder_name
Папки spbr* создаются автоматически.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FarmCredentials
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает учетные данные, которые будут использоваться для всех восстанавливаемых компонентов. Например, учетные данные пула приложений для восстанавливаемых веб-приложений. Если восстанавливаемый пул приложений уже существует в ферме, учетные данные, указанные в параметре FarmCredentials, игнорируются при восстановлении этого пула приложений.
Свойства параметров
| Тип: | PSCredential |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
DefaultSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Подавляет появление предупреждений о перезаписи компонентов при проведении перезаписи операции восстановления.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | 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 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NewDatabaseServer
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Задает допустимое имя сервера базы данных SQL. Значение будет использовано в качестве имени сервера базы данных по умолчанию для всех баз данных, участвующих в операции восстановления.
Этот параметр допустим только для восстановления в виде новых баз данных. Он не может быть использован для восстановления с перезаписью.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
DefaultSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Percentage
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает, что сведения о ходе выполнения операции восстановления должны отображаться с шагом, равным этому числу процентов. Например, если задано значение 5, индикатор хода восстановления обновляется после выполнения каждых 5 %, а для значения 10 каждых 10 % операции восстановления.
Примечание. Ход выполнения будет отображаться в выходных данных только в том случае, если указан параметр -Verbose. В противном случае вы можете увидеть ход выполнения в файле журнала восстановления.
Значение процента не точное, и реальные показатели обновления выполнения операции могут быть выше или ниже требуемого значения.
Для очень больших баз данных рекомендуется использовать значение 1.
Тип должен быть целым числом между 1 и 100.
Значение по умолчанию равно 5.
Свойства параметров
| Тип: | Int32 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
DefaultSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RestoreMethod
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает метод восстановления резервной копии.
Допустимые значения:
- 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.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
DefaultSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RestoreThreads
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Количество потоков, которые используются во время восстановления.
Чем меньше потоков восстановления, тем легче разбираться в журнале восстановления. Однако большее количество потоков восстановления позволяет одновременно восстановить большее количество компонентов, что может ускорить процесс восстановления.
Допустимым диапазоном является диапазон от 1 до 10. Значение по умолчанию равно 3.
Свойства параметров
| Тип: | Int32 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
DefaultSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ShowTree
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает, какие объекты в ферме будут восстановлены на основе других параметров, передаваемых командлету, Restore-SPFarm а именно параметров Item и ConfigurationOnly.
Элементы, которые будут исключены из восстановления на основе других параметров, переданных командлету, Restore-SPFarm будут предваряться звездочкой (*).
Элементы, которые нельзя восстановить, будут заключены в квадратные скобки ([ ]).
Операция восстановления выполняться не будет, если указан параметр ShowTree.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | 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 |
| Значение по умолчанию: | 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.