Upgrade-SPContentDatabase
Возобновляет завершившийся сбоем процесс обновления базы данных или запускает обновление базы данных до следующей сборки.
Синтаксис
ContentDatabaseById
Upgrade-SPContentDatabase
[-Identity] <SPContentDatabasePipeBind>
[-ForceDeleteLock]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-NoB2BSiteUpgrade]
[-ServerInstance <SPDatabaseServiceInstancePipeBind>]
[-SkipIntegrityChecks]
[-UseSnapshot]
[-WhatIf]
[-AllowUnattached]
[-SkipSiteUpgrade]
[<CommonParameters>]
ContentDatabaseByName
Upgrade-SPContentDatabase
-Name <String>
-WebApplication <SPWebApplicationPipeBind>
[-ForceDeleteLock]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-NoB2BSiteUpgrade]
[-ServerInstance <SPDatabaseServiceInstancePipeBind>]
[-SkipIntegrityChecks]
[-UseSnapshot]
[-WhatIf]
[-AllowUnattached]
[-SkipSiteUpgrade]
[<CommonParameters>]
Описание
Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров. Совмещать параметры из разных наборов нельзя. Для получения дополнительной информации об использовании наборов параметров см. Наборы параметров командлета.
Upgrade-SPContentDatabase Используйте командлет , чтобы возобновить неудачное обновление базы данных или начать обновление базы данных от сборки до базы данных контента SharePoint.
Командлет Upgrade-SPContentDatabase инициирует обновление существующей базы данных контента, подключенной к текущей ферме.
Этот командлет начинает новый сеанс обновления, позволяющий продолжить завершившееся ошибкой обновление базы данных контента до следующей версии или до следующей сборки либо начать новое обновление базы данных до следующей сборки.
Если база данных размещена в версии SQL Server, поддерживающей создание и использование моментальных снимков базы данных, этот командлет может использовать snapshot базы данных для обновлений от сборки до сборки. В процессе обновления база данных доступна пользователям только для чтения (моментальный снимок). По завершении этого процесса отображается обновленный контент.
По умолчанию этот командлет обновляет схему базы данных и при необходимости запускает обновление до следующей сборки для всех семейств сайтов в указанной базе данных контента. Чтобы предотвратить обновление семейств веб-сайтов от сборки до сборки, используйте параметр NoB2BSiteUpgrade.
Этот командлет не запускает обновление семейств веб-сайтов до следующей версии.
Примеры
ПРИМЕР 1
Upgrade-SPContentDatabase WSS_Content
В этом примере обновляется схема существующей базы данных контента WSS_Content, после чего при необходимости выполняются операции обновления до следующей сборки в отношении существующих семейств сайтов. Эта операция не изменяет уровень совместимости существующих семейств сайтов в базе.
ПРИМЕР 2
Upgrade-SPContentDatabase WSS_Content -NoB2BSiteUpgrade
В этом примере обновляется только схема существующей базы данных контента WSS_Content. Обновление семейств сайтов до следующей сборки не выполняется. Эта операция не изменяет уровень совместимости существующих семейств сайтов в базе.
ПРИМЕР 3
Upgrade-SPContentDatabase WSS_Content -NoB2BSiteUpgrade -UseSnapshot
В этом примере существующая схема базы данных WSS_Content обновляется только при использовании snapshot базы данных для сохранения доступа только для чтения к содержимому во время обновления. Обновление семейств сайтов до следующей сборки не выполняется. Эта операция не меняет уровень CompatibilityLevel для существующих семейств веб-сайтов в базе данных.
Параметры
-AllowUnattached
Применимо: SharePoint Server 2016, SharePoint Server 2019
Позволяет продолжить обновление базы данных контента, которая в данный момент не присоединена к ферме SharePoint.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-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 |
-Confirm
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Предлагает подтвердить выполнение команды.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ForceDeleteLock
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Предписывает принудительное удаление блокировок из базы данных перед началом обновления.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 2 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Задает базу данных контента, которую требуется обновить.
Значением должен быть действительный идентификатор GUID в виде 12345678-90ab-cdef-1234-567890bcdefgh или экземпляр действительного объекта SPContentDatabase.
Свойства параметра
| Тип: | SPContentDatabasePipeBind |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ContentDatabaseById
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Задает имя присоединенной базы данных контента.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ContentDatabaseByName
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NoB2BSiteUpgrade
Применимо: SharePoint Server 2010, SharePoint Server 2013
Отключает обновление всех дочерних объектов при обновлении до следующей сборки.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ServerInstance
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Экземпляр SQL Server, на котором размещена присоединенная база данных контента.
Свойства параметра
| Тип: | SPDatabaseServiceInstancePipeBind |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SkipIntegrityChecks
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает, что процесс обновления не будет выполнять внутренние проверки целостности, такие как отсутствующие шаблоны и обнаружение потерянных данных в рамках процесса обновления.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SkipSiteUpgrade
Применимо: SharePoint Server 2016, SharePoint Server 2019
Отключает обновление баз данных и их дочерних объектов.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | NoB2BSiteUpgrade |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UseSnapshot
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Позволяет использовать моментальный снимок в процессе обновления без присоединения. Это приведет к snapshot текущей базы данных, а затем выполнит все операции обновления, которые применяются к базе данных и при необходимости к ее содержимому.
Существующие подключения к базе данных контента будут настроены для использования snapshot на время обновления, а затем переключятся обратно после успешного завершения обновления. Сбой обновления возвращает базу данных в состояние при snapshot.
Этот параметр работает только для версий SQL Server, поддерживающих создание и использование моментальных снимков, например sql ServerEnterprise edition.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WebApplication
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает веб-приложение, в котором размещена присоединенная база данных контента.
Свойства параметра
| Тип: | SPWebApplicationPipeBind |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ContentDatabaseByName
| 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.