Upgrade-SPSite
Запускает процесс обновления семейства сайтов.
Синтаксис
Upgrade-SPSite
[-Identity] <SPSitePipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Email]
[-QueueOnly]
[-Unthrottled]
[-VersionUpgrade]
[-WhatIf]
[-Priority <Byte>]
[<CommonParameters>]Описание
Командлет Upgrade-SPSite запускает процесс обновления в семействе веб-сайтов.
Командлет Upgrade-SPSite активирует процесс обновления для указанного объекта SPSite.
Кроме того, с его помощью можно возобновить обновление, завершившееся сбоем.
Если с помощью этого командлета вы запускаете обновление для объекта SPSite, может выполняться обновление как до следующей сборки, так и до следующей версии этого объекта.
По умолчанию Upgrade-SPSite командлет работает как обновление от сборки до сборки.
Это позволяет предотвратить незапланированное обновление версии для семейств веб-сайтов, если вы используете этот командлет после установки исправления.
При обновлении до следующей версии проверяется работоспособность семейства веб-сайтов в режиме восстановления, что позволяет гарантировать готовность семейства к обновлению.
В случае успешной проверки выполняются оставшиеся операции обновления.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
-------------ПРИМЕР 1----------
Upgrade-SPSite https://<site name>/sites/testsiteВ этом примере выполняется обновление существующего семейства веб-сайтов https://< сайт-имен>, сайтов и тестов сайта с помощью доступных действий обновления от сборки до сборки, связанных с текущим режимом работы семейства веб-сайтов. В рамках этой операции не изменяется значение атрибута SPSite.CompatibilityLevel.
-------------ПРИМЕР 2----------
Upgrade-SPSite https://<site name>/sites/testsite -VersionUpgradeВ этом примере выполняется обновление существующего семейства веб-сайтов https://< site name>/sites/testsite, используя все доступные действия обновления от сборки до сборки, связанные с текущим режимом работы семейства веб-сайтов и выполняющие обновление от версии до версии.
Параметры
-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 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 2013, SharePoint Server 2016, SharePoint Server 2019 |
Настраивает отправку сообщений электронной почты после обновления семейства сайтов.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Identity
Объект SPSite, в отношении которого будут выполнены операции обновления.
| Type: | SPSitePipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Priority
Определяет приоритет обновления сайта.
Допустимые значения:
128–255 (низкий приоритет)
11–127 (нормальный приоритет)
0–10 (высокий приоритет)
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-QueueOnly
Указывает, что сайт помещается в очередь для отложенного обновления, управляемого заданием таймера.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Unthrottled
Позволяет администратору фермы обойти пределы регулирования и выполнить обновление семейства, даже если предполагается обновление слишком большого числа семейств сайтов.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-VersionUpgrade
Задает обновление до следующей версии объекта SPSite. Если этот параметр установлен, внутренний механизм запускает все доступные операции обновления до следующей сборки, связанные с текущим рабочим режимом семейства сайтов. Далее выполняются операции обновления до следующей версии, позволяющие перевести семейство сайтов в следующий рабочий режим, в том числе и любые связанные с этим режимом операции обновления до следующей сборки. Если этот параметр не установлен, запускаются только доступные операции обновления до следующей сборки, связанные с текущим рабочим режимом семейства сайтов.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 2013, SharePoint Server 2016, SharePoint Server 2019 |