Personalizações de backup no SharePoint Server

Artigo
05/31/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

Você pode fazer o backup das personalizações realizadas nos sites SharePoint Server usando o site da Administração Central do SharePoint ou o Microsoft PowerShell. A ferramenta de backup usada depende do tipo de ambiente implantado, do agendamento exigido pelo backup e dos acordos de nível de serviço feitos com a organização.

Antes de começar

Antes de começar essa operação, revise a lista de possíveis personalizações que você pode fazer em seus sites:

Personalizações fornecidas como soluções (arquivos .wsp). As soluções contêm elementos de site desenvolvidos e, geralmente, são criadas por desenvolvedores. Os elementos de site desenvolvidos incluem:
- Web Parts
- Fluxos de trabalho
- Definições de site e de lista
- Conversores de documentos
- Receptores de eventos
- Trabalhos de timer
- Assemblies
Os elementos de site criados, normalmente criados por web designers, não são explicitamente compilados e estão localizados numa base de dados de conteúdos. Os elementos do site criado incluem o seguinte:
- Páginas mestras
- Folhas de estilo em cascata
- Formulários
- Páginas de layout
Alterações no arquivo Web.config
Soluções de terceiros e os respectivos arquivos binários e chaves de Registro associados, como IFilters
Alterações nos sites criados editando diretamente pelo navegador
Personalizações desenvolvidas que não são empacotadas como soluções

Observação

Cada um desses tipos de personalização exige um tipo diferente de backup.

Backup de pacotes de solução no SharePoint Server

Pacotes de solução podem ser criados usando o SharePoint Designer ou Visual Studio. É altamente recomendável que todas as personalizações sejam implantadas como pacotes de solução. Para saber mais, veja Criando pacotes de solução do SharePoint.

Um pacote de solução é um arquivo implantável e reutilizável que pode conter um conjunto de recursos, definições de site e assemblies aplicáveis a sites, e que você pode habilitar ou desabilitar individualmente. Pacotes de solução podem incluir Web Parts, definições de sites ou listas, colunas personalizadas, novos tipos de conteúdo, campos personalizados, ações personalizadas, fluxos de trabalho codificados ou atividades e condições de fluxo de trabalho.

O método a usar para fazer backup de pacotes de solução é determinado pela maneira como as personalizações são implantadas: como soluções confiáveis ou como soluções em área restrita (código parcialmente confiável).

Soluções confiáveis são pacotes de solução implantados por administradores de farm. As soluções confiáveis são implantadas em todo o farm e podem ser usadas em qualquer site do farm. Elas são armazenadas no banco de dados de configurações. O backup das soluções confiáveis é feito junto com o do farm, usando o backup do SharePoint Server, e elas são incluídas nos backups somente de configuração. Também é possível fazer o backup de soluções confiáveis como um grupo ou individualmente. As soluções confiáveis são visíveis na hierarquia de backups.

Soluções em área restrita são pacotes de solução que podem ser implantados por administradores de conjuntos de sites em um único conjunto de sites. As soluções em área restrita são armazenadas no banco de dados de conteúdo associado ao conjunto de sites no qual os pacotes de solução foram implantados. 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 cópias de segurança e não podem ser selecionadas ou criadas cópias de segurança individualmente.

Recomendamos manter um backup do arquivo .wsp original e do código fonte usado para criar o arquivo .wsp para soluções confiáveis e em modo seguro.

Para fazer backup de soluções confiáveis usando o Administração Central

Verifique se a conta do usuário que está executando esse procedimento é membro do grupo Administradores de Farm.
Inicie a Administração Central.
Na página inicial da Administração Central, na seção Backup e Restauração, clique em Executar um backup.
Na página Executar um Backup Etapa 1 de 2: Selecionar Componente para Backup, selecione Soluções, depois clique em Avançar.

Também é possível selecionar uma solução individual, caso queira fazer o backup somente de uma solução.
Na página Iniciar Backup Etapa 2 de 2: Selecionar Opções de Backup, na seção Tipo de Backup, selecione Completo ou Diferencial.

Observação

[!OBSERVAçãO] Se estiver fazendo o backup da solução pela primeira vez, use a opção Completo. É preciso executar um backup completo antes de poder executar um backup diferencial.
Na seção Local do Arquivo de Backup, digite o caminho UNC (Convenção de Nomenclatura Universal) da pasta de backup e clique em Iniciar backup.
Você pode visualizar o status geral de todos os trabalhos de backup na parte superior da página Status do Trabalho de Backup e Restauração, na seção Preparação. Você pode visualizar o status do trabalho de backup atual na parte inferior da página, na seção Backup. A página de status é atualizada automaticamente a cada 30 segundos. 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. Portanto, pode levar vários segundos para começar o backup.

Se você receber algum erro, analise-o na coluna Mensagem de Falha da página Status do Trabalho de Backup e Restauração. Mais detalhes podem ser encontrados no arquivo Spbackup.log, no caminho UNC especificado na etapa 4.

Para fazer backup de soluções confiáveis 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.
- Grupos de administradores no servidor no qual está a executar os cmdlets do PowerShell.
Um administrador pode usar o cmdlet Add-SPShellAdmin para conceder permissões para usar cmdlets SharePoint Server.

Observação

Se você não possui permissões, entre em contato com seu administrador de Configuração ou o administrador do SQL Server para solicitar permissões. Para obter mais informações sobre as permissões do PowerShell, veja Add-SPShellAdmin.
Inicie o Shell de Gerenciamento do SharePoint.
No prompt de comando do PowerShell digite o comando a seguir para fazer backup de todas as soluções no farm. Para fazer backup de uma única solução, adicione o nome da solução ao caminho do item "farm\solutions".
```
Backup-SPFarm -backupmethod full -directory <UNC location> -item "farm\solutions"
```
Em que:
- O <UNC location> é o local UNC da pasta onde você armazena o arquivo de backup.

Para maiores informações, consulte Backup-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.

Backup de soluções em modo seguro no SharePoint Server

Não pode criar cópias de segurança apenas de soluções em sandbox. É preciso fazer o backup do farm, aplicativo da web ou banco de dados de conteúdo ao qual a solução em modo seguro está associada.

Backup de elementos de site criados no SharePoint Server

Não pode fazer uma cópia de segurança apenas dos elementos do site criados. É preciso fazer o backup do farm, aplicativo da web ou banco de dados de conteúdo ao qual os elementos de site criados estão associados.

Backup de fluxos de trabalho no SharePoint Server

Fluxos de trabalho são um caso especial de personalização que você pode incluir no backup. Confirme se o seu plano de recuperação e backup abrange algum dos seguintes cenários que se aplicam ao seu ambiente:

Os fluxos de trabalho declarativos, como os que foram criados no SharePoint Designer, são armazenados na base de dados de conteúdos da coleção de sites na qual são implementados. Fazer backup do banco de dados de conteúdo protege esses 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 (. Os ficheiros ACTIONS) são armazenados no diretórioLCID>\Workflow 16\TEMPLATE<.
- Uma entrada XML para marcar a ação como um tipo autorizado é armazenada no ficheiro Web.config das aplicações Web em que é utilizada.
  
  Se os fluxos de trabalho do farm usam ações personalizadas, é preciso usar um sistema de backup de arquivo para proteger esses arquivos e entradas XML. Semelhantes a recursos como Web Parts e receptores de evento, esses arquivos devem ser novamente aplicados ao farm após a recuperação, conforme necessário.
Os fluxos de trabalho que dependem de código personalizado, como os criados usando o Visual Studio, são armazenados em dois locais. Os assemblies do Visual Studio do fluxo de trabalho são armazenados no GAC, e os arquivos de definição XML são armazenados no diretório Recursos. Este é igual aos outros tipos de recursos do SharePoint, como Web Parts e receptores de evento. Se o fluxo de trabalho tiver sido instalado como parte de um pacote de solução, o backup do farm, do aplicativo Web, do banco de dados de conteúdo ou do conjunto de sites protegerá esses fluxos de trabalho.
Se você criar um fluxo de trabalho personalizado que interaja com um conjunto de sites diferente daquele no qual o fluxo de trabalho foi implantado, faça backup dos dois conjuntos de sites para proteger o fluxo de trabalho. Isso inclui fluxos de trabalho que são gravados em uma lista de histórico ou outra lista personalizada em outro conjunto de sites. Executar um backup de farm é suficiente para fazer backup de todos os conjuntos de sites do farm e todos os fluxos de trabalho que estão associados eles.
Os fluxos de trabalho que ainda não estão implementados têm de ser efetuados em cópia de segurança e restaurados separadamente. Quando estiver a desenvolver um novo fluxo de trabalho, mas ainda não o tiver implementado no farm do SharePoint Server, certifique-se de que faz uma cópia de segurança da pasta onde armazena os ficheiros do projeto de fluxo de trabalho através de uma aplicação de cópia de segurança do sistema de ficheiros.

Backup de alterações no arquivo Web.config no SharePoint Server

Uma personalização comum do SharePoint Server é a alteração no arquivo Web.config. É altamente recomendável fazer alterações no arquivo Web.config usando a Administração Central ou as APIs e o modelo de objeto do SharePoint Server. Como essas alterações são armazenadas no banco de dados de configuração, elas podem ser recuperadas de um backup de farm ou somente de configuração.

As alterações ao ficheiro de Web.config que não são efetuadas através da Administração Central ou das APIs do SharePoint Server e do modelo de objeto devem ser protegidas através de uma cópia de segurança do sistema de ficheiros.

Observação

[!OBSERVAçãO] Se você estiver usando autenticação baseada em formulários, o registro de provedor no arquivo Web.config será manual e não estará protegido por backup do SharePoint Server. Neste caso, certifique-se de fazer backup do arquivo Web.config usando um backup de sistema de arquivos.

Backup de produtos de terceiros no SharePoint Server

Se os produtos de terceiros forem implementados como pacotes de soluções, serão protegidos pela cópia de segurança do SharePoint Server. Recomendamos manter todos os arquivos originais, mídia de distribuição, documentação, além de licença e chaves do produto necessárias para a instalação.

Criar cópias de segurança de personalizações desenvolvidas que não são empacotadas como soluções no SharePoint Server

Criar cópias de segurança de personalizações desenvolvidas que não são implementadas como pacotes de soluções pode ser um processo complexo, porque as localizações de ficheiros de personalização podem não ser armazenadas em locais padronizados e o SharePoint Server não faz uma cópia de segurança automática das mesmas.

Entre em contato com a equipe de desenvolvimento ou o fornecedor da personalização para determinar se as personalizações envolvem software suplementar ou arquivos em outros locais. Recomendamos fazer backup desses diretórios com uma solução de backup de sistema de arquivos. A tabela abaixo lista os locais nos quais as personalizações desenvolvidas são geralmente armazenadas em servidores 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