Restaurar personalizações no SharePoint Server

Artigo
07/06/2024

APLICA-SE A: yes-img-13 2013 yes-img-16 2016 yes-img-19 2019 yes-img-se Subscription Edition no-img-sop SharePoint no Microsoft 365

É possível restaurar qualquer personalização realizada no SharePoint Server usando o Administração Central ou o PowerShell. A ferramenta de restauração que você usa depende do tipo de ambiente que você implantou, seus requisitos de programação e quais os contratos de nível de serviço realizados em sua organização.

Antes de começar

Antes de começar essa operação, revise as informações a seguir:

Recomendamos que você mantenha um backup do arquivo .wsp original e o código fonte usado para compilar o arquivo .wsp para soluções alternativas e personalizadas.

Restaurando pacotes de solução no SharePoint Server

O método usado para restaurar pacotes de solução é determinado pelas personalizações onde implantados como soluções confiáveis ou soluções alternativas.

As soluções fidedignas são soluções implementadas pelos administradores do farm. São implementados no farm completo e podem ser utilizados em qualquer site dentro do farm. Elas são armazenadas no banco de dados de configurações. São criadas cópias de segurança de soluções fidedignas quando é efetuada uma cópia de segurança de um farm através da cópia de segurança do SharePoint Server e são incluídas em cópias de segurança apenas de configuração e também podem ser criadas cópias de segurança como um grupo ou individualmente. Estão visíveis na hierarquia de restauro.

As soluções em sandbox são soluções que os administradores da coleção de sites podem implementar numa única coleção de sites. As soluções em sandbox são armazenadas na base de dados de conteúdos associada à coleção de sites na qual estão implementadas. Estão incluídas no farm do SharePoint Server, na aplicação Web, na base de dados de conteúdos e nas cópias de segurança da coleção de sites, mas não estão visíveis na hierarquia de restauro e não podem ser selecionadas ou restauradas individualmente.

Para restaurar uma solução confiável usando a Administração Central

Verifique se a conta de usuário que está executando esse procedimento é membro do grupo Administradores de Farm do SharePoint.
Inicie a Administração Central.
No Administração Central, na página inicial, na seção Backup e Restauração, clique em Restaurar de um backup.
Na página Restaurar do Backup - Etapa 1 de 3: Selecionar Backup a ser Restaurado, na lista de backups, selecione o trabalho de backup que contém o pacote de soluções e clique em Avançar. Também é possível ver mais detalhes sobre cada backup clicando em (+) próximo ao backup.

Observação

[!OBSERVAçãO] Se o trabalho de backup correto não for exibido, na caixa de texto Local do diretório de backup, digite o caminho UNC da pasta de backup correta e clique em Atualizar.
Na página Restaurar do Backup - Etapa 2 de 3: Selecionar Componente para Restaurar, marque a caixa de seleção próxima à solução e clique em Avançar.
Na página Restaurar do Backup - Etapa 3 de 3: Selecionar Opções de Restauração, na seção Restaurar componente, certifique-se de que Solução; aparece na lista Restaurar o seguinte componente.

Na seção Restaurar apenas definições de configuração, certifique-se de que a opção Restaurar definições de configuração e conteúdo está selecionada.

Na seção Opções de restauração, em Tipo de restauração, selecione a opção Mesma configuração. É apresentada uma caixa de diálogo que lhe pede para confirmar a operação. Clique em OK.

Clique em Iniciar restauração.
É possível exibir o status geral de todos os trabalhos de recuperação na parte superior da página Status do Backup e da Restauração na seção Preparação. Você pode exibir o status do trabalho de recuperação atual na parte inferior da página na seção Restaurar. A página de status é atualizada a cada 30 segundos automaticamente. Você pode atualizar os detalhes do status manualmente clicando em Atualizar. O backup e a recuperação são trabalhos do serviço de timer. Por isso, a recuperação pode levar alguns instantes para ser iniciada.

Se você receber algum erro, pode revisá-lo na coluna Mensagem de Falha da página Status do trabalho de backup e restauração. Também é possível encontrar mais detalhes no arquivo Sprestore.log no caminho UNC especificado na etapa 3.

Para restaurar uma solução confiável usando o PowerShell

Verifique se você possui as seguintes associações:
- A função de servidor fixa securityadmin na instância do SQL Server.
- A função de banco de dados fixa db_owner em todos os bancos de dados que devem ser atualizados.
- O grupo de administradores no servidor no qual você está executando os cmdlets do PowerShell.
  
  Um administrador pode usar o cmdlet Add-SPShellAdmin para conceder permissões para usar cmdlets SharePoint Server.
Observação

[!OBSERVAçãO] Se você não possui permissões, entre em contato com o Administrador da instalação ou com o administrador do SQL Server para solicitar permissões. Para mais informações sobre as permissões do PowerShell, consulte Add-SPShellAdmin.
Inicie o Shell de Gerenciamento do SharePoint.
No prompt de comando do PowerShell, digite o seguinte comando:
```
Restore-SPFarm -Directory <BackupFolder> -RestoreMethod Overwrite -BackupId <GUID> -Item <SolutionPath>
```
Em que:
- <BackupFolder> é o local UNC do diretório que você deseja restaurar.
- <GUID> é o GUID da ID de backup que você deseja restaurar. Se você não especificar um backup, o mais recente é usado.
- <SolutionPath> é o caminho da solução na árvore de cópias de segurança (normalmente farm\solutions\ SolutionName).

Para saber mais, confira Restore-SPFarm.

Observação

Recomendamos que você use o Windows PowerShell ao executar tarefas administrativas de linha de comando. A ferramenta de linha de comando Stsadm está obsoleta, mas está incluída para oferecer suporte à compatibilidade com versões anteriores do produto.

Restaurar uma solução alternativa

Não é possível restaurar apenas personalizações implantadas como soluções alternativas. Ao invés disso, você deve restaurar o farm, aplicativo Web, banco de dados de conteúdo ou conjunto de sites nos quais a personalização está associada.

Restaurando elementos do site de autoria no SharePoint Server

Não é possível restaurar apenas elementos de site de autoria. Ao invés disso, você deve restaurar o farm, aplicativo Web ou banco de dados de conteúdo no qual o elemento do site de autoria é associado.

Restaurando fluxos de trabalho no SharePoint Server

Fluxos de trabalho são um caso especial de personalizações que você pode restaurar. Certifique-se de que o plano de backup e recuperação inclui qualquer cenário aplicado ao seu ambiente.

Fluxos de trabalho declarativos, como aqueles criados no SharePoint Designer, são armazenados no banco de dados de conteúdo para o conjunto de sites no qual eles são implantados. A restauração do banco de dados de conteúdo ou conjunto de sites restaura estes fluxos de trabalho.
As ações personalizadas de fluxo de trabalho declarativo têm componentes nos três seguintes locais:
- Os assemblies do Visual Studio 2013 para as ações são armazenados no cache de assembly global (GAC).
- Os ficheiros de definição XML (ficheiros.actions) são armazenados no diretório 16\TEMPLATE<LCID>\Workflow.
- Uma entrada XML para marcar a ação como um tipo autorizado armazenado no arquivo Web.config para os aplicativos da Web nos quais foram usados.
  
  Se os fluxos de trabalho do farm usam ações personalizadas, você deve usar um sistema de restauração de arquivos para restaurar esses arquivos e entradas XML. É possível reaplicar estes arquivos conforme necessário após a recuperação.
Os fluxos de trabalho que dependem de código personalizado, como os que são criados com o Visual Studio 2013, são armazenados em duas localizações. As assemblagens do Visual Studio 2013 para o fluxo de trabalho são armazenadas no GAC e os ficheiros de definição XML são armazenados no diretório Funcionalidades. Isto é o mesmo que outros tipos de funcionalidades do SharePoint Server, como Peças Web e recetores de eventos. Se o fluxo de trabalho tiver sido instalado como parte de um pacote de solução, siga as instruções para restaurar pacotes de soluções.
Se você criar um fluxo de trabalho personalizado que interage com um conjunto de sites diferente daquele onde o fluxo de trabalho é implantado, você deve restaurar os conjuntos de site para recuperar o fluxo de trabalho. Restaurar um farm é suficiente para recuperar todos os conjuntos de site no farm e todos os fluxos de trabalho associados a eles.
Fluxos de trabalho não implantados devem ser restaurados separadamente usando um aplicativo de backup do sistema de arquivos.

Restaurar alterações no arquivo Web.config no SharePoint Server

É possível recuperar alterações feitas ao arquivo Web.config usando o Administração Central ou APIs do SharePoint Server e modelo de objeto realizando uma restauração de farm ou somente de configuração.

Você deve usar um backup do sistema de arquivos para proteger as mudanças do arquivo Web.config não realizadas usando o Administração Central ou os APIs do SharePoint e o modelo de objeto. É possível recuperar o backup usando uma restauração do sistema de arquivos.

Restaurando personalizações desenvolvidas não embaladas como soluções no SharePoint Server

Restaurar personalizações desenvolvidas não embaladas como soluções pode ser um processo complexo porque os locais do arquivo de personalização não são padronizados.

Consulte a equipe de desenvolvimento ou o fornecedor de personalizações para determinar se as personalizações envolvem software de complemento adicional ou arquivos em outros locais. Recomendamos que você restaure diretórios com uma solução de restauração do sistema de arquivos. A tabela a seguir lista os locais onde as personalizações são geralmente armazenadas nos servidores da Web.

Localidade	Descrição
%PROGRAMFILES%\Common files\Microsoft Shared\Web Server Extensions\16	Arquivos comumente atualizados, assemblies personalizados, modelos personalizados, definições de sites personalizadas
Inetpub	Local dos diretórios virtuais do IIS
%WINDIR%\Assembly	GAC: um local protegido do sistema operacional onde os assemblies de código do Microsoft .NET Framework estão instalados para prover acesso total ao sistema