Upgrade-SPSite

Referência

Módulo:: SharePointServer

Aplica-se a:: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Inicia o processo de atualização em um conjunto de sites.

Syntax

Upgrade-SPSite
       [-Identity] <SPSitePipeBind>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Email]
       [-QueueOnly]
       [-Unthrottled]
       [-VersionUpgrade]
       [-WhatIf]
       [-Priority <Byte>]
       [<CommonParameters>]

Description

O Upgrade-SPSite cmdlet inicia o processo de atualização em um conjunto de sites.

O Upgrade-SPSite cmdlet ativa o processo de atualização para o objeto SPSite especificado. Também é possível usar este cmdlet para retomar atualizações em falha. Quando você usar este cmdlet para iniciar a atualização em um objeto SPSite, o objeto pode ser uma atualização de compilação ou versão.

Por padrão, o Upgrade-SPSite cmdlet opera como uma atualização de build para build. Isto evita que atualizações de versão inesperadas de conjuntos de site se você usar este cmdlet após uma operação de correção. No modo de atualização de versão para versão, são executadas verificações de integridade do conjunto de sites no modo de reparo para garantir que o conjunto de sites esteja íntegro o suficiente para ser atualizado com êxito. Se houver êxito, ocorre um lembrete da atualização.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

-------------EXEMPLO 1----------

Upgrade-SPSite https://<site name>/sites/testsite

Este exemplo atualiza o conjunto de sites https://<site name>/sites/testsite usando apenas ações de atualização de build para build disponíveis associadas ao modo de operação do conjunto de sites atual. O SPSite.CompatibilityLevel não será alterado por esta operação.

-------------EXEMPLO 2----------

Upgrade-SPSite https://<site name>/sites/testsite -VersionUpgrade

Este exemplo atualiza o conjunto de sites https://<site name>/sites/testsite existente usando todas as ações de atualização de build para compilação disponíveis associadas ao modo de operação do conjunto de sites atual e executa uma atualização de versão para versão.

Parâmetros

-AssignmentCollection

Gerencia objetos para fins de descarte adequado. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

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

-Confirm

Solicita a sua confirmação antes de executar o comando. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Email

Especifica se deve enviar um email na conclusão da atualização do conjunto de sites.

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

-Identidade

Especifica o objeto SPSite para executar operações de atualização.

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

-Priority

Especifica qual é a prioridade de atualização do site.

Os valores válidos são:

128 - 255 (Prioridade Baixa)
11 - 127 (Prioridade Normal)
0 - 10 (Prioridade Alta)

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

-QueueOnly

Especifica colocar o site na fila para uma atualização atrasada gerenciada por um trabalho de temporizador.

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

-Sem problemas

Especifica um administrador de farm para passar a aceleração que permite a atualização de um conjunto de sites, mesmo se houverem "muitos" conjuntos de site na aceleração para ser atualizado.

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

-VersionUpgrade

Especifica a realização de uma atualização de versão no objeto SPSite. Quando este parâmetro está definido, dispara internamente todas as ações de compilação disponíveis associadas com o modo operacional do conjunto de sites atual. As ações de versão começam a trazer os conjuntos de site para o próximo modo operacional do conjunto de sites de todas as novas ações de compilação associadas com o novo modo operacional do conjunto de sites. Quando este parâmetro não está definido, dispara apenas ações de atualização de compilação disponível associadas com o modo operacional do conjunto de sites atual.

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

-WhatIf

Exibe uma mensagem que descreve o efeito do comando em vez de executá-lo. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019