Compartir a través de

Convert-SPWebApplication

Módulo:
SharePointServer module

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

Sintaxis

Default (Es el valor predeterminado). 

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

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:SPAssignmentCollection
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Database

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:SPContentDatabase
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Force

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-From

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:SPWebApplicationPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-LoggingDirectory

Aplicable: SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MapList

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RetainPermissions

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SiteSubsriptionId

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica el GUID de la suscripción de sitio.

Propiedades del parámetro

Tipo:Guid
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SkipPolicies

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SkipSites

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SourceSkipList

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-To

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

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

Claims, Claims-Windows, Claims-Trusted-Default, Claims-SharePoint-Online

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TrustedProvider

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Al migrar desde un proveedor de inicio de sesión de confianza, se especifica qué proveedor de inicio de sesión de confianza.

Propiedades del parámetro

Tipo:SPTrustedIdentityTokenIssuerPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.