Свойство SPBackupRestoreSettings.IndividualItem
Получает или задает контента компонент, резервного или восстановления.
Пространство имен: Microsoft.SharePoint.Administration.Backup
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)
Синтаксис
'Декларация
Public Property IndividualItem As String
Get
Set
'Применение
Dim instance As SPBackupRestoreSettings
Dim value As String
value = instance.IndividualItem
instance.IndividualItem = value
public string IndividualItem { get; set; }
Значение свойства
Тип: System.String
String , который представляет имя фермы или компонента содержимого в ферме, которая резервного или восстановления.
Замечания
Например веб-приложения может быть с именем «SharePoint - 80»; базы данных контента могут иметь имя «WSS_Content_1234567890a2b4c6d8e0f2a4b6c8d0e2». Имя «Ферма» SharePoint Foundation— всей фермы.
Это свойство используется для идентификации в файле spbackup.log или sprestore.log компонент верхнего уровня в дереве компонентов, которые резервного или восстановления. Должна осуществлять вызывающий код, убедитесь, что журнал является правильным, передав IndividualItem в качестве второго параметра метода FindItems() . (См. в примере кода).
Сокращенное имя будет работать условии, что существует только один возможно соответствие. Например «WSS_Content» будет достаточно для идентификации базы данных контента в условии, что существует только один, имя которых начинается с «WSS_Content». Если два компонента родительского иметь дочерних с точно тем же именем, необходимо создать резервную копию (или восстановления) один из них может различать путем добавления имени родительского на передний план имя дочернего с обратной косой черты между ними. Например, «SharePoint - 80\WSS_Content». Неоднозначное имя передается методу FindItems() , возвращает коллекцию с помощью одного из участников. Вызов кода в этом случае следует запрашивать точнее. (См. в примере кода ниже).
Это свойство можно задать для любой из следующих типов компонентов:
Вся ферма. (Однако при [IndividualItem] операции восстановления всей фермы будут восстановлены ни базы данных конфигурации фермы, ни базы данных контента приложения центра администрирования).
Любое содержимое публикации веб-службы, за исключением WSS_Administration веб-службы, которая публикует страниц SharePoint Foundation приложения центра администрирования.
Веб-приложение в содержимом, публикации веб-службы, за исключением приложения веб-сайта центра администрирования.
Любая база данных контента из веб-приложения. Однако базы данных контента центра администрирования веб-приложения может быть только IndividualItem для операции резервного копирования. Невозможно восстановить контента приложения центра администрирования. Резервное копирование можно использовать для создания записи в момент базы данных, чтобы его можно сравнивать, для устранения неполадок с более поздней версии с помощью средств SQL Server.
Любой поставщика общих служб, который входит в состав продукта расширенные функциональные возможности, такие как Microsoft Office SharePoint Server 2007, которая устанавливается на основе SharePoint Foundation.
Любой настраиваемый компонент контента, который реализует IBackupRestore.
Примечание
Базы данных конфигурации фермы включается в операции резервного копирования, если IndividualItem является всей ферме, но не может быть IndividualItem сам по себе. Еще важнее оно не восстанавливается при IndividualItem операции восстановления фермы. Невозможно восстановить базу данных конфигурации. Резервное копирование можно использовать для создания записи в момент базы данных, чтобы его можно сравнивать, для устранения неполадок с более поздней версии с помощью средств SQL Server.
Чтобы просмотреть список имен компонентов в ферме, которая может быть объекты операций резервного копирования, можно выполнить команду stsadm -o backup -showtree в командной строке сервера или перейдите к операции > резервное копирование в приложение центра администрирования.
Для получения программным способом, имена компонентов в ферме, которая может быть объекты операций резервного копирования, используйте FindItems.
Примеры
Следующем примере показано, как использовать свойство IndividualItem в приложение резервного копирования. Полный пример и подробное обсуждение в разделе 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
См. также
Справочные материалы
Элементы SPBackupRestoreSettings
Пространство имен Microsoft.SharePoint.Administration.Backup