Upgrade-SPSite

Ссылка

Модуль:: sharepoint-server

Применяется к:: SharePoint Server Subscription Edition

Запускает процесс обновления семейства сайтов.

Синтаксис

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

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

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

Параметры

-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 Subscription Edition

-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 Subscription Edition

-Email

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

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

-Identity

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

Type:	SPSitePipeBind
Position:	1
Default value:	None
Required:	True
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-QueueOnly

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

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

-Unthrottled

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

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

-VersionUpgrade

Задает обновление до следующей версии объекта SPSite. Если этот параметр установлен, внутренний механизм запускает все доступные операции обновления до следующей сборки, связанные с текущим рабочим режимом семейства сайтов. Далее выполняются операции обновления до следующей версии, позволяющие перевести семейство сайтов в следующий рабочий режим, в том числе и любые связанные с этим режимом операции обновления до следующей сборки. Если этот параметр не установлен, запускаются только доступные операции обновления до следующей сборки, связанные с текущим рабочим режимом семейства сайтов.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition