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


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

-Email

Настраивает отправку сообщений электронной почты после обновления семейства сайтов.

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