Restaurar: operação de Stsadm (Windows SharePoint Services)

Artigo
05/17/2012

Atualizado em: 2009-09-24

Nome da operação: Restore

Descrição

Quando o parâmetro –url é usado, é executada uma restauração do conjunto de sites. Entretanto, quando é usado o parâmetro –restoremethod, pode ser executada uma restauração individual de um banco de dados, aplicativo Web ou de todo o farm. Se você quiser substituir um conjunto de sites existente, use o parâmetro overwrite.

Sintaxe

Para restaurar o conjunto de sites

stsadm -o restore

** -url <Nome da URL>**

** -filename <nome do arquivo>**

** [-hostheaderwebapplicationurl] <URL do aplicativo Web>**

** [-overwrite]**

Para restauração de catástrofe

stsadm -o restore

** -directory <caminho UNC>**

** -restoremethod {overwrite | new}**

** [-backupid] <GUID do histórico de backup, consultar stsadm -help backuphistory>**

** [-item] <caminho criado na árvore>**

** [-percentage] <número inteiro entre 1 e 100>**

** [-showtree]**

** [-suppressprompt]**

** [-username] <nome do usuário>**

** [-password] <senha>**

** [-newdatabaseserver] <novo nome do servidor do banco de dados>**

** [-preservechangelog]**

** [-quiet]**

Parâmetros

Parâmetro	Valor	Obrigatório?	Descrição
url	Uma URL válida, como http://nome_server/sites/nome_site	Sim	Especifica a URL para a qual o backup do conjunto de sites deve ser restaurado.
filename	Um nome válido para cada arquivo de backup de conjunto de sites, como "Nome_site.bak"	Sim	Especifica o caminho e o nome do arquivo que contém o backup do conjunto de sites.
hostheaderwebapplicationurl	Uma URL válida atribuída ao aplicativo Web com o uso do Mapeamento de Acesso Alternativo (AAM), como "http://nome_do_servidor"	Não	Restaura um conjunto de sites como conjunto de sites com nome de host, e não baseado em caminho. Quando o parâmetro -hostheaderwebapplicationurl está presente, o valor do parâmetro -url é o conjunto de sites com nome de host e o valor do parâmetro -hostheaderwebapplicationurl é a URL do aplicativo Web que hospedará o conjunto de sites com nome de host.
overwrite	<nenhum>	Não	Substitui um conjunto de sites existente no momento no local especificado pelo parâmetro url pelo conjunto de sites armazenado no arquivo de backup.
directory	Um dos caminhos válidos: C:\nome_da_pasta \\nome_do_servidor\nome_da_pasta Observação: As pastas spbr* são criadas automaticamente.	Sim	O caminho onde o Windows SharePoint Services 3.0 armazena o pacote de backup catastrófico gerado durante a operação stsadm -o backup. É a pasta pai das pastas spbr. Se tiver um computador com o Microsoft SQL Server 2005 e uma instância do Windows SharePoint Services 3.0 instalados, você poderá usar caminhos de unidade locais. Isso pode incluir uma instalação básica. No entanto, se o SQL Server 2005 e o Windows SharePoint Services 3.0 estiverem instalados em vários computadores, você deverá usar caminhos de compartilhamento dentro da Convenção de Nomenclatura Universal (UNC) para que o banco de dados SQL e os componentes de pesquisa sejam lidos a partir do mesmo local (por exemplo, \\nome_computador\volume\Backup). Vários pacotes de backup podem ser armazenados no mesmo local. Esse é o mesmo caminho que você deve transmitir ao parâmetro -directory* da operação stsadm -o restore.
restoremethod	Um dos seguintes: overwrite new	Sim	Especifica o tipo de restauração de farm a ser executada; pode ser overwrite ou new. O valor overwrite restaura o conteúdo e as configurações para a localização original. Esse parâmetro deve ser usado apenas em uma restaruação catastrófica no mesmo farm. Se o valor overwrite for usado, um prompt de confirmação será exibido. Para suprimir o prompt, use o parâmetro suppressprompt. O valor new especifica que o conteúdo será restaurado para um novo local e deve ser usado em caso de restauração em um farm diferente (por exemplo, um novo servidor de banco de dados).
backupid	Um GUID válido, como "12345678-90ab-cdef-1234-567890abcdef"		O GUID do pacote de backup a ser restaurado. Cada pacote de backup tem um GUID exclusivo associado a ele e pode ser visto por meio da exibição do histórico de backup usando a operação stsadm -o backuphistory. Se esse parâmetro estiver ausente, será usado o pacote de backup mais recente.
item	Um item válido, como: Farm\Windows SharePoint Services	Não	Indica qual parte do farm deve ser restaurada. Você pode usar a notação de caminho completa do farm conforme exibido pelo parâmetro -showtree ou o nome do componente de destino no caminho se ele tiver um nome exclusivo. Coloque o item ou o caminho entre aspas duplas se ele contiver um espaço. Se esse parâmetro estiver ausente, todos os itens no pacote de backup serão restaurados.
percentage	Um valor inteiro entre 1 e 100. O valor padrão é 5.	Não	Solicita que as atualizações de progresso da operação Restore sejam exibidas em incrementos dessa porcentagem (por exemplo, um valor igual a “5” exibirá atualizações de progresso da restauração com 5% de conclusão, enquanto o valor "10" será exibido com 10% de conclusão). Observação: Essa porcentagem não é exata. As atualizações de progresso reais podem ser menores ou maiores do que o solicitado. Para um banco de dados muito grande, 1 é o valor ideal a ser usado para que algumas atualizações sejam exibidas. O valor padrão é 5.
showtree	<nenhum>	Não	Exibe quais itens no pacote de backup seriam restaurados com base em todos os outros parâmetros transmitidos para a operação stsadm -o restore Os itens que serão excluídos da restauração com base nos outros parâmetros transmitidos à operação Restore serão precedidos de um caractere de asterisco. Os itens que não puderem ser selecionados para restauração ficarão entre colchetes ([ ]). Uma restauração não será realizada se o parâmetro showtree estiver presente
suppressprompt	<nenhum>	Não	Impede a exibição do seguinte prompt da linha de comando: “Aviso: todos os itens selecionados serão substituídos. Deseja que eles sejam substituídos (S/N)?" Esse parâmetro é válido somente quando o valor do parâmetro restoremethod está definido como overwrite.
username	Um nome de usuário válido de autenticação do SQL no formato: nomedeusuário	Não	Define o mesmo nome do usuário para todos os objetos restaurados que exijam um nome do usuário, incluindo pools de aplicativos Web. Se um farm inteiro for restaurado, esse parâmetro só deverá ser usado por farms que utilizem a autenticação do Windows para se conectarem a um banco de dados. Se somente um banco de dados for restaurado, você poderá fornecer um nome de logon do SQL Server 2005.
password		Não	Define a mesma senha para todos os objetos restaurados que exijam uma senha, incluindo pools de aplicativos Web. Se um farm inteiro for restaurado, esse parâmetro só deverá ser usado por farms que utilizem a autenticação do Windows para se conectarem a um banco de dados. Se somente um banco de dados for restaurado, você poderá fornecer uma senha de logon do SQL Server 2005.
newdatabaseserver	Um nome de servidor de banco de dados válido, como "SQLBE1"	Não	Indica o nome da instância do SQL Server 2005 que deve ser usada ao restaurar bancos de dados quando o valor do parâmetro restoremethod for new. Esse parâmetro não é válido quando o valor do parâmetro restoremethod está definido como overwrite. Por padrão, você deve fornecer um novo nome de servidor de banco de dados para cada banco de dados.
preservechangelog	<nenhum>	Não	Preserva o log de alterações para que o próximo rastreamento desse banco de dados de conteúdo não seja completo. Esse parâmetro foi lançado pela primeira vez no Atualização de infraestrutura para o Windows SharePoint Services 3.0. Para obter mais informações, consulte Comentários.
quiet	<nenhum>	Não	Suprime a saída de informações de progresso da restauração para a janela de exibição. O status final da restauração (“Operação Bem-sucedida”) ainda será exibido. Se o parâmetro -quiet estiver ausente, a operação restore exibirá informações de progresso para a janela de exibição enquanto estiver restaurando o pacote.

Comentários

Se estiver executando o Atualização de infraestrutura para o Windows SharePoint Services 3.0, o identificador (ID) de cada banco de dados de conteúdo será mantido quando você restaurar ou reanexar o banco de dados, usando as ferramentas internas. O comportamento padrão de retenção do log de alterações, quando ferramentas internas são utilizadas, é o seguinte:

Os logs de alterações de todos os bancos de dados são mantidos quando você restaura um farm.
O log de alterações de um banco de dados de conteúdo é mantido quando você reanexa o banco de dados.
O log de alterações de um banco de dados de conteúdo NÃO é retido quando você restaura somente o banco de dados de conteúdo. Ele é retido no caso de você usar o parâmetro preservechangelog.

Quando um ID de banco de dados e o log de alterações são mantidos, o recurso Pesquisar continua o rastreamento com base na programação regular definida pelas regras de rastreamento. Quando um log de alterações não é mantido, o recurso Pesquisar executa um rastreamento completo durante o próximo rastreamento programado.

Para obter mais informações, consulte Mover bancos de dados de conteúdo (Windows SharePoint Services 3.0) e Back up and restore the entire farm (Windows SharePoint Services 3.0 technology).

Quando você restaura um banco de dados existente e não usa o parâmetro –restoremethod com a opção overwrite e a operação stsadm –o restore, uma nova ID é atribuída ao banco de dados restaurado, e o log de alteração do banco de dados não é preservado. O próximo rastreamento do banco de dados indexará completamente o banco de dados de conteúdo.

Se uma restauração for realizada e a ID do pacote de backup já estiver em uso no farm (por exemplo, se você estiver tentando dividir um banco de dados em dois), uma nova ID será atribuída ao banco de dados restaurado e um aviso será adicionado ao log de restauração. A capacidade de realizar um rastreamento incremental, em vez de um completo, depende da ID do banco de dados de conteúdo ser a mesma de antes e de o token do log de alterações usado pela pesquisa ser válido para o log de alterações atual no banco de dados de conteúdo. Se o log de alterações não for preservado, o token não será válido e a pesquisa precisará realizar um rastreamento completo.