Restore : opération Stsadm (Office SharePoint Server)
Mise à jour : 2009-09-24
Nom d’opération : restore
Si le paramètre url est utilisé, la collection de sites est restaurée. En revanche, lorsque le paramètre restoremethod est utilisé, il est possible de procéder à une restauration d’une base de données individuelle, d’une application Web ou de l’intégralité de la batterie de serveurs. Si vous souhaitez remplacer une collection de sites existante, utilisez le paramètre overwrite.
Syntaxe
Pour la restauration de la collection de sites
stsadm -o restore
-url <Nom de l’URL>
-filename <nom de fichier>
[-hostheaderwebapplicationurl] <URL de l’application Web>
[-overwrite]
Pour une restauration d’urgence
stsadm -o restore
-directory <chemin UNC>
-restoremethod {overwrite | new}
[-backupid] <GUID issu du paramètre backuphistory, voir stsadm -help backuphistory>
[-item] <chemin d’accès créé à partir de l’arborescence>
[-percentage] <entier compris entre 1 et 100>
[-showtree]
[-suppressprompt]
[-username] <nom d’utilisateur>
[-password] <mot de passe>
[-newdatabaseserver] <nom du nouveau serveur de bases de données>
[-preservechangelog]
[-quiet]
Paramètres
| Paramètre | Valeur | Obligatoire ? | Description |
|---|---|---|---|
url |
Une URL valide, telle que http://nom_serveur/sites/nom_site |
Oui |
Spécifie l’URL à laquelle la sauvegarde de la collection de sites doit être restaurée. |
filename |
Nom de fichier valide du fichier de restauration de la collection de sites, tel que « Nom_site.bak » |
Oui |
Spécifie le chemin d’accès et le nom du fichier qui contient la sauvegarde de la collection de sites. |
hostheaderwebapplicationurl |
URL valide attribuée à l’application Web en utilisant un mappage des accès de substitution, par exemple « http://*nom_serveur* » |
Non |
Restaure une collection de sites en tant que collection de sites nommée par l’hôte, plutôt que collection de sites basée sur un chemin d’accès. Lorsque le paramètre -hostheaderwebapplicationurl est présent, la valeur du paramètre -url est l’URL de la collection de sites nommée par l’hôte, tandis que la valeur du paramètre -hostheaderwebapplicationurl est l’URL de l’application Web qui contiendra la collection de sites nommée par l’hôte. |
overwrite |
<aucune> |
Non |
Remplace une collection de sites existante se trouvant actuellement à l’emplacement spécifié par le paramètre url par la collection de sites stockée dans le fichier de sauvegarde. |
directory |
L’un des chemins d’accès valides :
Notes Les dossiers spbr* sont automatiquement créés. |
Oui |
Chemin d’accès où Microsoft Office SharePoint Server 2007 stocke le package de sauvegarde d’urgence généré pendant l’opération stsadm -o backup. Il s’agit du dossier parent des dossiers spbr*. Si vous disposez d’un ordinateur sur lequel sont installés Microsoft SQL Server 2005 et une instance d’Office SharePoint Server 2007, vous pouvez utiliser des chemins d’accès de lecteurs locaux. Cela comprend une installation de base. Toutefois, si SQL Server 2005 et Office SharePoint Server 2007 sont installés sur plusieurs ordinateurs, vous devez utiliser les chemins de partage UNC (Universal Naming Convention) afin que les composants de recherche et la base de données SQL soient lus à partir du même emplacement (par exemple, \\*nom_ordinateur*\volume\Backup). Plusieurs packages de sauvegarde peuvent être stockés au même emplacement. Il s’agit du même chemin d’accès que celui que vous transmettez au paramètre -directory de l’opération stsadm -o restore. |
restoremethod |
Peut être indifféremment :
|
Oui |
Spécifie le type de restauration de batterie de serveurs à effectuer (overwrite ou new). La valeur overwrite restaure le contenu et les paramètres à leur emplacement d’origine. Ce paramètre ne doit être utilisé que dans une restauration d’urgence au sein de la même batterie de serveurs. Si la valeur overwrite est utilisée, une invite de confirmation s’affiche. Pour supprimer l’invite, utilisez le paramètre suppressprompt. La valeur new spécifie que le contenu sera restauré à un nouvel emplacement et est conçue pour être utilisée lors d’une restauration sur une batterie de serveurs différente (par exemple, un nouveau serveur de bases de données). |
backupid |
GUID valide, tel que « 12345678-90ab-cdef-1234-567890abcdef » |
GUID du package de sauvegarde à restaurer. Chaque package de sauvegarde est associé à un GUID unique. Pour connaître le GUID, il est nécessaire d’examiner l’historique de sauvegarde par le biais de l’opération stsadm -o backuphistory. Si ce paramètre n’est pas spécifié, le package de la sauvegarde la plus récente sera utilisé. |
|
item |
Élément valide, tel que : Web Application\SharePoint-80 |
Non |
Indique quelle partie de la batterie de serveurs doit être restaurée. Vous pouvez utiliser la notation de chemin d’accès de batterie de serveurs complète telle qu’affichée par le paramètre showtree ou le nom du composant cible dans le chemin d’accès si ce composant possède un nom unique. Placez l’élément ou le chemin d’accès entre guillemets doubles s’il contient un espace. Si ce paramètre est absent, tous les éléments du package de sauvegarde sont restaurés. |
percentage |
Valeur entière comprise entre 1 et 100 La valeur par défaut est 5. |
Non |
Permet d’afficher les mises à jour de l’avancement de l’opération restore selon un incrément défini par ce pourcentage (par exemple, une valeur de « 5 » permet d’afficher les mises à jour de l’avancement de la restauration par incréments d’achèvement de 5 %, tandis qu’une valeur de « 10 » permet de les afficher par incréments d’achèvement de 10 %). Notes Ce pourcentage n’est pas précis et les mises à jour de l’avancement réel peuvent être inférieures ou supérieures à celles demandées. Dans le cas d’une base de données très volumineuse, 1 est la valeur optimale que vous devez utiliser pour l’affichage des mises à jour. La valeur par défaut est 5. |
showtree |
<aucune> |
Non |
Indique les éléments du package de sauvegarde qui seraient restaurés suivant tous les autres paramètres transmis à l’opération stsadm -o restore. Les éléments qui seront exclus de la restauration en fonction des autres paramètres passés à l’opération Restore seront précédés d’un astérisque. Les éléments qui ne peuvent pas être sélectionnés pour la restauration seront placés entre crochets ([]). Une restauration ne sera pas effectuée si le paramètre showtree est présent. |
suppressprompt |
<aucune> |
Non |
Empêche l’affichage de l’invite de ligne de commande suivante : « Avertissement : tous les composants sélectionnés seront remplacés. Souhaitez-vous qu’ils soient remplacés (O/N) ? » Ce paramètre n’est valide que lorsque la valeur du paramètre restoremethod est définie sur overwrite. |
username |
Pour l’authentification SQL, nom d’utilisateur valide de la forme *nom_utilisateur* |
Non |
Définit le même nom d’utilisateur pour tous les objets en cours de restauration qui nécessitent un nom d’utilisateur, y compris les pools d’applications Web. Si une batterie de serveurs entière est restaurée, ce paramètre ne doit être utilisé que par les batteries de serveurs qui utilisent l’authentification Windows pour se connecter à une base de données. Si seulement une base de données est restaurée, vous pouvez fournir un nom de connexion SQL Server 2005. |
password |
Non |
Définit le même mot de passe pour tous les objets en cours de restauration qui nécessitent un mot de passe, y compris les pools d’applications Web. Si une batterie de serveurs entière est restaurée, ce paramètre ne doit être utilisé que par les batteries de serveurs qui utilisent l’authentification Windows pour se connecter à une base de données à l’aide de SQL Server 2005. Si seulement une base de données est restaurée, vous pouvez fournir un mot de passe de connexion SQL Server 2005. |
|
newdatabaseserver |
Nom de serveur de bases de données valide, tel que « SQLBE1 » |
Non |
Indique le nom d’instance de SQL Server 2005 à utiliser lors de la restauration de bases de données si la valeur du paramètre restoremethod est new. Ce paramètre n’est pas valide si la valeur du paramètre restoremethod est overwrite. Par défaut, vous êtes invité à indiquer un nouveau nom de serveur de bases de données pour chaque base de données. |
preservechangelog |
<aucune> |
Non |
Conserve le journal des modifications afin que l’analyse suivante de cette base de données de contenu ne soit pas une analyse complète. Ce paramètre a été introduit pour la première fois dans la Mise à jour d’infrastructure pour les produits serveur de Microsoft Office. Pour plus d’informations, voir les remarques. |
quiet |
<aucune> |
Non |
Supprime de la fenêtre d’affichage les informations d’avancement de la restauration. L’état de restauration final (« L’opération s’est déroulée avec succès ») reste affiché. Si le paramètre -quiet est absent, l’opération restore affiche les informations d’avancement dans la fenêtre d’affichage à mesure qu’elle restaure le package. |
Remarques
Si vous exécutez la Mise à jour d’infrastructure pour les produits serveur de Microsoft Office, l’identificateur (ID) de chaque base de données de contenu est conservé lorsque vous restaurez ou rattachez la base de données à l’aide des outils intégrés. Si vous utilisez les outils intégrés, la rétention du journal des modifications s’effectue par défaut comme suit :
Les journaux des modifications de toutes les bases de données sont conservés lorsque vous restaurez une batterie de serveurs.
Le journal des modifications d’une base de données de contenu est conservé lorsque vous rattachez la base de données.
Le journal des modifications d’une base de données de contenu N’EST PAS conservé lorsque vous restaurez uniquement la base de données de contenu. C’est dans ce cas que vous devez utiliser le paramètre preservechangelog.
Lorsqu’un ID de base de données et un journal des modifications sont conservés, la recherche continue l’analyse en suivant la fréquence définie par les règles d’analyse. Lorsqu’un journal des modifications n’est pas conservé, la recherche effectue une analyse complète pendant l’analyse planifiée suivante.
Pour plus d’informations, voir Déplacer des bases de données de contenu (Office SharePoint Server 2007) et Sauvegarder et restaurer une batterie de serveurs entière (Office SharePoint Server 2007).
Lorsque vous restaurez une base de données existante et que vous ne spécifiez pas la valeur overwrite pour le paramètre restoremethod lorsque vous exécutez l’opération stsadm –o restore, un nouvel ID est attribué à la base de données restaurée et le journal des modifications de la base de données n’est pas conservé. L’analyse suivante de la base de données indexera intégralement la base de données de contenu.
Si une restauration est effectuée et que l’ID dans le package de sauvegarde est déjà utilisé dans la batterie de serveurs (par exemple, si vous tentez de fractionner une base de données en deux), un nouvel ID est attribué à la base de données restaurée et un avertissement est ajouté au journal de restauration. Vous ne pouvez effectuer une analyse incrémentielle au lieu d’une analyse complète que si l’ID de base de données de contenu est le même qu’auparavant et que le jeton du journal des modifications utilisé par la recherche est valide pour le journal des modifications actuel dans la base de données de contenu. Si le journal des modifications n’est pas conservé, le jeton n’est pas valide et la recherche doit effectuer une analyse complète.