Invoke-SPOSiteSwap
Invoca um trabalho para trocar o local de um site com outro site enquanto arquiva o site original.
Sintaxe
Default (Padrão)
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:
- O site raiz, por exemplo
https://tenant-name.sharepoint.com; ou - O site do centro de pesquisa, por exemplo
https://tenant-name.sharepoint.com/search.
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:
- Quaisquer links de destaque definidos na página inicial do SharePoint na
https://tenant-name.sharepoint.com/_layouts/15/sharepoint.aspxnã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. - 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.
- Os inquilinos maiores com mais de ~10.000 licenças terão de executar a Ferramenta de Diagnóstico de Página no site de origem (certifique-se de que o utilizador 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
Aplicável: SharePoint Online
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.
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DisableRedirection
Aplicável: SharePoint Online
Desabilita a criação do redirecionamento de site no local da URL de origem.
Propriedades do parâmetro
| Tipo: | Switch Parameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Aplicável: SharePoint Online
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 receber o aviso "Invoke-SPOSiteSwap: Errors: 0; Avisos: 1; Detalhes: 2 itens não estão na CDN, ative a CDN." Os avisos podem ser substituídos com este parâmetro, mas os itens devem ser revistos 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.
Propriedades do parâmetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-NoWait
Aplicável: SharePoint Online
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SourceUrl
Aplicável: SharePoint Online
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).
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TargetUrl
Aplicável: SharePoint Online
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:
- O site raiz em
https://tenant-name.sharepoint.comou - O site do centro de pesquisa em
https://tenant-name.sharepoint.com/search
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.