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

В этом примере обновляется существующее семейство веб-сайтов<site name> https:///sites/testsite, используя только действия по обновлению сборки и сборки. В рамках этой операции не изменяется значение атрибута SPSite.CompatibilityLevel.

-------------ПРИМЕР 2----------

Upgrade-SPSite https://<site name>/sites/testsite -VersionUpgrade

В этом примере обновляется существующее семейство веб-сайтов<site name> https:///sites/testsite, используя только действия по обновлению сборки и сборки. В рамках этой операции не изменяется значение атрибута SPSite.CompatibilityLevel.

Параметры

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Предлагает подтвердить выполнение команды. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Email

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Identity

Объект SPSite, в отношении которого будут выполнены операции обновления.

Type:SPSitePipeBind
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Priority

Определяет приоритет обновления сайта.

Допустимые значения:

  • 128-255 (низкий приоритет)

  • 11-127 (нормальный приоритет)

  • 0-10 (высокий приоритет)

Type:Byte
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-QueueOnly

Указывает, что сайт помещается в очередь для отложенного обновления, управляемого заданием таймера.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Unthrottled

Позволяет администратору фермы обойти пределы регулирования и выполнить обновление семейства, даже если предполагается обновление слишком большого числа семейств сайтов.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-VersionUpgrade

Specifies to perform a version-to-version upgrade on the SPSite object. When this parameter is set, it internally triggers all available build-to-build actions that are associated with the current site collection operating mode. Version-to-version actions follow to bring site collections to the next site collection operating mode inclusive of all new build-to-build actions that are associated with the new site collection operating mode. When this parameter is not set, it triggers only available build-to-build upgrade actions that are associated with the current site collection operating mode.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Отображает описание команды. При этом сама команда не выполняется. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition