Upgrade-SPSite
Inicia o processo de atualização em um conjunto de sites.
Sintaxe
Default (Default)
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://< nome>/sites/testsite existente usando apenas ações de atualização de compilação para compilação 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:// nome>/<sites/testsite existente usando todas as ações de atualização de compilação 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
Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | SPAssignmentCollection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Solicita sua confirmação antes de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
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 |
Aplicável: 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.
Propriedades do parâmetro
| Tipo: | 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 |
-Identity
Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o objeto SPSite para executar operações de atualização.
Propriedades do parâmetro
| Tipo: | SPSitePipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Priority
Aplicável: SharePoint Server 2016, SharePoint Server 2019
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)
Propriedades do parâmetro
| Tipo: | Byte |
| 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 |
-QueueOnly
Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica para colocar o site na fila para uma atualização atrasada que é gerenciada por um trabalho de timer.
Propriedades do parâmetro
| Tipo: | 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 |
-Unthrottled
Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | 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 |
-VersionUpgrade
Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | 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 |
-WhatIf
Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
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 |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.