Remarque : l’intégration PowerShell nécessite un abonnement ShareGate Migrate Pro ou Enterprise . Elle n’est pas disponible avec le forfait Essentials.
Commande
Copy-Site
Description
Commande permettant de copier des sites d’un site SharePoint à un autre.
Remarques :
Puisque Insane mode est utilisé par défaut (sauf si -NormalMode est spécifié), la commande attend par défaut que l’importation Microsoft 365 Azure soit terminée avant de renvoyer un résultat. Utilisez -NoWaitForImportCompletion pour obtenir un retour immédiat après le traitement local à la place ; dans ce cas, le résultat renvoyé est provisoire (l’importation n’y est pas encore reflétée). Utilisez Wait-ImportCompletion, ou laissez la session PowerShell active, pour savoir quand l’importation est réellement terminée. Le paramètre -WaitForImportCompletion est désormais déprécié, puisque l’attente de la fin de l’importation est de nouveau le comportement par défaut.
ShareGate Migrate ne peut pas provisionner de collection de sites à l’aide de PowerShell. Si vous exécutez Copy-Site avec l’URL de votre administration centrale, de votre centre d’administration ou de votre collection de sites racine comme destination, vous risquez d’endommager la collection de sites racine.
Astuces :
Pour savoir comment adapter votre script
Copy-Siteafin d’effectuer une migration incrémentale, consultez Exécuter une migration incrémentale avec PowerShell.Pour savoir comment utiliser les options de copie avec PowerShell, consultez Options de copie dans PowerShell.
Exemples
Fusionner un site avec le site de destination, y compris ses sous-sites.
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite"
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
Copy-Site -Site $srcSite -DestinationSite $dstSite -Merge -Subsites
Copier un site en tant que sous-site du site de destination.
Copy-Site -Site $srcSite -DestinationSite $dstSite
Obtenir les sous-sites du site source et les copier vers le site de destination.
$toCopy = Get-Subsite -Site $srcSite
Copy-Site -Site $toCopy -DestinationSite $dstSite
Copier tous les sous-sites du site source vers le site de destination.
Copy-Site -All -SourceSite $srcSite -DestinationSite $dstSite
Exécuter une vérification préalable avant de copier un site en tant que sous-site.
Copy-Site -Site $srcSite -DestinationSite $dstSite -WhatIf
Copier certains sous-sites dont les noms correspondent aux modèles spécifiés.
Copy-Site -Name MyName*,MySpecificName -SourceSite $srcSite -DestinationSite $dstSite
Copier et renommer un sous-site.
Copy-Site -Name MyName*,MySpecificName -SourceSite $srcSite -DestinationSite $dstSite -SiteTitle MyNewName -SiteTitleUrlSegment MyNewUrl
Fusionner un site avec le site de destination, y compris ses sous-sites, et copier les étiquettes de confidentialité appliquées à la fois au contenu et à la structure.
Copy-Site -Site $srcSite -DestinationSite $dstSite -Merge -Subsites -IncludeStructureSensitivityLabel -IncludeContentSensitivityLabel
Copier un site sans attendre la fin de l’importation Microsoft 365 Azure, puis utiliser Wait-ImportCompletion pour savoir quand elle est terminée.
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite"
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
Copy-Site -Site $srcSite -DestinationSite $dstSite -NoWaitForImportCompletion
Wait-ImportCompletion
Syntaxe
Voici les ensembles de paramètres compatibles pour la commande Copy-Site.
Copy-Site
-Site <Site[]>-DestinationSite <Site>[-Merge <SwitchParameter>][-NoNavigation <SwitchParameter>][-Subsites <SwitchParameter>][-SiteTitle <String>][-SiteTitleUrlSegment <String>][-NoContent <SwitchParameter>][-VersionLimit <Int32>][-NoCustomPermissions <SwitchParameter>][-NoWorkflows <SwitchParameter>][-NoSiteFeatures <SwitchParameter>][-NoWebParts <SwitchParameter>][-NoNintexWorkflowHistory <SwitchParameter>][-UserAlerts <SwitchParameter>][-NormalMode <SwitchParameter>][-ForceNewListExperience <SwitchParameter>][-NoCustomizedListForms <SwitchParameter>][-NoListViews <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-WhatIf <SwitchParameter>][-TaskName <String>][-IncludeStructureSensitivityLabel <SwitchParameter>][-IncludeContentSensitivityLabel <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>]
Copy-Site
-Name <String[]>-SourceSite <Site>-DestinationSite <Site>[-Merge <SwitchParameter>][-NoNavigation <SwitchParameter>][-Subsites <SwitchParameter>][-SiteTitle <String>][-SiteTitleUrlSegment <String>][-NoContent <SwitchParameter>][-VersionLimit <Int32>][-NoCustomPermissions <SwitchParameter>][-NoWorkflows <SwitchParameter>][-NoSiteFeatures <SwitchParameter>][-NoWebParts <SwitchParameter>][-NoNintexWorkflowHistory <SwitchParameter>][-UserAlerts <SwitchParameter>][-NormalMode <SwitchParameter>][-ForceNewListExperience <SwitchParameter>][-NoCustomizedListForms <SwitchParameter>][-NoListViews <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-WhatIf <SwitchParameter>][-TaskName <String>][-IncludeStructureSensitivityLabel <SwitchParameter>][-IncludeContentSensitivityLabel <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>]
Copy-Site
-All <SwitchParameter>-SourceSite <Site>-DestinationSite <Site>[-Merge <SwitchParameter>][-NoNavigation <SwitchParameter>][-Subsites <SwitchParameter>][-SiteTitle <String>][-SiteTitleUrlSegment <String>][-NoContent <SwitchParameter>][-VersionLimit <Int32>][-NoCustomPermissions <SwitchParameter>][-NoWorkflows <SwitchParameter>][-NoSiteFeatures <SwitchParameter>][-NoWebParts <SwitchParameter>][-NoNintexWorkflowHistory <SwitchParameter>][-UserAlerts <SwitchParameter>][-NormalMode <SwitchParameter>][-ForceNewListExperience <SwitchParameter>][-NoCustomizedListForms <SwitchParameter>][-NoListViews <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-WhatIf <SwitchParameter>][-TaskName <String>][-IncludeStructureSensitivityLabel <SwitchParameter>][-IncludeContentSensitivityLabel <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>]
Vous pouvez obtenir la syntaxe de n’importe quelle commande PowerShell à l’aide du script suivant :
Get-Command Copy-Site -SyntaxParameters
Paramètres
-All <SwitchParameter>
Indique que tous les sous-sites seront copiés.
Obligatoire ? | True |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | All |
Alias | None |
-CopySettings <CopySettings>
Spécifie les paramètres de copie.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | True (ByValue, ByPropertyName) |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-DestinationSite <Site>
Spécifie le site de destination.
Obligatoire ? | True |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-ForceNewListExperience <SwitchParameter>
Indique que la commande convertira les listes vers la nouvelle expérience Microsoft 365 lorsque cela est possible.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-IncludeContentSensitivityLabel <SwitchParameter>
Indique que les étiquettes de confidentialité appliquées au contenu (les fichiers stockés dans les bibliothèques de documents, les dossiers étant exclus) sont copiées vers la destination à l’aide des mappages d’étiquettes de confidentialité. La source et la destination doivent toutes deux être SharePoint Online.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-IncludeStructureSensitivityLabel <SwitchParameter>
Indique que les étiquettes de confidentialité appliquées aux objets de structure (la collection de sites, son Microsoft 365 group connecté et les bibliothèques de documents) sont copiées vers la destination à l’aide des mappages d’étiquettes de confidentialité. La source et la destination doivent toutes deux être SharePoint Online.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-MappingSettings <MappingSettings>
Spécifie les paramètres de mappage.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-Merge <SwitchParameter>
Indique que le site doit être fusionné avec le site de destination au lieu d’être ajouté comme sous-site. Ce paramètre ne peut pas être utilisé lors de la copie de plusieurs sites.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-Name <String[]>
Spécifie le nom (les caractères génériques sont pris en charge).
Obligatoire ? | True |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | True |
Nom de l’ensemble de paramètres | Name |
Alias | None |
-NoContent <SwitchParameter>
Indique que tous les éléments de liste, documents, dossiers et jeux de documents contenus dans les listes et bibliothèques ne seront pas copiés.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-NoCustomizedListForms <SwitchParameter>
Indique que les formulaires de liste personnalisés et les formulaires de type de contenu ne seront pas copiés.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-NoCustomPermissions <SwitchParameter>
Indique que tous les éléments seront configurés pour hériter des autorisations de leur parent.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-NoListViews <SwitchParameter>
Indique que les affichages de liste ne seront pas copiés.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-NoNavigation <SwitchParameter>
Indique que les paramètres de navigation du site et de lancement rapide ne seront pas conservés lors de la copie. S’il est spécifié, ces paramètres seront réinitialisés aux valeurs par défaut dans le site de destination.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-NoNintexWorkflowHistory <SwitchParameter>
Indique que l’historique des workflows Nintex associés aux objets migrés ne sera pas copié vers la destination.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-NormalMode <SwitchParameter>
Indique que Normal mode doit être utilisé.
Remarque : Insane mode est toujours utilisé par défaut dans PowerShell.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-NoSiteFeatures <SwitchParameter>
Indique que toutes les fonctionnalités de site et de collection de sites requises par les éléments copiés ne seront pas activées automatiquement.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-NoWaitForImportCompletion <SwitchParameter>
Indique que la commande renvoie un résultat après le traitement local, sans attendre la fin de l’importation Azure en Insane mode.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-NoWebParts <SwitchParameter>
Indique que les composants WebPart ne seront pas copiés lors de la copie des pages.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-NoWorkflows <SwitchParameter>
Indique que les workflows associés aux objets migrés ne seront pas copiés vers la destination.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-Site <Site[]>
Spécifie le site source à copier.
Obligatoire ? | True |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | True (ByValue, ByPropertyName) |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | Default |
Alias | None |
-SiteTitle <String>
Spécifie le nouveau titre du site. Ce paramètre doit être utilisé avec le paramètre «SiteTitleUrlSegment» et ne peut pas être utilisé lors de la copie de plusieurs sites.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-SiteTitleUrlSegment <String>
Spécifie la nouvelle URL du site, relative à son site parent. Ce paramètre doit être utilisé avec le paramètre «SiteTitle» et ne peut pas être utilisé lors de la copie de plusieurs sites.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-SourceSite <Site>
Spécifie le site source.
Obligatoire ? | True |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | True (ByValue, ByPropertyName) |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | Name, All |
Alias | None |
-Subsites <SwitchParameter>
Indique que tous les sous-sites du site source seront copiés.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-TaskName <String>
Spécifie un nom pour la tâche.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-UserAlerts <SwitchParameter>
Indique que les alertes utilisateur associées aux objets migrés seront copiées vers la destination.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-VersionLimit <Int32>
Indique que les X dernières versions seront copiées, tout en conservant toujours au moins une version principale.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
-WhatIf <SwitchParameter>
Indique qu’une vérification préalable sera exécutée à la place d’une migration.
Obligatoire ? | False |
Valeur par défaut | None |
Entrée de pipeline acceptée ? | False |
Caractères génériques acceptés ? | False |
Nom de l’ensemble de paramètres | (All) |
Alias | None |
Cet article a été traduit à l’aide de l’intelligence artificielle. En cas de doute, référez-vous à la version originale en anglais.
