Clase SPBackupRestoreObject

Proporciona funciones auxiliares para operaciones de copia de seguridad y restauración y actúa como un contenedor para un objeto de SPBackupRestoreInformation y su objeto correlacionadas IBackupRestore .

Jerarquía de la herencia

System.Object
  Microsoft.SharePoint.Administration.Backup.SPBackupRestoreObject

Espacio de nombres:  Microsoft.SharePoint.Administration.Backup
Ensamblado:  Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
Public NotInheritable Class SPBackupRestoreObject
'Uso
Dim instance As SPBackupRestoreObject

[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
public sealed class SPBackupRestoreObject

Comentarios

Porque tiene una propiedad de IBackupRestore que devuelve un objeto IBackupRestore , un objeto SPBackupRestoreObject puede considerarse como que representa un componente de contenido de un tipo que puede copia de seguridad o restauración.

se pueden anidar objetos SPBackupRestoreObject . Para obtener más información, vea las propiedades Parent y Children . Normalmente, un árbol de objetos de SPBackupRestoreObject reflejar un árbol de componentes de contenido, como la granja de servidores, servicio Web, aplicación Web y base de datos de contenido. Sin embargo, el método Reparent permite crear árboles de copia de seguridad y restaurar las operaciones que no exactamente reflejar cualquier parte del árbol de la implementación de componentes.

Esta clase no tiene constructor público. Obtener una referencia a un objeto SPBackupRestoreObject con un método que devuelve objetos de esta clase. Por ejemplo, GetRooto usar un indizador para obtener una referencia a un miembro determinado de un objeto SPBackupRestoreObjectCollection .

Esta clase tiene varias constantes que se usan para extraer información del objeto en la propiedad Information .

Un objeto SPBackupRestoreObject persiste como un elemento de <SPBackupObject> en un spbackup.xml o un sprestore.xml que se guarda en una subcarpeta de la ubicación de copia de seguridad identificada en la propiedad Location del objeto en la propiedad Information .

Ejemplos

A continuación se muestra la clase SPBackupRestoreObject que se usa en un método que se asegurará de que el nombre del componente enviado por un usuario de forma única identifica un componente único para que sea la parte superior del árbol de componentes que se procesarán mediante una copia de seguridad o la operación de restauración. Para obtener una explicación detallada de la misma y el ejemplo completo, vea How to: Programmatically Back Up Content.

private static SPBackupRestoreObject EnsureUniqueValidComponentName(SPBackupRestoreSettings settings, ref Guid operationGUID)
{
    SPBackupRestoreObjectCollection list = SPBackupRestoreConsole.FindItems(operationGUID, settings.IndividualItem);
    SPBackupRestoreObject component = null;

    if (list.Count <= 0)
    {
        Console.WriteLine("There is no component with that name. Run again with a new name.");
        Console.WriteLine("Press Enter to continue.");
        Console.ReadLine();
    }
    else if (list.Count > 1)  // The component name specified is ambiguous. Prompt user to be more specific.
    {
        Console.WriteLine("More than one component matches the name you entered.");
        Console.WriteLine("Run again with one of the following:");
        for (int i = 0; i < list.Count; i++)
        {
            Console.WriteLine("\t{0}", list[i].ToString());
        }
        Console.WriteLine("Press Enter to continue.");
        Console.ReadLine();
    }
    else
    {
        component = list[0];
    }

    return component;

}// end EnsureUniqueValidComponentName

Private Shared Function EnsureUniqueValidComponentName(ByVal settings As SPBackupRestoreSettings, ByRef operationGUID As Guid) As SPBackupRestoreObject
    Dim list As SPBackupRestoreObjectCollection = SPBackupRestoreConsole.FindItems(operationGUID, settings.IndividualItem)
    Dim component As SPBackupRestoreObject = Nothing

    If list.Count <= 0 Then
        Console.WriteLine("There is no component with that name. Run again with a new name.")
        Console.WriteLine("Press Enter to continue.")
        Console.ReadLine()
    ElseIf list.Count > 1 Then ' The component name specified is ambiguous. Prompt user to be more specific.
        Console.WriteLine("More than one component matches the name you entered.")
        Console.WriteLine("Run again with one of the following:")
        For i As Integer = 0 To list.Count - 1
            Console.WriteLine(vbTab & "{0}", list(i).ToString())
        Next i
        Console.WriteLine("Press Enter to continue.")
        Console.ReadLine()
    Else
        component = list(0)
    End If

    Return component

End Function ' end EnsureUniqueValidComponentName

El siguiente es un ejemplo de un elemento <SPBackupObject> en un archivo sprestore.xml . El componente representado por el elemento es una aplicación Web denominada "SharePoint - 80" SharePoint Foundation .

<SPBackupObject Name="SharePoint - 80">
    <SPBackupRestoreClass>Microsoft.SharePoint.Administration.SPWebApplication, Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c</SPBackupRestoreClass>
    <SPBackupSelectable>True</SPBackupSelectable>
    <SPRestoreSelectable>True</SPRestoreSelectable>
    <SPName>SharePoint - 80</SPName>
    <SPId>6abb0dec-eeab-42d2-8996-af63b8a3ef60</SPId>
    <SPCanBackup>True</SPCanBackup>
    <SPCanRestore>True</SPCanRestore>
    <SPCurrentProgress>100</SPCurrentProgress>
    <SPLastUpdate>04/27/2009 12:34:56</SPLastUpdate>
    <SPCurrentPhase>Done</SPCurrentPhase>
    <SPParameters>
        <SPParameter Key="6abb0dec-eeab-42d2-8996-af63b8a3ef60STATE.xml"><![CDATA[00000003.bak]]></SPParameter>
        <SPParameter Key="ApplicationPoolId"><![CDATA[SharePoint Content Application Pool]]></SPParameter>
        <SPParameter Key="Features.xml"><![CDATA[0000001B.bak]]></SPParameter>
        <SPParameter Key="IdentityType"><![CDATA[SpecificUser]]></SPParameter>
        <SPParameter Key="OutboundMailServer"><![CDATA[smtp.example.com]]></SPParameter>
        <SPParameter Key="SPDescription"><![CDATA[Content and configuration data for this Web application.]]></SPParameter>
        <SPParameter Key="SPName" InputDescription="New web application name:"><![CDATA[SharePoint - 80]]></SPParameter>
        <SPParameter Key="SPServer" InputDescription="New web application URL:" ForceLtr="true"><![CDATA[http://sharepoint.example.com/]]></SPParameter>
        <SPParameter Key="SPUserName"><![CDATA[DOMAIN\username]]></SPParameter>
        <SPParameter Key="WebApplicationId"><![CDATA[67bf6cdb-8fc9-457f-9764-6a8bbf07769e]]></SPParameter>
    </SPParameters>
</SPBackupObject>

Seguridad para subprocesos

Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.

Vea también

Referencia

Miembros SPBackupRestoreObject

Espacio de nombres Microsoft.SharePoint.Administration.Backup