Convert-SPWebApplication

Referencia

Módulo:: SharePointServer

Se aplica a:: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Convierte el modo de autenticación de una aplicación web.

Syntax

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>]

Description

Use el cmdlet Convert-SPWebApplication para convertir el modo de autenticación de una aplicación web al modo de autenticación de notificaciones de Windows y migrar las cuentas de usuario de la base de datos de contenido a valores codificados en notificaciones.

Al conservar permisos, los usuarios dentro de Sitios solo se convierten si SharePoint habilita y consulta la cuenta de origen. Por ejemplo, si la cuenta de Active Directory se elimina o deshabilita antes de una conversión de notificaciones clásica de Windows a Windows, la cuenta de la base de datos no se actualizará al formato notificaciones.

Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.

Ejemplos

------------EJEMPLO 1-------

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

En este ejemplo se convierte una aplicación web especificada por el parámetro Identity para que use el modo de autenticación de notificaciones.

------------EJEMPLO 2-------

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

En este ejemplo se convierte una aplicación web especificada por el parámetro Identity de autenticación de Windows clásica al modo de autenticación de notificaciones mientras se conservan los permisos. El parámetro -From es necesario después de aplicar la actualización de seguridad MS04-022 o la actualización acumulativa de abril de 2014 para SharePoint Server 2013. Esto es necesario para todas las versiones de SharePoint Server 2016.

Parámetros

-AssignmentCollection

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

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

-Database

Especifica el nombre de la base de datos de contenido que se va a migrar.

Type:	SPContentDatabase
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

-Force

Fuerza la conversión de la aplicación web.

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

-From

Especifica el método de autenticación desde el que se va a convertir.

Los valores válidos para este parámetro son los siguientes.

Heredado, 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 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Especifica la dirección URL de la aplicación web que desea convertir (por ejemplo, https://mysite/app1.

Type:	SPWebApplicationPipeBind
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-LoggingDirectory

Especifica un directorio donde se escribirán registros detallados sobre los resultados de la migración.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2016, SharePoint Server 2019

-MapList

Especifica un archivo que contiene como lista de filas en el formato siguiente: user-key, migrated-user-name, migrated-user-key.

Type:	String
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

-RetainPermissions

Especifica la cuenta en la que se ejecuta el cmdlet y retiene el permiso en la aplicación web.

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

-SiteSubsriptionId

Especifica el GUID de la suscripción de sitio.

Type:	Guid
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

-SkipPolicies

Especifica que no se migrarán las directivas de seguridad SPWebApplication.

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

-SkipSites

Especifica que no se migrarán los SPSites de SPWebApplication.

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

-SourceSkipList

Especifica un archivo que contiene como lista de filas en el formato siguiente: user-key.

Type:	String
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

-To

Especifica el método de autenticación al que se va a convertir.