de la propiedad SPBackupRestoreSettings.IndividualItem
Obtiene o establece el componente de contenido que se realiza una copia de seguridad o restauración.
Espacio de nombres: Microsoft.SharePoint.Administration.Backup
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
Public Property IndividualItem As String
Get
Set
'Uso
Dim instance As SPBackupRestoreSettings
Dim value As String
value = instance.IndividualItem
instance.IndividualItem = value
public string IndividualItem { get; set; }
Valor de propiedad
Tipo: System.String
String que representa el nombre de la granja de servidores o el componente de contenido de la granja de servidores que se realiza una copia de seguridad o restauración.
Comentarios
Por ejemplo, una aplicación Web podría tener el nombre "SharePoint - 80"; una base de datos de contenido podría llamarse "WSS_Content_1234567890a2b4c6d8e0f2a4b6c8d0e2". Toda la granja se denomina "Granja" en SharePoint Foundation.
Esta propiedad se usa para identificar, en el archivo spbackup.log o sprestore.log , el componente superior en el árbol de componentes que se realiza una copia de seguridad o restauración. Es responsabilidad del código de llamada para asegurarse de que el registro es exacto pasando IndividualItem como el segundo parámetro del método FindItems() . (Vea el ejemplo de código siguiente).
Un nombre parcial funcionará siempre que haya sólo una coincidencia posible. Por ejemplo, "WSS_Content" sería suficiente para identificar una base de datos de contenido siempre que hay una sola cuyo nombre comienza con "WSS_Content". Si dos componentes primario tienen un elemento secundario con exactamente el mismo nombre y desea hacer copia de seguridad (o restaurar) uno de ellos, puede eliminar la ambigüedad anexando el nombre principal en el primer plano del nombre del elemento secundario con un carácter de barra diagonal inversa en entre; Por ejemplo, "SharePoint - 80\WSS_Content". Si un nombre ambiguo se pasa al método FindItems() , devolverá una colección con más de un miembro. El código de llamada en ese caso, debe solicitar al usuario que sea más específico. (Vea el ejemplo de código siguiente).
Puede establecer esta propiedad en cualquiera de los siguientes tipos de componentes:
Toda la granja de servidores. (Pero cuando toda la granja de servidores es el [IndividualItem] de una operación de restauración, se restaurará la base de datos de configuración de la granja de servidores ni a la base de datos de contenido de la aplicación de Administración Central).
Cualquier servicio web de publicación de contenido, excepto el servicio web de WSS_Administration publica las páginas de la aplicación de Administración Central SharePoint Foundation .
Cualquier aplicación Web dentro de un servicio web, excepto la aplicación Web de Administración Central de publicación de contenido.
Cualquier base de datos contenido en una aplicación Web. Pero la base de datos de contenido de la aplicación Web de Administración Central sólo puede ser el IndividualItem para una operación de copia de seguridad. No se puede restaurar el contenido de la aplicación de Administración Central. Copia de seguridad puede ser útil para crear un registro de punto en el tiempo de la base de datos para que se puede comparar, como un paso de la solución de problemas, con una versión posterior con las herramientas de SQL Server.
Cualquier proveedor de servicios compartidos que se incluye con un producto de funcionalidad mejorada, como Microsoft Office SharePoint Server 2007, que se instala en la parte superior SharePoint Foundation.
Cualquier componente contenido personalizado que implementa IBackupRestore.
Nota
La base de datos de configuración de la granja de servidores se incluye en una operación de copia de seguridad si la IndividualItem es toda la granja de servidores, pero no puede ser el IndividualItem por sí mismo. Incluso más importante, no se restaura cuando la granja de servidores es el IndividualItem de una operación de restauración. No se puede restaurar la base de datos de configuración. Copia de seguridad puede ser útil para crear un registro de punto en el tiempo de la base de datos para que se puede comparar, como un paso de la solución de problemas, con una versión posterior con las herramientas de SQL Server.
Para ver un desglose de los nombres de los componentes en la granja de servidores que puede ser los objetos de las operaciones de copia de seguridad, puede ejecutar el comando stsadm -o backup -showtree en la línea de comandos de servidor o navegue hasta operaciones > realizar una copia de seguridad en la aplicación de Administración Central.
Para obtener, mediante programación, los nombres de los componentes de la granja de servidores que pueden ser los objetos de las operaciones de copia de seguridad, use FindItems.
Ejemplos
El ejemplo siguiente muestra cómo utilizar la propiedad IndividualItem en una aplicación de copia de seguridad. Para obtener una explicación detallada de la misma y el ejemplo completo, vea How to: Programmatically Back Up Content.
static void Main(string[] args)
{
// Identify the location for the backup storage.
Console.Write("Enter full UNC path to the directory where the backup will be stored:");
String backupLocation = Console.ReadLine();
// Create the backup settings.
SPBackupSettings settings = SPBackupRestoreSettings.GetBackupSettings(backupLocation, "Full");
// Identify the content component to backup.
Console.Write("Enter name of component to backup (default is whole farm):");
settings.IndividualItem = Console.ReadLine();
// Set optional operation parameters.
settings.IsVerbose = true;
settings.UpdateProgress = 10;
settings.BackupThreads = 10;
// Create the backup operation and return its ID.
Guid backup = SPBackupRestoreConsole.CreateBackupRestore(settings);
// Ensure that user has identified a valid and unique component.
SPBackupRestoreObject node = EnsureUniqueValidComponentName(settings, ref backup);
// Ensure that there is enough space.
Boolean targetHasEnoughSpace = false;
if (node != null)
{
targetHasEnoughSpace = EnsureEnoughDiskSpace(backupLocation, backup, node);
}
// If there is enough space, attempt to run the backup.
if (targetHasEnoughSpace)
{
// Set the backup as the active job and run it.
if (SPBackupRestoreConsole.SetActive(backup) == true)
{
if (SPBackupRestoreConsole.Run(backup, node) == false)
{
// Report "error" through your UI.
String error = SPBackupRestoreConsole.Get(backup).FailureMessage;
Console.WriteLine(error);
}
}
else
{
// Report through your UI that another backup
// or restore operation is underway.
Console.WriteLine("Another backup or restore operation is already underway. Try again when it ends.");
}
// Clean up the operation.
SPBackupRestoreConsole.Remove(backup);
Console.WriteLine("Backup attempt complete. Press Enter to continue.");
Console.ReadLine();
}
}// end Main
Shared Sub Main(ByVal args() As String)
' Identify the location for the backup storage.
Console.Write("Enter full UNC path to the directory where the backup will be stored:")
Dim backupLocation As String = Console.ReadLine()
' Create the backup settings.
Dim settings As SPBackupSettings = SPBackupRestoreSettings.GetBackupSettings(backupLocation, "Full")
' Identify the content component to backup.
Console.Write("Enter name of component to backup (default is whole farm):")
settings.IndividualItem = Console.ReadLine()
' Set optional operation parameters.
settings.IsVerbose = True
settings.UpdateProgress = 10
settings.BackupThreads = 10
' Create the backup operation and return its ID.
Dim backup As Guid = SPBackupRestoreConsole.CreateBackupRestore(settings)
' Ensure that user has identified a valid and unique component.
Dim node As SPBackupRestoreObject = EnsureUniqueValidComponentName(settings, backup)
' Ensure that there is enough space.
Dim targetHasEnoughSpace As Boolean = False
If node IsNot Nothing Then
targetHasEnoughSpace = EnsureEnoughDiskSpace(backupLocation, backup, node)
End If
' If there is enough space, attempt to run the backup.
If targetHasEnoughSpace Then
' Set the backup as the active job and run it.
If SPBackupRestoreConsole.SetActive(backup) = True Then
If SPBackupRestoreConsole.Run(backup, node) = False Then
' Report "error" through your UI.
Dim [error] As String = SPBackupRestoreConsole.Get(backup).FailureMessage
Console.WriteLine([error])
End If
Else
' Report through your UI that another backup
' or restore operation is underway.
Console.WriteLine("Another backup or restore operation is already underway. Try again when it ends.")
End If
' Clean up the operation.
SPBackupRestoreConsole.Remove(backup)
Console.WriteLine("Backup attempt complete. Press Enter to continue.")
Console.ReadLine()
End If
End Sub ' end Main
Vea también
Referencia
Miembros SPBackupRestoreSettings
Espacio de nombres Microsoft.SharePoint.Administration.Backup