Invoke-SPOSiteSwap

  • Referência
Módulo:
Microsoft.Online.SharePoint.PowerShell
Aplica-se a:
SharePoint Online

Invoca um trabalho para trocar o local de um site com outro site enquanto arquiva o site original.

Syntax

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

Description

Permuta o local de um site de origem por um site de destino ao arquivar o site de destino original.

Observe que o site de destino deve ser:

Quando a troca é iniciada, o site de destino é movido para o local de arquivamento e o site de origem é movido para o local de destino. Por padrão, um redirecionamento de site é criado no local de origem, que redirecionará o tráfego para o local de destino.

Se o destino for o site raiz no https://tenant-name.sharepoint.com, as seguintes atividades de preparação devem ser executadas antes de executar a troca:

  1. Quaisquer links de destaque definidos na página inicial do SharePoint na https://tenant-name.sharepoint.com/_layouts/15/sharepoint.aspx não serão exibidos após a mudança. Se necessário, os links de destaque devem ser documentados para que possam ser recriados manualmente após a troca.
  2. Funcionalidade como compartilhamento externo e interfaces de aplicativos dependem das políticas e permissões definidas no site raiz. Examine o site de origem para garantir que ele tenha as políticas e permissões necessárias conforme o site raiz existente. Isso inclui configurações de compartilhamento externo e permissões de site.
  3. Locatários maiores que têm mais de ~10.000 licenças precisarão executar a Ferramenta de Diagnóstico de Página no site de origem (verifique se o usuário que executa a Ferramenta de Diagnóstico de Página tem direitos de edição no site de origem). Quaisquer resultados de análise que tenham a categoria Atenção necessária (Vermelho) ou oportunidades de melhoria (Laranja) precisarão ser remediados antes de realizar a troca.

Os sites de origem e destino não podem ser conectados a um grupo do Office 365. Eles também não podem ser sites do hub ou associados a um Hub. Se um site for um Hub, cancele o registro dele como um Hub, troque o site raiz e registre o site como um Hub. Se um site estiver associado a um Hub, desassocie o site, troque-o e, em seguida, reassocie o site.

Se o recurso De publicação tiver sido ativado anteriormente ou ativado no site de origem, o Invoke-SPOSiteSwa não poderá ser usado.

Exemplos

EXEMPLO 1

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

Arquiva o site existente em https://contoso.sharepoint.com para https://contoso.sharepoint.com/sites/Archive e move https://contoso.sharepoint.com/sites/CommunicationSite para https://contoso.sharepoint.com.. Um redirecionamento do site será criado em https://contoso.sharepoint.com/sites/CommunicationSite que redirecionará quaisquer solicitações para https://contoso.sharepoint.com.

EXEMPLO 2

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

Arquiva o site existente do Centro de Pesquisa em https://contoso.sharepoint.com/search para https://contoso.sharepoint.com/sites/Archive e move o https://contoso.sharepoint.com/sites/SearchSite para https://contoso.sharepoint.com/search.. Um redirecionamento do site será criado em https://contoso.sharepoint.com/sites/SearchSite que redirecionará quaisquer solicitações para https://contoso.sharepoint.com/search.

EXEMPLO 3

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

Arquiva o site existente em https://contoso.sharepoint.com para https://contoso.sharepoint.com/sites/Archive e move https://contoso.sharepoint.com/sites/CommunicationSite para https://contoso.sharepoint.com.. Um redirecionamento do site não será criado em https://contoso.sharepoint.com/sites/CommunicationSite.

EXEMPLO 4

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

Arquiva o site existente do Centro de Pesquisa em https://contoso.sharepoint.com/search para https://contoso.sharepoint.com/sites/Archive e move o https://contoso.sharepoint.com/sites/SearchSite para https://contoso.sharepoint.com/search.. Um redirecionamento do site será criado em https://contoso.sharepoint.com/sites/SearchSite que redirecionará quaisquer solicitações para https://contoso.sharepoint.com/search. Quaisquer avisos identificados pela Ferramenta de Diagnóstico de Página serão ignorados e a troca será iniciada. No entanto, os erros identificados pela Ferramenta de diagnóstico de página ainda impedirão o início da troca.

Parâmetros

-ArchiveUrl

A URL para a qual o site de destino será arquivado. Não deve haver sites existentes, incluindo um site excluído na lixeira, neste local antes de executar a troca.

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

-DisableRedirection

Desabilita a criação do redirecionamento de site no local da URL de origem.

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

-Force

Substitui e ignora todos os avisos identificados pela Ferramenta de diagnóstico de página que impede o início da troca.

Por exemplo, se você receber o aviso "Invoke-SPOSiteSwap : Errors: 0; Avisos: 1; Detalhes: 2 itens não estão na CDN, habilite a CDN." Os avisos podem ser substituídos usando esse parâmetro, mas os itens devem ser revisados e resolvidos para estabilidade e desempenho a longo prazo.

No entanto, os erros identificados pela Ferramenta de diagnóstico de página ainda impedirão o início da troca independentemente do seu 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

Esse parâmetro está reservado para uso interno da 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 do site de origem. O site deve existir neste local antes de executar a troca.

Se o alvo for o site raiz em https://tenant-name.sharepoint.com, então o site de origem deve ser um Site de Equipe Moderno (STS#3) ou um site de comunicação (SITEPAGEPUBLISHING#0) e o recurso de publicação não pode ter sido ativado no site de origem.

Se o destino for o site do centro de pesquisa no https://tenant-name.sharepoint.com/search, o site de origem deve ser um site do centro de pesquisa (SRCHCEN#0) ou um site do centro de pesquisa 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

A URL do site de destino para o qual o site de origem será trocado. O site deve existir neste local antes de executar a troca.

O site de destino deve ser:

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