Backup-SPFarm
Crea una copia de seguridad de una base de datos individual, una aplicación web o el conjunto de servidores completo.
Sintaxis
DefaultSet
Backup-SPFarm
-BackupMethod <String>
-Directory <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-BackupThreads <Int32>]
[-ConfigurationOnly]
[-Force]
[-Item <String>]
[-Percentage <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ShowTree
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.
EJEMPLO 4
Backup-SPFarm -ShowTree
En este ejemplo se muestran los objetos disponibles para realizar la copia de seguridad con Backup-SPFarm.
Parámetros
-AssignmentCollection
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | SPAssignmentCollection |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-BackupMethod
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
DefaultSet
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-BackupThreads
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
DefaultSet
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ConfigurationOnly
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Solicitará confirmación antes de ejecutar el cmdlet.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Directory
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica la ruta de acceso donde Productos de SharePoint 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
DefaultSet
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Force
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
DefaultSet
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Item
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Percentage
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
DefaultSet
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ShowTree
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ShowTree
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.