Partager via

Import-SPWeb

Module:
SharePointServer module

Importe un site web, une liste ou une bibliothèque.

Syntaxe

Default (Par défaut) 

Import-SPWeb
    [-Identity] <SPWebPipeBind>
    -Path <String>
    [-ActivateSolutions]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Force]
    [-HaltOnError]
    [-HaltOnWarning]
    [-IncludeUserCustomAction <SPIncludeUserCustomAction>]
    [-IncludeUserSecurity]
    [-NoFileCompression]
    [-NoLogFile]
    [-UpdateVersions <SPUpdateVersions>]
    [-WhatIf]
    [-PreserveDeletedUserMetadataReferences]
    [<CommonParameters>]

Description

La cmdlet Import-SPWeb permet d'importer un site web, une liste ou une bibliothèque. La fonctionnalité d’importation à partir d’une bibliothèque est une nouvelle fonctionnalité des produits SharePoint.

Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

EXEMPLE

Import-SPWeb https://site -Path export.cmp -UpdateVersions Overwrite

Cet exemple montre comment importer le contenu du fichier export.cmp dans un site à l'adresse https://site et remplace le contenu de la version présente sur le site par le contenu du fichierexport.cmp.

Paramètres

-ActivateSolutions

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie si des solutions utilisateur sont activées durant l'importation.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AssignmentCollection

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

Propriétés du paramètre

Type:SPAssignmentCollection
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Force

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Ce paramètre n’a aucune fonction dans cette applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-HaltOnError

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Interrompt le processus d'importation en cas d'erreur.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-HaltOnWarning

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Interrompt le processus d'importation en cas d'avertissement.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie l'URL ou le GUID du site web d'importation.

Le type doit être une URL, un GUID ou un objet valide. Par exemple, une URL valide au format https://server_name, ou un GUID au format 1234-4567-5678a.

Propriétés du paramètre

Type:SPWebPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IncludeUserCustomAction

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie si les actions personnalisées de l'utilisateur sont incluses durant l'importation.

Les valeurs valides sont les suivantes :

All, None

Propriétés du paramètre

Type:SPIncludeUserCustomAction
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IncludeUserSecurity

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Conserve les paramètres de sécurité utilisateur.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-NoFileCompression

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Active ou désactive la compression des fichiers dans le package d'importation. Le package d'importation est stocké dans le dossier spécifié par le paramètre Path ou Identity. Pour des raisons de performances, nous vous recommandons d'utiliser ce paramètre. L'activation de la compression peut allonger la durée du processus d'importation d'environ 30 %.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-NoLogFile

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Empêche la génération d'un fichier journal d'importation. Si ce paramètre n'est pas spécifié, la cmdlet Import-SPWeb génère un fichier journal d'exportation au même emplacement que le package d'exportation. Le fichier journal utilise le service ULS (Unified Logging Service).

Nous vous recommandons d'utiliser ce paramètre. Cependant, pour des raisons de performances, il peut parfois être utile de ne pas générer de fichier journal.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Path

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Indique le nom du fichier d'importation.

Si vous utilisez le paramètre NoFileCompression, vous devez spécifier un répertoire. Dans le cas contraire, tous les formats de fichiers sont valides.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PreserveDeletedUserMetadataReferences

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Tente d’opuler le champ « Auteur » (« Créé par ») pour les éléments même si l’objet SPUser a été marqué comme supprimé sur le site de destination.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-UpdateVersions

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Indique comment résoudre les situations où un fichier à importer dans un site existe déjà dans celui-ci. Si le paramètre UpdateVersions est absent, l’opération d’importation utilise par défaut la valeur 1 (Append).

Le type doit être l'un des suivants :

-Append, qui ajoute de nouvelles versions au fichier actuel

-Remplacer le fichier et toutes ses versions (supprimer, puis insérer)

-Ignorer le fichier s’il existe sur la destination

La valeur par défaut est Ajouter de nouvelles versions au fichier actif.

Les valeurs valides sont les suivantes :

Append, Ignore, Overwrite

Propriétés du paramètre

Type:SPUpdateVersions
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.