Restore: operação do Stsadm (Office SharePoint Server)

Artigo
06/12/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 de backuphistory, consulte stsadm -help backuphistory>**

** [-item] <caminho criado da á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_do_servidor/sites/nome_do_site	Sim	Especifica a URL para a qual o backup do conjunto de sites deve ser restaurado.
filename	Um nome de arquivo válido para o arquivo de restauração do conjunto de sites, como "Nome_do_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 um conjunto de sites nomeado pelo host, e não baseado em caminho. Quando o parâmetro -hostheaderwebapplicationurl está presente, o valor do parâmetro -url é a URL do conjunto de sites nomeado pelo host, e o valor do parâmetro -hostheaderwebapplicationurl é a URL do aplicativo Web que hospedará o conjunto de sites nomeado pelo 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 Microsoft Office SharePoint Server 2007 armazena o pacote de backup catastrófico gerado durante a operação stsadm -o backup. É a pasta pai das pastas spbr. Se você tiver um computador com o Microsoft SQL Server 2005 e uma instância do Office SharePoint Server 2007 instalados, poderá usar caminhos de unidade local. Isso incluiria uma instalação básica. No entanto, se o SQL Server 2005 e o Office SharePoint Server 2007 estiverem instalados em vários computadores, você deverá usar caminhos de compartilhamento UNC (Convenção de Nomenclatura Universal) de forma que o banco de dados SQL e os componentes de pesquisa sejam lidos do mesmo local (por exemplo, \\nome_do_computador\volume\Backup). Vários pacotes de backup podem ser armazenados no mesmo local. Esse será o mesmo caminho para o qual você passaria o 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 de overwrite restaura o conteúdo e as configurações para o local original. Esse parâmetro deve ser usado somente em uma restauração de catástrofe no mesmo farm. Se o valor overwrite for usado, um prompt de confirmação será exibido. Para não exibir o prompt, use o parâmetro suppressprompt. O valor new especifica que o conteúdo será restaurado para um novo local e que deve ser usado na restauração para 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: Aplicativo Web\SharePoint-80	Não	Indica qual parte do farm deve ser restaurada. Você pode usar a notação de caminho completa do farm exibida 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" exibirá 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 do pacote de backup devem ser restaurados com base em todos os outros parâmetros passados para a operação stsadm -o restore Os itens que serão excluídos da restauração com base em outros parâmetros passados para a operação Restore serão precedidos de um asterisco (). Os itens que não puderem ser restaurados 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 de 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 usando o SQL Server 2005. 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 para restaurar bancos de dados quando o valor do parâmetro restoremethod for new. Esse parâmetro não será válido quando o valor do parâmetro restoremethod for 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 os Microsoft Office Servers. 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 os Microsoft Office Servers, 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 as 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 uma ID de banco de dados e o log de alterações são mantidos, o recurso Pesquisar continua o rastreamento com base no agendamento regular definido 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 agendado.

Para obter mais informações, consulte Mover os bancos de dados de conteúdo (Office SharePoint Server 2007) e Fazer backup e restaurar um farm inteiro (Office SharePoint Server 2007).

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 sendo usada 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 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.