SPBackupRestoreSettings.IndividualItem - Propriété

Obtient ou définit le composant de contenu qui est sauvegardé ou restauré.

Espace de noms :  Microsoft.SharePoint.Administration.Backup
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Property IndividualItem As String
    Get
    Set
'Utilisation
Dim instance As SPBackupRestoreSettings
Dim value As String

value = instance.IndividualItem

instance.IndividualItem = value

public string IndividualItem { get; set; }

Valeur de propriété

Type : System.String
String qui représente le nom de la batterie de serveurs ou le composant de contenu de la batterie de serveurs qui est sauvegardé ou restauré.

Remarques

Par exemple, une application Web peut être nommée « SharePoint - 80 » ; une base de données de contenu peut être nommé « WSS_Content_1234567890a2b4c6d8e0f2a4b6c8d0e2 ». La batterie entière est nommée « Batterie » dans SharePoint Foundation.

Cette propriété est utilisée pour identifier, dans le fichier spbackup.log ou sprestore.log , le composant de niveau supérieur dans l'arborescence de composants qui est sauvegardé ou restauré. Il incombe au code appelant de s'assurer que le journal est exact en passant IndividualItem comme deuxième paramètre de la méthode FindItems() . (Voir l'exemple de code ci-dessous).

Un nom partiel fonctionnera à condition qu'il n'existe qu'une seule correspondance possible. Par exemple, « WSS_Content » serait suffisante pour identifier une base de données contenu autant qu'il n'en a qu'un seul dont le nom commence par « WSS_Content ». Si chaque deux composants parents ont un enfant avec exactement le même nom et que vous souhaitez sauvegarder (ou restaurer), vous pouvez supprimer l'ambiguïté en ajoutant le nom du parent devant le nom de l'enfant avec une barre oblique inverse entre les deux ; par exemple, « SharePoint - 80\WSS_Content ». Si un nom ambigu est passé à la méthode FindItems() , il retournera une collection avec plus d'un membre. Dans ce cas l'appel de code doit inviter l'utilisateur à être plus spécifique. (Voir l'exemple de code ci-dessous).

Vous pouvez définir cette propriété à un des types de composants suivants :

• La batterie entière. (Mais lorsque la batterie entière est la [IndividualItem] d'une opération de restauration, la base de données de configuration de la batterie ni la base de données de contenu de l'application d'Administration centrale est restauré).

• Service web de publication du contenu, à l'exception du service web WSS_Administration qui publie les pages de l'application Administration centrale de SharePoint Foundation .

• N'importe quelle application Web au sein d'un service web, à l'exception de l'application Web Administration centrale de publication de contenu.

• Toute base de données contenu dans une application Web. Mais la base de données de contenu de l'application Web Administration centrale ne peut le IndividualItem pour une opération de sauvegarde. Vous ne pouvez pas restaurer le contenu de l'application d'Administration centrale. Sa sauvegarde peut être utile de créer un enregistrement de point-à-temps de la base de données afin qu'elle peut être comparée, comme une étape de dépannage, avec une version ultérieure à l'aide des outils SQL Server.

• N'importe quel fournisseur de services partagés qui est fourni avec un produit de fonctionnalités avancées, telles que Microsoft Office SharePoint Server 2007, qui est installé sur SharePoint Foundation.

• N'importe quel composant contenu personnalisé qui implémente IBackupRestore.

Pour voir le détail des noms des composants sur votre batterie de serveurs qui peut être les objets des opérations de sauvegarde, vous pouvez exécuter la commande stsadm -o backup -showtree à la ligne de commande du serveur ou naviguez jusqu'à opérations > effectuer une sauvegarde dans l'application Administration centrale.

Pour obtenir, par programme, les noms des composants sur votre batterie de serveurs qui peuvent être les objets des opérations de sauvegarde, utilisez FindItems.

Exemples

L'exemple suivant montre comment utiliser la propriété IndividualItem dans une application de sauvegarde. Pour l'exemple complet et une description détaillée de ce dernier, consultez 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

Voir aussi

Référence

SPBackupRestoreSettings classe

SPBackupRestoreSettings - Membres

Microsoft.SharePoint.Administration.Backup - Espace de noms