Restore-SPFarm
Restaura um ou mais itens de um backup.
Sintaxe
DefaultSet
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>]
ShowTree
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 uma cópia de segurança, como uma base de dados individual, uma aplicação Web ou todo o farm.
Este cmdlet também pode ser utilizado 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 definições de configuração do pacote de cópia de segurança 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 os componentes do farm que seriam restaurados no nó Aplicação Web do Microsoft SharePoint Foundation, mas não os restaura.
EXEMPLO 3
Restore-SPFarm -Directory C:\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -RestoreMethod overwrite -RestoreThreads 10 -Force
Este exemplo restaura um farm com 10 threads e suprime o aviso de substituição.
Parâmetros
-AssignmentCollection
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | SPAssignmentCollection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-BackupId
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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 com o Get-SPBackupHistory cmdlet para ver o histórico de cópias de segurança.
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.
Propriedades do parâmetro
| Tipo: | Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConfigurationOnly
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Solicita sua confirmação antes de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Directory
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o caminho onde os Produtos SharePoint armazenaram o pacote de cópia de segurança. Se tiver um computador no qual estão instalados SQL Server e uma instância de Produtos SharePoint, pode utilizar caminhos de unidade local. Isso inclui uma instalação básica. No entanto, se SQL Server e Produtos SharePoint estiverem instalados em vários computadores, tem de utilizar caminhos de partilha UNC (Universal Naming Convention) para que o SQL Server e os Produtos SharePoint possam ler a partir da mesma localização (por exemplo, \\computer_name \volume\Cópia de Segurança).
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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-FarmCredentials
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DefaultSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Suprime o prompt que avisa que componentes serão substituídos durante uma operação de restauração de substituição.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DefaultSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Item
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Indica a parte do pacote de cópia de segurança a restaurar. Pode utilizar a notação de caminho do farm completa, conforme apresentado pelo parâmetro ShowTree ou pelo nome do componente de destino no caminho, se 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 este parâmetro estiver ausente, todo o pacote de cópia de segurança será restaurado.
O tipo deverá ser um item válido como, por exemplo:
Farm\Microsoft SharePoint Foundation Web Application\SharePoint - 80
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-NewDatabaseServer
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DefaultSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Percentage
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Nota: o progresso só será apresentado 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.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DefaultSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RestoreMethod
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DefaultSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RestoreThreads
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DefaultSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ShowTree
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Mostra os objetos no farm que serão restaurados com base nos outros parâmetros transmitidos para o Restore-SPFarm cmdlet, nomeadamente os parâmetros Item e ConfigurationOnly.
Os itens que serão excluídos do restauro com base nos outros parâmetros transmitidos ao Restore-SPFarm cmdlet serão precedidos de 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ShowTree
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.