Utilisation de Stsadm.exe pour effectuer une migration des données de site

Windows SharePoint Services 3

L'application d'administration Windows SharePoint Services Stsadm.exe fournit désormais une opération d'export prenant en charge le déplacement de contenu vers un package de migration de contenu et une opération d'import de complément prenant en charge l'importation et la décompression du contenu du package sur le site de destination.

Cette rubrique porte uniquement sur les opérations d'export et d'import dans Stsadm.exe.

Remarque Remarque :

Ces nouvelles opérations dans Stsadm.exe remplacent les fonctionnalités précédemment fournies dans l'utilitaire Smigrate.exe.

Limitations de l'utilisation de Stsadm.exe pour la migration de contenu

Stsadm.exe offre une méthode simple pour migrer le contenu d'une collection de sites Windows SharePoint Services vers une autre via des opérations d'importation et d'exportation. Toutefois, malgré leur facilité et leur simplicité d'utilisation, ces méthodes présentent des limites :

  • Stsadm ne prend en charge que le déplacement de sites Web complets (instances SPWeb). Il n'est pas possible d'exporter des éléments ou des listes sélectionnés. Par conséquent, Stsadm ne prend pas en charge la mise à jour sélective du contenu de site. Dans les cas où vous devez exporter uniquement des éléments sélectionnés, utilisez les classes de l'espace de noms Microsoft.SharePoint.Deployment.

  • Vous ne pouvez pas conserver les GUID (identificateurs globaux uniques) d'objet lors de la migration des objets de site. De nouveaux identificateurs sont ajoutés à la cible de migration.

  • Vous pouvez rencontrer des problèmes si vous réexécutez Stsadm sur du contenu de site qui a déjà été importé. Dans ce cas, tous les éléments de liste autres que des bibliothèques de documents sont dupliqués sur le site cible.

  • D'autres limites mineures sont imposées par les paramètres d'opération. Par exemple, bien que le modèle objet de migration fournisse environ 25 paramètres d'exportation/d'importation, les opérations équivalentes dans Stsadm en fournissent seulement 10. De plus, dans certains cas, les paramètres fournis dans Stsadm sont quelque peu limités. Pour appliquer les paramètres de sécurité par exemple, Stsadm ne propose que deux options : « aucune sécurité » ou « toutes les sécurités ». Veillez à bien connaître les opérations Stsadm et leurs paramètres avant de les utiliser pour la migration de contenu.

Localisation de Stsadm.exe

Par défaut, le programme Stsadm.exe est installé dans le répertoire %systemdrive%\Program Files\Common Files\Microsoft Shared\web server extensions\12\BIN .

Grammaire d'usage

Windows SharePoint Services 3.0 ajoute deux nouvelles commandes prenant en charge la migration : export et import. La grammaire utilisée pour l'appel des opérations est très simple :

   stsadm.exe -o <operation> [<parameter>]
   stsadm.exe -help [<operation>]

Stsadm.exe -o export

Exporte le contenu d'un site Web Windows SharePoint Services (SPWeb), avec le schéma de site, vers un ou plusieurs fichiers package (.cmp) de migration de contenu.

Paramètres

-url <URL>

Obligatoire. Spécifie l'URL du site Web Windows SharePoint Services (SPWeb) à exporter.

-filename <nom_fichier>

Obligatoire. Spécifie le nom de fichier du fichier .cmp dans lequel les données du site sont exportées.

Remarque Remarque :

Si vous définissez le paramètre -nofilecompression, le répertoire d'exportation spécifié devient la valeur du paramètre -filename.

Le paramètre -filename prend un paramètre ,-overwrite facultatif, qui indique à l'opération d'exportation de remplacer n'importe quelle version précédente du fichier .cmp portant le même nom de fichier.

-overwrite

Indique à l'opération d'exportation de remplacer la version précédente du package de migration utilisant le même nom de fichier que le fichier .cmp.

-includeusersecurity

Spécifie s'il faut inclure des informations de sécurité et des données utilisateurs.

Remarque Remarque :

Pour conserver les horodatages, les informations de sécurité et les données utilisateur, vous devez utiliser le paramètre -includeusersecurity.

-haltonwarning

Indique à l'opération d'exportation de se terminer lorsqu'un avertissement système se produit.

-haltonfatalerror

Indique à l'opération d'exportation de se terminer lorsqu'une erreur système se produit.

-nofilecompression

Indique à l'opération d'exportation de ne pas compresser le fichier de package de migration.

-nologfile

Indique à l'opération d'exportation de ne pas fournir de fichier journal pour les événements d'exportation. Notez que la désactivation du fichier journal n'offre qu'un gain de performance minime ; cette option est déconseillée.

Par défaut, Stsadm.exe crée un fichier journal. Cet outil place le fichier dans le même répertoire que le fichier .cmp, ou dans le répertoire d'exportation si le paramètre -nofilecompression est sélectionné. Stsadm signale les noms des fichiers journaux à la fin.

-versions <1, 2, 3, 4>

Fournit des informations sur la gestion des versions des données dans le fichier .cmp :

  • 1   Spécifie la dernière version principale des fichiers et des éléments de liste (valeur par défaut).

  • 2     Spécifie la version actuelle, la dernière version principale ou la dernière version secondaire.

  • 3    Spécifie la dernière version principale et les dernières versions secondaires des fichiers et des éléments de liste.

  • 4     Spécifie toutes les versions des fichiers et des éléments de liste.

-cabsize <entier>

Spécifie la taille maximale du fichier .cmp en mégaoctets. La plage est comprise entre 1 et 1 024 Mo. Si les données d'exportation dépassent le maximum spécifié, les données sont divisées en plusieurs fichiers.

-quiet

Indique à l'opération d'exportation de ne fournir aucune sortie à l'écran. Ce paramètre n'offre qu'un gain de performance minime.

Stsadm.exe -o import

Importe et décompresse le fichier de package de migration de contenu (.cmp) et charge les données de site comme indiqué dans le schéma de site.

Paramètres

-url <URL>

Obligatoire. Spécifie l'URL du site Web Windows SharePoint Services (SPWeb) dans lequel les données sont importées.

-filename <nom_fichier>

Obligatoire. Spécifie le nom de fichier du fichier .cmp à importer.

Remarque Remarque :

Si vous définissez le paramètre -nofilecompression, le répertoire d'importation spécifié devient la valeur du paramètre -filename.

-includeusersecurity

Indique s'il faut inclure des informations de sécurité et des données d'utilisateurs à l'importation.

Remarque Remarque :

Pour conserver les horodatages, les informations de sécurité et les données utilisateur, vous devez utiliser le paramètre -includeusersecurity.

-haltonwarning

Indique à l'opération d'importation de se terminer lorsqu'un avertissement système se produit.

-haltonfatalerror

Indique à l'opération d'importation de se terminer lorsqu'une erreur système se produit.

-nofilecompression

Vous devez définir ce paramètre s'il a été utilisé pendant l'exportation.

-nologfile

Indique à l'opération d'importation de ne pas fournir de fichier journal pour les événements d'importation. Par défaut, Stsadm.exe crée un fichier journal.

-updateversions <1, 2, 3, 4>

Indique comment mettre à jour des données dans le fichier .cmp :

  • 1    Indique à l'opération d'importation d'ajouter de nouveaux spécificateurs de version au fichier actif (valeur par défaut).

  • 2    Indique à l'opération d'importation de remplacer le fichier et toutes ses versions (supprimer le fichier, puis insérer le fichier).

  • 3   Indique à l'opération d'importation d'ignorer le fichier existant.

  • 4    Indique à l'opération d'importation de se terminer si des conflits de fichiers sont détectés.

-quiet

Indique à l'opération d'exportation de ne fournir aucune sortie à l'écran. Ce paramètre n'offre qu'un gain de performance minime.

Voir aussi

Afficher: