Upgrade-SPSite
Inicia o processo de atualização em um conjunto de sites.
Sintaxe
Default (Padrão)
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 numa coleção 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 predefinição, o Upgrade-SPSite cmdlet funciona como uma atualização de 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/sites/nome> do https://< site existente através da utilização apenas das ações de atualização de compilação para compilação disponíveis que estão associadas ao modo operacional da 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/sites/nome> do https://< site existente através de todas as ações de atualização de compilação para compilação disponíveis que estão associadas ao modo operacional da coleção de sites atual e efetua uma atualização versão a 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 colocar o site na fila para uma atualização atrasada que é gerida por uma tarefa de temporizador.
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 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.