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 -ConfigurationOnlyEste 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" -VerboseEste 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 -ForceEste 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 |