Restore-SPFarm

  • Referencia
Módulo:
sharepoint-server
Se aplica a:
SharePoint Server Subscription Edition

Restaura uno o más elementos de una copia de seguridad.

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 contiene más de un conjunto de parámetros. Solo puede usar parámetros de un conjunto y no puede combinar parámetros de conjuntos distintos. Para más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de cmdlets.

El Restore-SPFarm cmdlet restaura uno o varios elementos de una copia de seguridad, como una base de datos individual, una aplicación web o toda la granja de servidores. Este cmdlet también se puede usar para aplicar una plantilla de conjunto de servidores al conjunto de servidores completo.

Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.

Ejemplos

------------------EJEMPLO 1------------------

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

En este ejemplo se restauran los valores de configuración del paquete de copias de seguridad del directorio \\file_server\share\Backup en el conjunto de servidores.

------------------EJEMPLO 2------------------

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

En este ejemplo se muestra qué componentes de la granja de servidores se restaurarían en el nodo de Microsoft SharePoint Foundation Web Application, aunque en realidad no se restauran.

-------------------EJEMPLO 3-----------------------

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

En este ejemplo se restaura un conjunto de servidores con 10 subprocesos y se suprime la advertencia de overwrite.

Parámetros

-AssignmentCollection

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-BackupId

Especifica el GUID del paquete de copia de seguridad que se va a restaurar. Cada paquete de copia de seguridad tiene un GUID único asociado. El GUID se puede ver mediante el Get-SPBackupHistory cmdlet para ver el historial de copia de seguridad. Si este parámetro no está especificado, se usará el paquete de copia de seguridad más reciente en la ruta de acceso especificada con el parámetro Directory.

El tipo debe ser un GUID válido con el 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 Subscription Edition

-ConfigurationOnly

Especifica la configuración solamente (no los datos) que se restaurará del paquete de copia de seguridad y se aplicará a los objetos en el conjunto de servidores de destino.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente 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 Subscription Edition

-Directory

Especifica la ruta de acceso donde Productos de SharePoint almacena el paquete de copia de seguridad. Si tiene un equipo en el que SQL Server y una instancia de Productos de SharePoint están instalados, puede usar rutas de acceso de unidad local. Esto incluye una instalación básica. Sin embargo, si SQL Server y Productos de SharePoint están instalados en varios equipos, debe usar rutas de acceso compartidas de convención de nomenclatura universal (UNC) para que los productos de SQL Server y SharePoint puedan leer desde la misma ubicación (por ejemplo, \\computer_name \volume\Backup).

El tipo debe ser una de las siguientes rutas de acceso válidas:

  • C:\nombre_de_carpeta
  • \\server_name\folder_name

Las carpetas spbr* se crean automáticamente.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-FarmCredentials

Especifica las credenciales que se usarán para todos los componentes restaurados. Por ejemplo, las credenciales del grupo de aplicaciones para las aplicaciones web que se restauran. Si un grupo de aplicaciones que se restaura ya existe en la granja de servidores, las credenciales especificadas con el parámetro FarmCredentials se omiten al restaurar dicho grupo de aplicaciones.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Force

Suprime la advertencia que sobrescribirá los componentes al realizar una operación de restauración de sobrescritura.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Item

Indica de qué parte del paquete de copia de seguridad se debe restaurar. Puede usar la notación de ruta de acceso completa de la granja de servidores, como muestra el parámetro ShowTree, o el nombre del componente de destino de la ruta de acceso si tiene un nombre único. Si varios elementos coinciden con el nombre, se debe indicar la ruta de acceso completa. Incluya el elemento o la ruta de acceso entre comillas dobles si contiene un espacio. Si este parámetro no está presente, se restaura el paquete de copia de seguridad completo.

El tipo debe ser un elemento válido como:

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

-NewDatabaseServer

Especifica un nombre de servidor de bases de datos de SQL válido. Si se especifica, se usará como el nombre de servidor de bases de datos predeterminado para todas las bases de datos de la operación de restauración.

Este parámetro solo es válido cuando se restaura como nuevo. No es válido para las restauraciones de sobrescritura.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Percentage

Solicita que se muestren actualizaciones del progreso de la operación de restauración en incrementos de ese porcentaje. Por ejemplo, un valor de 5 muestra actualizaciones del progreso de la restauración cada vez que se completa un 5 por ciento y un valor de 10 muestra actualizaciones del progreso de la restauración cada vez que se completa un 10 por ciento.

Nota: el progreso solamente se mostrará en el resultado salida si se especifica el parámetro -Verbose. De lo contrario, podrá verlo en el archivo de registro de restauración.

Este porcentaje no es preciso y las actualizaciones del progreso reales pueden ser inferiores o superior a lo solicitado.

Para una base de datos de tamaño considerable, 1 es el valor recomendado.

El tipo debe ser un valor entero entre 1 y 100.

El valor predeterminado es 5.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-RestoreMethod

Especifica el método de restauración que se va a realizar.

Los valores válidos son:

  • New: especifica una nueva ubicación para restaurar el contenido y se debe usar al restaurar a una granja de servidores diferente. Para especificar la nueva configuración, se mostrarán mensajes adicionales.
  • Overwrite: restaura el contenido y la configuración en sus ubicaciones originales y se debe usar al restaurar a la misma granja de servidores desde la que se realizó la copia de seguridad. Si se usa el parámetro Overwrite, se muestra un mensaje de confirmación. Si desea que se suprima este mensaje, use el parámetro Force.
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-RestoreThreads

Cantidad de subprocesos que se deben usar durante la restauración.

Cuantos menos subprocesos de restauración haya, más sencillo será comprender el registro de restauración. Sin embargo, cuantas más restauraciones haya, más componentes podrán restaurarse en paralelo, lo que puede acelerar la restauración.

El intervalo válido está comprendido entre 1 y 10. El valor predeterminado es 3.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ShowTree

Muestra qué objetos de la granja de servidores se restaurarán en función de los demás parámetros pasados al Restore-SPFarm cmdlet, es decir, los parámetros Item y ConfigurationOnly. Los elementos que se excluirán de la restauración en función de los demás parámetros pasados al Restore-SPFarm cmdlet irán precedidos de un asterisco (*). Los elementos que no se puedan restaurar se incluirán entre corchetes ([ ]). Si está presente el parámetro ShowTree, no se realizará ninguna operación de restauración.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando. Para obtener más información, escriba el siguiente 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 Subscription Edition