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/testsiteEste 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 -VersionUpgradeEste 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 |
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 |