Convert-SPWebApplication

Ссылка

Модуль:: sharepoint-server

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

Преобразует режим проверки подлинности для веб-приложения.

Синтаксис

Convert-SPWebApplication
       -Identity <SPWebApplicationPipeBind>
       -From <String>
       -To <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Force]
       [-RetainPermissions]
       [-Database <SPContentDatabase>]
       [-MapList <String>]
       [-SiteSubsriptionId <Guid>]
       [-SkipPolicies]
       [-SkipSites]
       [-SourceSkipList <String>]
       [-TrustedProvider <SPTrustedIdentityTokenIssuerPipeBind>]
       [-LoggingDirectory <String>]
       [<CommonParameters>]

Описание

Командлет Convert-SPWebApplication преобразует режим проверки подлинности для веб-приложения в режим проверки подлинности на основе утверждений Windows. После этого учетные записи пользователей в базе данных контента преобразуются в формат закодированных утверждений.

При сохранении разрешений пользователи на сайтах преобразуются только в том случае, если исходная учетная запись включена и запрашивается SharePoint. Например, если учетная запись Active Directory удалена или отключена до преобразования классических утверждений Windows в Windows, учетная запись в базе данных не будет обновлена до формата утверждений.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

------------ПРИМЕР 1----------------

Convert-SPWebApplication -Identity "https://<webappurl>" -To Claims -RetainPermissions

В этом примере показано преобразование веб-приложения, заданное параметром Identity, для использования режима проверки подлинности на основе утверждений.

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

Convert-SPWebApplication -Identity "https://<webappurl>" -From Legacy -To Claims -RetainPermissions

В этом примере веб-приложение, заданное параметром Identity, преобразуется из классического проверка подлинности Windows в режим проверки подлинности утверждений с сохранением разрешений. Параметр -From требуется после применения обновления безопасности MS04-022 или накопительного обновления за апрель 2014 г. для SharePoint Server 2013. Это необходимо для всех версий SharePoint Server 2016.

Параметры

-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

-Database

Указывает имя базы данных контента для миграции.

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

-Force

Принудительное преобразование веб-приложения.

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

-From

Указывает метод проверки подлинности для преобразования.

Допустимые значения для этого параметра:

Устаревшая версия, Claims-Windows, Claims-Trusted-Default

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

-Identity

URL-адрес веб-приложения, для которого требуется выполнить преобразование, например, https://mysite/app1.

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

-LoggingDirectory

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

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

-MapList

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

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

-RetainPermissions

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

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

-SiteSubsriptionId

Указывает GUID для подписки сайта.

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

-SkipPolicies

Указывает, что политики безопасности SPWebApplication не будут перенесены.

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

-SkipSites

Указывает, что узлы SPSites SPWebApplication не будут перенесены.

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

-SourceSkipList

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

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

-To