Restore-SPFarm

Referência

Módulo:: SharePointServer

Aplica-se a:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Restaura um ou mais itens de um backup.

Syntax

Restore-SPFarm
       -Directory <String>
       -RestoreMethod <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-BackupId <Guid>]
       [-ConfigurationOnly]
       [-Confirm]
       [-FarmCredentials <PSCredential>]
       [-Force]
       [-Item <String>]
       [-NewDatabaseServer <String>]
       [-Percentage <Int32>]
       [-RestoreThreads <Int32>]
       [-WhatIf]
       [<CommonParameters>]

Restore-SPFarm
       -Directory <String>
       [-ShowTree]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-BackupId <Guid>]
       [-ConfigurationOnly]
       [-Confirm]
       [-Item <String>]
       [-WhatIf]
       [<CommonParameters>]

Description

Este cmdlet contém mais de um conjunto de parâmetros. Você só pode usar parâmetros de um único conjunto de parâmetros; além disso, não é possível combinar parâmetros de diferentes conjuntos. Para saber mais sobre como usar conjuntos de parâmetros, confira o artigo Conjuntos de parâmetros de cmdlet.

O cmdlet restaura um ou mais itens de um backup, como um banco de dados Restore-SPFarm individual, um aplicativo Web ou todo o farm. Esse cmdlet também pode ser usado para aplicar um modelo de farm a todo o farm.

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-----------------------

Restore-SPFarm -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -RestoreMethod new -ConfigurationOnly

Este exemplo restaura as configurações do pacote de backup \ \ no diretório file_server\compartilhamento\Backup para o farm.

-------------------EXEMPLO 2-----------------------

Restore-SPFarm -ShowTree -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -Item "Microsoft SharePoint Foundation Web Application" -Verbose

Este exemplo mostra quais componentes do farm seriam restaurados no nó Microsoft SharePoint Foundation Web Application, mas não os restaura.

-------------------EXAMPLE 3-----------------------

Restore-SPFarm -Directory C:\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef  -RestoreMethod overwrite -RestoreThreads 10 -Force

Este exemplo restaura um farm usando 10 threads e suprime o aviso de sobregravação.

Parâmetros

-AssignmentCollection

Gerencia objetos para fins de descarte adequado. 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. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-BackupId

Especifica o GUID do pacote de backup que será restaurado. Cada pacote de backup possui um GUID exclusivo associado a ele. O GUID pode ser visto usando o Get-SPBackupHistory cmdlet para exibir o histórico de backup. Se esse parâmetro não for especificado, será usado o pacote de backup mais recente no caminho especificado com o parâmetro Directory.

O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890abcdef.

Type:	Guid
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConfigurationOnly

Especifica que apenas as configurações (e não os dados) serão restauradas do pacote de backup e aplicadas a objetos no farm de destino.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Solicita a sua confirmação antes de executar o comando. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Directory

Especifica o caminho onde os produtos SharePoint armazenados no pacote de backup. Se você tiver um computador no qual SQL Server e uma instância de produtos SharePoint estão instalados, você poderá usar caminhos de unidade locais. Isso inclui uma instalação básica. No entanto, se os produtos SQL Server e SharePoint estão instalados em vários computadores, você deve usar caminhos de compartilhamento unc (Convenção de Nomenização Universal) para que os produtos SQL Server e SharePoint possam ser lidos no mesmo local \ \ (por exemplo, computer_name \volume\Backup).

O tipo deve ser qualquer um dos caminhos válidos:

C:\nome_da_pasta
\\nome_do_servidor\nome_da_pasta

As pastas spbr* são criadas automaticamente.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-FarmCredentials

Especifica as credenciais que serão usadas para todos os componentes que estiverem sendo restaurados. Por exemplo, as credenciais do pool de aplicativos para aplicativos Web que estão sendo restaurados. Se um pool de aplicativos que estiver sendo restaurado já existir no farm, as credenciais especificadas pelo parâmetro FarmCredentials serão ignoradas durante a restauração desse pool de aplicativos.

Type:	PSCredential
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Força

Suprime o prompt que avisa que componentes serão substituídos durante uma operação de restauração de substituição.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Item

Indica a parte do pacote de backup a ser restaurada. Você pode usar o caminho completo do farm conforme exibido pelo parâmetro ShowTree ou o nome do componente de destino no caminho, se ele possuir um nome exclusivo. Se vários itens coincidirem com os nomes, o caminho inteiro deverá ser fornecido. Por padrão, o nó superior está selecionado. Coloque o item ou caminho entre aspas se houver espaços. Se um parâmetro estiver ausente, o pacote de backup completo será restaurado.

O tipo deverá ser um item válido como, por exemplo:

Farm\Microsoft SharePoint Foundation Web Application\SharePoint - 80

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-NewDatabaseServer

Especifica um nome válido de Servidor de Banco de Dados SQL. Se especificado, ele será usado como o nome de Servidor de Banco de Dados padrão para todos os banco de dados incluídos na operação de restauração.

Esse parâmetro só será válido em restaurações novas. Ele não é válido em restaurações de substituição.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Percentage

Solicita que atualizações de andamento da operação de restauração sejam exibidas em incrementos desse percentual. Por exemplo, um valor de 5 exibe atualizações do andamento da restauração a cada 5% concluído e um valor de 10 exibe atualizações do andamento da restauração a cada 10% concluído.

Observação: o progresso só será exibido na saída se o parâmetro -Verbose for especificado. Caso contrário, você poderá ver o andamento no arquivo de log de restauração.

Essa porcentagem não é exata e 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 recomendado.

O tipo deve ser um valor inteiro entre 1 e 100.

O valor padrão é 5.

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RestoreMethod

Especifica o método de restauração a ser executado.

Os valores válidos são:

New; especifica um novo local para restaurar o conteúdo e deve ser usado durante a restauração para um farm diferente. Avisos adicionais serão apresentados para a especificação das novas configurações.
Overwrite; restaura conteúdo e configurações a seus locais originais e deve ser usado durante a restauração para o mesmo farm de que foi feito o backup. Se o parâmetro Overwrite for usado, um aviso de confirmação será exibido. Se não quiser ver o aviso de confirmação, use o parâmetro Force.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RestoreThreads

O número de threads que devem ser usados durante a restauração.

Quanto menos threads de restauração, mais fácil será entender o log de restauração. No entanto, quanto mais threads de restauração, mais componentes poderão ser restaurados em paralelo, resultando, possivelmente, em uma restauração mais rápida.

O intervalo válido é de 1 a 10. O valor padrão é 3.

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ShowTree

Exibe quais objetos no farm serão restaurados com base nos outros parâmetros passados para o cmdlet, ou seja, os parâmetros Item e Restore-SPFarm ConfigurationOnly. Os itens que serão excluídos da restauração com base nos outros parâmetros passados para o cmdlet serão precedidas por Restore-SPFarm um asterisco (*). Os itens que não podem ser restaurados serão entre colchetes ( [ ] ). Uma operação de restauração não será realizada se o parâmetro ShowTree estiver presente.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

Exibe uma mensagem que descreve o efeito do comando em vez de executá-lo. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019