SPBackupRestoreSettings.IndividualItem-Eigenschaft

Dient zum Abrufen oder Festlegen der Inhaltskomponente, die gesichert oder wiederhergestellt wird.

Namespace:  Microsoft.SharePoint.Administration.Backup
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaration
Public Property IndividualItem As String
    Get
    Set
'Usage
Dim instance As SPBackupRestoreSettings
Dim value As String

value = instance.IndividualItem

instance.IndividualItem = value

public string IndividualItem { get; set; }

Eigenschaftswert

Typ: System.String
Eine String , die den Namen des Inhalts Komponente der Farm, die gesichert oder wiederhergestellt oder der Farm darstellt.

Hinweise

Beispielsweise könnte eine Webanwendung "SharePoint - 80"; die Bezeichnung eine Inhaltsdatenbank möglicherweise "WSS_Content_1234567890a2b4c6d8e0f2a4b6c8d0e2" heißen. Die gesamte Farm wird als SharePoint Foundation"Farm" bezeichnet.

Diese Eigenschaft wird verwendet, in der Datei spbackup.log oder sprestore.log identifiziert die oberste Komponente in der Struktur der Komponenten, die gesichert oder wiederhergestellt wird. Es ist die Verantwortung für den aufrufenden Code, um sicherzustellen, dass das Protokoll korrekt ist, indem Sie IndividualItem als den zweiten Parameter der FindItems() -Methode übergeben. (Siehe das folgende Codebeispiel).

Ein Teil des Namens funktioniert, vorausgesetzt, es ist nur eine mögliche Übereinstimmung. Beispielsweise sollte "WSS_Content" ausreichen, eine Inhaltsdatenbank zu identifizieren, vorausgesetzt, es nur eine gibt, deren Name mit "WSS_Content" beginnt. Wenn jede zwei übergeordneten Komponenten vorhanden, ein untergeordnetes Element mit genau mit dem gleichen Namen sind, und Sie sichern (oder wiederherstellen) eine Gruppe möchten, können Sie durch Anfügen der Name der übergeordneten am Anfang der Name der untergeordneten mit einem umgekehrten Schrägstrich im zwischen eindeutig; beispielsweise "SharePoint - 80\WSS_Content". Wenn ein mehrdeutiger Name der FindItems() -Methode übergeben wird, wird eine Auflistung mit mehr als ein Element zurückgegeben. Aufrufen von Code in diesem Fall sollten Benutzer genauer auffordern. (Siehe den folgenden Beispielcode).

Sie können diese Eigenschaft auf eine der folgenden Arten von Komponenten festlegen:

• Die gesamte Farm. (Sie können jedoch wird die gesamte Farm die [IndividualItem] einer Wiederherstellung, weder die Konfigurationsdatenbank der Farm noch die Inhaltsdatenbank der Zentraladministration-Anwendung wiederhergestellt werden.)

• Content publishing-Webdienst veröffentlicht außer dem Webdienst Verwaltungsdiensts, mit denen die Seiten von der SharePoint Foundation Zentraladministrationsanwendung.

• Jede Webanwendung innerhalb einer inhaltsveröffentlichungs-Webdienst, mit Ausnahme der Webanwendung der Zentraladministration.

• Eine Inhaltsdatenbank in einer Webanwendung. Die Inhaltsdatenbank der Webanwendung der Zentraladministration kann jedoch nur die IndividualItem für einen Sicherungsvorgang. Den Inhalt der Anwendung der Zentraladministration können nicht wiederhergestellt werden. Sichern, ist möglicherweise sinnvoll, die einen Point-in-Time-Eintrag der Datenbank erstellen möchten, damit er, im Rahmen der Problembehandlung, mit einer höheren Version von SQL Server-Tools verglichen werden kann.

• Alle Anbieter für gemeinsame Dienste, die mit einem Produkt mit erweiterter Funktionalität, wie etwa Microsoft Office SharePoint Server 2007, enthalten ist, die auf der Basis SharePoint Foundationinstalliert ist.

• Eine beliebige benutzerdefinierte Inhaltskomponente, die IBackupRestoreimplementiert.

Um eine Einzelauflistung von den Namen der Komponenten in der Farm angezeigt wird, die die Objekte der Sicherungsvorgänge werden können, können Sie entweder führen Sie den Befehl stsadm -o backup -showtree an der Befehlszeile oder navigieren Sie zu Vorgänge > Ausführen einer Sicherung in der Zentraladministration.

Um zu erhalten, programmgesteuert verwenden die Namen der Komponenten in Ihrer Farm, die die Objekte der Sicherungsvorgänge, werden können FindItems.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die IndividualItem -Eigenschaft in einer Sicherungsanwendung verwendet. Das vollständige Beispiel und eine ausführliche Erläuterung des es finden Sie unter 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

Siehe auch

Referenz

SPBackupRestoreSettings Klasse

SPBackupRestoreSettings-Member

Microsoft.SharePoint.Administration.Backup-Namespace