Compartilhar via


Upgrade-SPSite

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 uma coleção de sites.

O Upgrade-SPSite cmdlet ativa o processo de atualização do 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 build-to-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 a coleção de sites de https:// site>/sites/testsite existente< usando apenas ações de atualização de build a build disponíveis que estão associadas ao modo operacional de coleção 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 a coleção de sites de https://> site/sites/testsite existente< usando todas as ações de atualização de build a build disponíveis que estão associadas ao modo operacional da coleção de sites atual e executa uma atualização versão a versão.

Parâmetros

-AssignmentCollection

Gerencia objetos para o devido descarte. 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. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.

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

-Confirm

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

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

Type:SPSitePipeBind
Position:1
Default value:None
Required:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-QueueOnly

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

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

-Unthrottled

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
Required:False
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
Required:False
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 executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

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