Compartilhar via


Restore-SPFarm

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 parâmetro definido. Você pode usar apenas parâmetros de um conjunto de parâmetro e você não pode combinar parâmetros de diferentes conjuntos de parâmetros. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.

O Restore-SPFarm cmdlet restaura um ou mais itens de um backup, como um banco de dados 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\share\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 Aplicativo Web do SharePoint Foundation, mas não os restaura de fato.

-------------------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 substituição.

Parâmetros

-AssignmentCollection

Gerencia objetos para o devido descarte. 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. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
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 em que os Produtos do SharePoint armazenaram o pacote de backup. Se você tiver um computador no qual SQL Server e uma instância de Produtos do SharePoint estiverem instalados, você poderá usar caminhos de unidade locais. Isso inclui uma instalação básica. No entanto, se SQL Server e Produtos do SharePoint estiverem instalados em vários computadores, você deverá usar caminhos de compartilhamento da UNC (Convenção Universal de Nomenclatura) para que os produtos SQL Server e SharePoint possam ler no mesmo local (por exemplo, \\computer_name \volume\Backup).

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

  • C:\nome_da_pasta
  • \\server_name\folder_name

As pastas spbr* são criadas automaticamente.

Type:String
Position:Named
Default value:None
Required:True
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
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Force

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
Required:False
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 restaurado. Você pode usar a notação completa do caminho do farm conforme exibido pelo parâmetro ShowTree ou o nome do componente de destino no caminho se ele tiver um nome exclusivo. Caso vários itens tenham o mesmo nome, o caminho completo deverá ser fornecido. Coloque o item ou o caminho entre aspas duplas se ele contiver um espaço. Se esse parâmetro estiver ausente, todo o pacote de backup 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
Required:False
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
Required:False
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
Required:False
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
Required:True
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
Required:False
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 Restore-SPFarm cmdlet, ou seja, os parâmetros Item e ConfigurationOnly. Os itens que serão excluídos da restauração com base nos outros parâmetros passados para o Restore-SPFarm cmdlet serão precedidos com um asterisco (*). Os itens que não puderem ser restaurados serão colocados 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
Required:True
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 executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

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