Invoke-SPOSiteSwap

  • Referencia
Módulo:
Microsoft.Online.SharePoint.PowerShell
Se aplica a:
SharePoint Online

Invoca un trabajo para intercambiar la ubicación de un sitio en otro sitio mientras archiva el sitio original.

Syntax

Invoke-SPOSiteSwap
         -SourceUrl <string>
         -TargetUrl <string>
         -ArchiveUrl <string>
         [-DisableRedirection]
         [-Force]
         [-NoWait]   
      [<CommonParameters>]

Description

Intercambia la ubicación de un sitio de origen con un sitio de destino mientras archiva el sitio de destino original.

Tenga en cuenta que el sitio de destino tiene que ser:

Cuando se inicia el intercambio, el sitio de destino se mueve a la ubicación de archivado y el sitio de origen se mueve a la ubicación de destino. De forma predeterminada, se crea una redirección de sitio en la ubicación de origen donde se redirigirá el tráfico a la ubicación de destino.

Si el destino es el sitio raíz en https://tenant-name.sharepoint.com, deben realizarse las siguientes actividades de preparación antes de realizar el intercambio:

  1. No se mostrarán los Vínculos destacados que se hayan definido en la página de inicio de SharePoint en https://tenant-name.sharepoint.com/_layouts/15/sharepoint.aspx después de ejecutar el intercambio. Si es necesario, los Vínculos destacados se documentarán para que se puedan volver a crear manualmente después del intercambio.
  2. Las funciones como el uso compartido externo y las interfaces de la aplicación dependen de las directivas y permisos definidos en el sitio raíz. Revise el sitio de origen para asegurarse de que tiene las directivas y los permisos que se requieren de acuerdo con el sitio raíz existente. Esto incluye la configuración de uso compartido externo, así como los permisos del sitio.
  3. Los inquilinos más grandes que tengan más de ~10 000 licencias deberán ejecutar la Herramienta de diagnóstico de página en el sitio de origen (asegúrese de que el usuario que ejecuta la herramienta de diagnóstico de página tiene derechos de edición en el sitio de origen). Cualquier resultado de análisis que tenga la categoría de Atención requerida (Rojo) u Oportunidades de mejora (Naranja) deberá corregirse antes de realizar el intercambio.

Los sitios de origen y de destino no se pueden conectar a un grupo de Office 365. Tampoco pueden ser sitios centrales ni asociados a un centro. Si un sitio es sitio central, cancele el registro como sitio central, intercambie el sitio raíz y, a continuación, regístrelo como un sitio central. Si un sitio está asociado a un centro, quite esta asociación, intercambie el sitio raíz y, a continuación, vuelva a asociar el sitio.

Si la característica de publicación se ha activado anteriormente o está activada actualmente en el sitio de origen, no se puede utilizar Invoke-SPOSiteSwap.

Ejemplos

EJEMPLO 1

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/CommunicationSite -TargetUrl https://contoso.sharepoint.com -ArchiveUrl https://contoso.sharepoint.com/sites/Archive

Archiva el sitio existente de https://contoso.sharepoint.com en https://contoso.sharepoint.com/sites/Archive y mueve https://contoso.sharepoint.com/sites/CommunicationSite a https://contoso.sharepoint.com. Se creará una redirección de sitio en https://contoso.sharepoint.com/sites/CommunicationSite que redirigirá cualquier solicitud a https://contoso.sharepoint.com.

EJEMPLO 2

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/SearchSite -TargetUrl https://contoso.sharepoint.com/search -ArchiveUrl https://contoso.sharepoint.com/sites/Archive

Archiva el sitio del Centro de búsqueda existente de https://contoso.sharepoint.com/search en https://contoso.sharepoint.com/sites/Archive y mueve el https://contoso.sharepoint.com/sites/SearchSite a https://contoso.sharepoint.com/search. Se creará una redirección del sitio en https://contoso.sharepoint.com/sites/SearchSite que redirigirá cualquier solicitud a https://contoso.sharepoint.com/search.

EJEMPLO 3

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/CommunicationSite -TargetUrl https://contoso.sharepoint.com -ArchiveUrl https://contoso.sharepoint.com/sites/Archive -DisableRedirection

Archiva el sitio existente de https://contoso.sharepoint.com en https://contoso.sharepoint.com/sites/Archive y mueve https://contoso.sharepoint.com/sites/CommunicationSite a https://contoso.sharepoint.com. Se creará una redirección de sitio en https://contoso.sharepoint.com/sites/CommunicationSite.

EJEMPLO 4

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/SearchSite -TargetUrl https://contoso.sharepoint.com/search -ArchiveUrl https://contoso.sharepoint.com/sites/Archive -Force

Archiva el sitio del Centro de búsqueda existente de https://contoso.sharepoint.com/search en https://contoso.sharepoint.com/sites/Archive y mueve https://contoso.sharepoint.com/sites/SearchSite a https://contoso.sharepoint.com/search. Se creará un redireccionamiento del sitio en https://contoso.sharepoint.com/sites/SearchSite que redirigirá cualquier solicitud a https://contoso.sharepoint.com/search.. Cualquier advertencia identificada por la Herramienta de diagnóstico de página será ignorada y se iniciará el intercambio. Sin embargo, cualquier error identificado por la Herramienta de diagnóstico de página evitará que se inicie el intercambio.

Parámetros

-ArchiveUrl

URL en la que se archivará el sitio de destino. Antes de realizar el intercambio, no debe haber ningún sitio existente en esta ubicación, ni siquiera un sitio eliminado en la papelera de reciclaje.

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

-DisableRedirection

Deshabilita la redirección del sitio para que no se cree en la ubicación de la URL de origen.

Type:Switch Parameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Force

Anula y omite cualquier advertencia que haya sido identificada por la Herramienta de diagnóstico de página que impida que se inicie el intercambio.

Por ejemplo, si recibe la advertencia "Invoke-SPOSiteSwap : Errors: 0; Advertencias: 1; Detalles: 2 elementos no están en la red CDN, habilite la red CDN." Las advertencias se pueden invalidar mediante este parámetro, pero los elementos deben revisarse y resolverse para obtener estabilidad y rendimiento a largo plazo.

Los errores identificados por la Herramienta de diagnóstico de página siempre evitarán que se inicie un intercambio independientemente de este parámetro.

Type:Switch Parameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-NoWait

Este parámetro está reservado para uso interno de Microsoft.

Type:Switch Parameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-SourceUrl

URL del sitio de origen. El sitio en esta ubicación debe existir antes de realizar el intercambio.

Si el destino es el sitio raíz en https://tenant-name.sharepoint.com, el sitio de origen debe ser un sitio de grupo moderno (STS#3) o un sitio de comunicación (SITEPAGEPUBLISHING#0) y la característica de publicación nunca se puede haber activado en el sitio de origen.

Si el destino es el sitio del centro de búsqueda en https://tenant-name.sharepoint.com/search, el sitio de origen debe ser un sitio de centro de búsqueda (SRCHCEN#0) o un sitio de centro de búsqueda básico (SRCHCENTERLITE#0).

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

-TargetUrl

URL del sitio de destino en el que se intercambiará el sitio de origen. El sitio en esta ubicación debe existir antes de realizar el intercambio.

El sitio de destino debe ser cualquiera de los dos:

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