Backup-SPFarm

Crea una copia de seguridad de una base de datos individual, una aplicación web o el conjunto de servidores completo.

Syntax

Backup-SPFarm
      -BackupMethod <String>
      -Directory <String>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-BackupThreads <Int32>]
      [-ConfigurationOnly]
      [-Force]
      [-Item <String>]
      [-Percentage <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Backup-SPFarm
      [-ShowTree]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-ConfigurationOnly]
      [-Item <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Este cmdlet contiene más de un conjunto de parámetros. Es posible que solo pueda usar parámetros procedentes de un conjunto de parámetros y no pueda combinar los parámetros de distintos conjuntos de parámetros. Para más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de cmdlets.

El cmdlet Backup-SPFarm crea una copia de seguridad para todo el conjunto de servidores o para componentes individuales del conjunto. También se puede usar para hacer una copia de seguridad de los valores de configuración de un conjunto a fin de usarla como una plantilla del conjunto para otros conjuntos de servidores de SharePoint. Si desea hacer una copia de seguridad de una única colección de sitios, use el cmdlet Backup-SPSite.

Para ver los objetos disponibles para la copia de seguridad, use el conjunto de -ShowTree parámetros.

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

Backup-SPFarm -Directory \\file_server\share\Backup -BackupMethod full -ConfigurationOnly

En este ejemplo se realiza la copia de seguridad de los valores de configuración del conjunto de servidores en el directorio \\file_server\share\Backup.

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

Backup-SPFarm -ShowTree -Item "Microsoft SharePoint Foundation Web Application" -Verbose

En este ejemplo se muestran los componentes de la granja de servidores cuya copia de seguridad se realizaría en el nodo “Windows SharePoint Foundation Web Application", pero, en realidad, no se hace la copia de seguridad.

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

Backup-SPFarm -Directory C:\Backup -BackupMethod full -BackupThreads 10 -Force

En este ejemplo se realiza una copia de seguridad de un conjunto de servidores mediante 10 subprocesos y se guarda la copia en el directorio C:\Backup a pesar de que SharePoint indica que no tiene suficiente espacio disponible.

--------------------EXAMPLE 4---------------------

Backup-SPFarm -ShowTree

En este ejemplo se muestran los objetos disponibles para realizar la copia de seguridad con Backup-SPFarm.

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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-BackupMethod

Especifica el tipo de archivo de copia de seguridad que se va a crear.

Si se realiza una copia de seguridad con el parámetro -ShowTree, no se usa el parámetro BackupMethod.

Una copia de seguridad completa es una copia de seguridad de todos los datos seleccionados. Una copia de seguridad diferencial es una copia de seguridad de todos los datos seleccionados que se han modificado desde la última copia de seguridad completa. Si un elemento no admite la copia de seguridad diferencial, se realizará una copia de seguridad completa para ese elemento en su lugar.

El tipo debe ser alguno de los siguientes:

  • Full
  • Diferencial
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

-BackupThreads

Especifica la cantidad de subprocesos que se van a usar durante la copia de seguridad. Mientras menor sea su número, más fácil resultará leer y comprender el archivo de registro de copia de seguridad. A mayor cantidad de subprocesos, se podrán realizar copias de seguridad de más componentes en paralelo, lo que puede acelerar la operación de copia de seguridad. El valor mínimo es 1 y el máximo es 10.

El valor predeterminado es 3.

Si se realiza una copia de seguridad con el parámetro -ShowTree, no se usa el parámetro BackupMethod.

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

-ConfigurationOnly

Si se establece, la copia de seguridad contendrá valores de configuración solamente (sin datos) para cada uno de los objetos cuya copia de seguridad se va a realizar.

SharePoint puede sobrestimar la cantidad de espacio necesario para una copia de seguridad de solo configuración, lo que puede dar lugar a que SharePoint calcule que no tiene suficiente espacio para almacenar la copia de seguridad en la ruta de acceso especificada. Use el -Force parámetro en esta situación para continuar con la copia de seguridad si tiene espacio suficiente para almacenar la copia de seguridad de solo configuración.

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

Solicitará confirmación antes de ejecutar el cmdlet.

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 la ruta de acceso donde SharePoint Products almacena el paquete de copia de seguridad que genera. 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 o si tiene varios servidores que ejecutan Productos de SharePoint, debe usar rutas de acceso compartidas de convención de nomenclatura universal (UNC) para que la base de datos de SQL Server y los componentes de búsqueda se escriban en la misma ubicación; por ejemplo, \\computer_name\volume\Backup).

Es posible almacenar varios paquetes de copia de seguridad en la misma ubicación. Esta es la misma ruta de acceso que se pasa al parámetro Directory del cmdlet Restore-SPFarm.

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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Force

Especifica que se debe proceder con la operación de copia de seguridad incluso si se estima que el directorio de copia de seguridad no tiene suficiente espacio para contener la copia de seguridad completa.

Si se realiza una copia de seguridad con el parámetro ShowTree, entonces el parámetro Force no se usa.

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 de qué parte del conjunto de servidores se va a hacer una copia de seguridad. Puede usar la notación de ruta de acceso completa del conjunto 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 existen varios elementos coincidentes, se debe indicar la ruta de acceso completa. De forma predeterminada, se selecciona el nodo superior. Incluya el elemento o la ruta de acceso entre comillas dobles si contiene un espacio. Si este parámetro no está especificado, se hace una copia de seguridad de todo el conjunto de servidores.

El tipo debe ser un elemento válido; por ejemplo, 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

-Percentage

Solicita que se muestren actualizaciones del progreso de la operación de copia de seguridad en incrementos de ese porcentaje (por ejemplo, el valor 5 mostrará actualizaciones del progreso de la copia de seguridad cuando se complete un 5% y el valor 10 las mostrará cuando se complete un 10%). Para mostrar los resultados del progreso, debe especificar el parámetro Verbose.

Este porcentaje no es preciso y las actualizaciones del progreso reales podrían ser menores o mayores que las solicitadas. Las actualizaciones del progreso se registran siempre en el archivo de registro de copia de seguridad.

El valor del porcentaje no es preciso y las actualizaciones del progreso reales podrían ser menores o mayores que las solicitadas.

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

Los valores válidos son enteros entre 1 y 100.

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

Muestra los objetos del conjunto de servidores de los que se realizará una copia de seguridad en función de otros parámetros pasados al cmdlet Backup-SPFarm, es decir, el parámetro Item. Los elementos que se excluirán de la copia de seguridad en función de los otros parámetros pasados al cmdlet Backup-SPFarm irán precedidos de un asterisco (*). Los elementos de los que no se pueda hacer una copia de seguridad se incluirán entre corchetes ([ ]). Si está presente el parámetro ShowTree, no se hará ninguna copia de seguridad.

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

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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019