Programação com o modelo de objeto de backup/restauração de serviços SharePoint Windows
Este tópico descreve a arquitetura do de backup e modelo de objeto restaurar em Windows SharePoint Services 3.0 e fornece alguns conselhos sobre como programa contra ele. O de backup aplicativo pode ser um aplicativo independente ou uma extensão do Stsadm.exe ferramenta de linha de comando. Para obter mais informações sobre como estender stsadm, consulte Como a: estender o utilitário STSADM.
O backup e do modelo de objeto de restauração
O parte superior do objeto modelo é o SPBackupRestoreConsole T:Microsoft.SharePoint.Administration.Backup.SPBackupRestoreConsole classe. (Consulte texto explicativo 1 no Figure 1). Ele fornece uma Gerenciador de operações do guarda-sol responsável para fila trabalhos de backup e restaurar, iniciando trabalhos e aceitar um histórico dos trabalhos na forma de arquivos .xml. Um objeto dessa classe é "apenas sob a superfície" da interface do usuário de de backup um aplicativo. Seus membros são principalmente métodos estáticos e propriedades que fornecem ganchos para o interface do usuário do de backup aplicativo. Tanto o aplicativo Central Administration o Stsadm.exe ferramenta de linha de comando usam essas ganchos.
Somente um objeto desta classe existe em um farm, e ela é criada o tempo primeiro um dos seus membros é chamado. Ele permanece na memória até o próximo tempo é Internet Information Server (IIS) redefinir; No entanto, seu vestígios memória é pequeno.
Figura 1. O primário objetos na de backup/hierarquia restaurar.
.gif "The major classes in the backup object model.")
Cada de backup específico ou operação restaurar é representada por um objeto da classe SPBackupRestoreConsoleObject criado pelo CreateBackupRestore M:Microsoft.SharePoint.Administration.Backup.SPBackupRestoreConsole.CreateBackupRestore método do objeto de console. (Consulte texto explicativo 2 em Figure 1, o enfileirado de backup e restaurar operações.) As propriedades de um desses objetos Lightweight mantenha informações sobre a operação, tais enquanto se ele é um de backup ou um restaurar, a localidade do de backup arquivos, o método de backup ou restaurar, o atual estágio da operação e a árvore de de conteúdo componentes que está sendo feito backup ou restaurado. Each of these objects also has an Id property of type Guid that serves as a handle for the object that can be passed to the methods of SPBackupRestoreConsole. For example, Run is passed the ID of the operation (that is, the SPBackupRestoreConsoleObject object) that the console is to run next. Finalmente, cada SPBackupRestoreConsoleObject possui um Settings P:Microsoft.SharePoint.Administration.Backup.SPBackupRestoreConsoleObject.Settings propriedade que contém um objeto persistentes que contém um padrão reutilizável de de backup ou restaurar Configurações. Esse objeto também identifica o de conteúdo componente que a operação é voltar Up ou restaurar. Os objetos configurações são discutidos em detalhes mais próximo ao final dessa seção.
Although the SPBackupRestoreConsoleObject objects represent operations, the content components themselves are represented by SPBackupRestoreObject objects. (Consulte texto explicativo 3 em Figure 1). Esses objetos podem ser aninhados com o Children P:Microsoft.SharePoint.Administration.Backup.SPBackupRestoreObject.Children propriedade. Portanto, cada uma delas representa uma árvore de de conteúdo um ou mais componentes. De exemplo, um aplicativo da Web poderia ser representado por um objeto SPBackupRestoreObject T:Microsoft.SharePoint.Administration.Backup.SPBackupRestoreObject que possui cada uma das de conteúdo do o aplicativo da Web bancos de dados como objetos SPBackupRestoreObject T:Microsoft.SharePoint.Administration.Backup.SPBackupRestoreObject filho. A árvore dos componentes que são o assunto de uma determinada operação de backup ou restaurar internamente são vinculados o objeto SPBackupRestoreConsoleObject T:Microsoft.SharePoint.Administration.Backup.SPBackupRestoreConsoleObject que representa a operação. You can get a reference to the topmost SPBackupRestoreObject object in the tree by passing the ID of the SPBackupRestoreConsoleObject object to the GetRoot method.
Um objeto SPBackupRestoreObject T:Microsoft.SharePoint.Administration.Backup.SPBackupRestoreObject é um contêiner para crítico dois tipos de objetos:
In its Information property the SPBackupRestoreObject object holds either an SPBackupInformation or an SPRestoreInformation object. Esses tipos de objetos armazenar informações sobre como voltar Up ou restaurar um componente específico e métodos que podem ser chamado internamente por SPBackupRestoreConsoleObject e SPBackupRestoreObject como parte de uma operação. Mais especificamente, essas classes mantenha os métodos e propriedades cuja implementação deve nunca alteração regardless of o tipo de de conteúdo componente está sendo representado. Portanto, elas são lacradas; derivar uma nova classe de seu pai, SPBackupRestoreInformation, não é com suporte.
In its IBackupRestore property the SPBackupRestoreObject object holds an object that implements the IBackupRestore interface (and might also inherit from SPPersistedObject). (Consulte texto explicativo 4 na Figure 1). Implementação de interface último transforma um objeto em algo que potencialmente podem ser submetidos a backup e restauradas. Como um objeto SPBackupRestoreInformation T:Microsoft.SharePoint.Administration.Backup.SPBackupRestoreInformation, um objeto IBackupRestore T:Microsoft.SharePoint.Administration.Backup.IBackupRestore contém membros que fornecem informações e métodos necessários para backups e restaurações. Mas os membros de IBackupRestore devem ser fornecidos implementações diferentes dependendo do tipo de de conteúdo componente sendo representado. Most importantly, the implementation includes event handlers for an operation's events, such as OnBackup and OnRestore.
Besides acting as a container, SPBackupRestoreObject is a helper class that provides easier interaction between the operation objects (SPBackupRestoreConsoleObject), on the one hand, and the component information objects (SPBackupRestoreInformation and IBackupRestore), on the other.
O principal final classes são SPBackupSettings e SPRestoreSettings. Um objeto de um desses dois tipos é passado para o CreateBackupRestore método M:Microsoft.SharePoint.Administration.Backup.SPBackupRestoreConsole.CreateBackupRestore quando uma operação é criada. (Consulte texto explicativo 5 em Figure 1). Cada um desses objetos contém configurações para uso nas operações; Principalmente, eles identificam, em seus IndividualItem P:Microsoft.SharePoint.Administration.Backup.SPBackupRestoreSettings.IndividualItem propriedade, o de conteúdo componente que é o assunto da operação de de backup ou restaurar. (Consulte texto explicativo 6 em Figure 1).
Conselhos de programação
As seguinte informações podem ser útil para o desenvolvimento de soluções de de backup e restaurar.
Maneiras de personalização
A maior parte do crítico classes na de backup/modelo de objeto restaurar são lacradas ( NotInheritable na Microsoft Visual Basic). Além disso, embora o seguinte classes não estão lacradas, a derivação a partir deles não é com suporte. Em cada maiúsculas e minúsculas, você deve usar o derivado existente classes:
SPBackupRestoreInformation Existing derived classes: SPBackupInformation and SPRestoreInformation
SPBackupRestoreSettings Existing derived classes: SPBackupSettings and SPRestoreSettings
Da mesma forma, há apenas dois primário pontos de personalização:
Você pode criar seu próprio aplicativo de alto nível (e interface do usuário) que usa os métodos estáticos do console de operações ? um objeto SPBackupRestoreConsole T:Microsoft.SharePoint.Administration.Backup.SPBackupRestoreConsole ? para gerenciar e executar trabalhos de backup e restaurar. Para obter mais informações sobre como fazer isso, consulte Como: de forma programática fazer backup de conteúdo e Como: de forma programática restaurar conteúdo.
Você pode criar uma classe que implementa a interface IBackupRestore T:Microsoft.SharePoint.Administration.Backup.IBackupRestore e podem ou talvez não derivar também o SPPersistedObject T:Microsoft.SharePoint.Administration.SPPersistedObject classe. Para obter mais informações sobre como criar um personalizado de conteúdo classe, consulte Como a: criar uma classe de conteúdo que pode ser feita e restaurada.
Permissões
O código que faz backup de conteúdo deve executar no contexto de usuário de um administrador farm. O código que restaura deve executar no contexto de um usuário que é um administrador farm e um administrador em todos os servidores front-end. O usuário também deve ter ler e permissões de gravação para o de backup localidade.
O log de falha
Se uma operação de backup ou restaurar falhar, detalhes sobre a falha são registrados no spbackup.log ou sprestore.log na de backup localidade.
Backups e restaurações de coleções de sites
EXCEPT for personalizado de conteúdo tipos que você crie implementando IBackupRestore, o de conteúdo menor objeto que você pode voltar e restaurar com as classes no Microsoft.SharePoint.Administration.Backup espaço para nome é um de conteúdo banco de dados. To programmatically backup or restore individual site collections, use Backup and Restore. Para obter mais informações sobre como fazer backup e restaurar site coleções, consulte Como: de forma programática fazer backup e restauração de uma coleção de site único.
Consulte também
Tarefas
Como: de forma programática fazer backup de conteúdo
Como: de forma programática restaurar conteúdo
Como: de forma programática fazer backup e restauração de uma coleção de site único
Como a: criar uma classe de conteúdo que pode ser feita e restaurada
Como a: estender o utilitário STSADM
Referência
Microsoft.SharePoint.Administration.Backup
Backup
Restore