Remarque : L'intégration PowerShell nécessite un abonnement Pro ou Enterprise à ShareGate Migrate. Elle n'est pas disponible avec le plan Essentials.
Commande
Import-BoxDocument
Description
La commande pour importer des documents Box dans une bibliothèque SharePoint.
Remarque : Vous pouvez uniquement copier des documents Box.com avec PowerShell.
Conseils :
Pour savoir comment adapter n'importe quel script
Import-BoxDocumentafin d'effectuer une migration incrémentale, consultez Mise à jour incrémentale avec PowerShell.Pour en savoir plus sur les options de copie disponibles, consultez Options de copie dans PowerShell.
Si vous rencontrez d'importants problèmes de performance, consultez Limitation Box.com.
Exemples
Importer tous les documents
$box = Connect-Box -Email [email protected]$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"$dstList = Get-List -Name "mydstlib" -Site $dstSiteImport-BoxDocument -Box $box -DestinationList $dstList
Importer tous les documents d'un autre utilisateur en mode Admin
$box = Connect-Box -Email [email protected] -Admin
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$dstList = Get-List -Name "mydstlib" -Site $dstSite
Import-BoxDocument -Box $box -UserEmail [email protected] -DestinationList $dstList
Spécifier les dossiers source et destination
$box = Connect-Box -Email [email protected]
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$dstList = Get-List -Name "mydstlib" -Site $dstSite
Import-BoxDocument -Box $box -SourceFolder "MyFolder/DocumentsToImport" -DestinationList $dstList -DestinationFolder "MyFolder/MySubFolder"
Spécifier les chemins source à importer
$box = Connect-Box -Email [email protected]
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$dstList = Get-List -Name "mydstlib" -Site $dstSite
Import-BoxDocument -Box $box -DestinationList $dstList -SourceFilePath "MyFolder/DocumentsToImport/Document1.docx", "MyFolder/DocumentsToImport/Document2.docx"
Importer des documents avec un modèle de propriété
$propertyTemplate = New-PropertyTemplate -AuthorsAndTimestamps -VersionHistory -Permissions -NoLinkCorrection -FlattenFolders -VersionLimit 5 -CheckInAs Publish -ContentApproval SameAsCurrent -From "2012-01-01" -To "2012-12-31"
$box = Connect-Box -Email [email protected]
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$dstList = Get-List -Name "mydstlib" -Site $dstSite
Import-BoxDocument -Box $box -SourceFolder "MyFolder/DocumentsToImport" -DestinationList $dstList -Template $propertyTemplate
Importer des documents avec des mappages de propriétés.
$box = Connect-Box -Email [email protected]
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$dstList = Get-List -Name "mydstlib" -Site $dstSite
$mappings = Get-PropertyMapping -Box $box -DestinationList $dstList
$mappings = Set-PropertyMapping -MappingSettings $mappings -Source "CustomData1" -Destination "CustomData1"
$dstList = Get-List -Name "mydstlib" -Site $dstSite
Import-BoxDocument -Box $box -DestinationList $dstList -MappingSettings $mappings
Dans ce cas, CustomData1 correspond à des métadonnées personnalisées sur certains fichiers Box. Elles doivent être mappées explicitement, car Get-PropertyMapping ne parcourt pas tous les fichiers Box pour trouver tous vos champs Box.
Si vos métadonnées font partie d'un modèle de métadonnées non global dans Box, vous devez suivre ce format lors de la configuration du mappage des propriétés : templateName_metadataFieldName.
Les métadonnées personnalisées non mappées se retrouvent dans la colonne UnmappedCustomMetadata, qui peut être mappée à un champ de type plusieurs lignes de texte à la destination.
Pré-vérification de l'importation de tous les documents
$box = Connect-Box -Email [email protected]
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$dstList = Get-List -Name "mydstlib" -Site $dstSite
Import-BoxDocument -Box $box -DestinationList $dstList -WhatIf
Syntaxe
Voici les ensembles de paramètres compatibles pour la commande Import-BoxDocument.
Import-BoxDocument
-Box <BoxInfo>
-DestinationList <List>
[-UserEmail <String>]
[-DestinationFolder <Uri>]
[-SourceFolder <Uri>]
[-TemplateName <String>]
[-NormalMode <SwitchParameter>]
[-WaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]
Import-BoxDocument
-Box <BoxInfo>
-DestinationList <List>
-Template <PropertyTemplate>
[-UserEmail <String>]
[-DestinationFolder <Uri>]
[-SourceFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-WaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]
Import-BoxDocument
-Box <BoxInfo>
-DestinationList <List>
-Template <PropertyTemplate>
-SourceFilePath <Uri[]>
[-UserEmail <String>]
[-DestinationFolder <Uri>]
[-SourceFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-WaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]
Import-BoxDocument
-Box <BoxInfo>
-DestinationList <List>
-SourceFilePath <Uri[]>
[-UserEmail <String>]
[-DestinationFolder <Uri>]
[-SourceFolder <Uri>]
[-TemplateName <String>]
[-NormalMode <SwitchParameter>]
[-WaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]
Import-BoxDocument
-Box <BoxInfo>
-DestinationList <List>
[-UserEmail <String>]
[-DestinationFolder <Uri>]
[-TemplateName <String>]
[-NormalMode <SwitchParameter>]
[-WaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]
Import-BoxDocument
-Box <BoxInfo>
-DestinationList <List>
-Template <PropertyTemplate>
[-UserEmail <String>]
[-DestinationFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-WaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]
Paramètres
-Box <BoxInfo>
Spécifie le Box source.
Obligatoire ? | Oui |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Oui (ByValue, ByPropertyName) |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
-CopySettings <CopySettings>
Spécifie les paramètres de copie.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Oui (ByValue, ByPropertyName) |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
-DestinationFolder <Uri>
Spécifie le chemin du dossier à la destination. Remarque : Ce paramètre ne peut pas être utilisé pour créer de nouveaux dossiers à la destination.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
-DestinationList <List>
Spécifie la liste de destination.
Obligatoire ? | Oui |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Oui (ByValue, ByPropertyName) |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
-MappingSettings <MappingSettings>
Spécifie les paramètres de mappage.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
-NormalMode <SwitchParameter>
Spécifie que le mode normal doit être utilisé.
Remarque : Insane mode est toujours utilisé par défaut dans PowerShell.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
-SourceFilePath <Uri[]>
Spécifie le chemin du fichier source.
Obligatoire ? | Oui |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | TemplateSourceFilePath, TemplateNameSourceFilePath |
Alias | Aucun |
-SourceFolder <Uri>
Spécifie le chemin du dossier à la source.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | Default, Template, TemplateSourceFilePath, TemplateNameSourceFilePath |
Alias | Aucun |
-TaskName <String>
Spécifie un nom pour la tâche.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
-Template <PropertyTemplate>
Spécifie le modèle de propriété. Pour utiliser le modèle intégré "Full Copy", ne spécifiez pas ce paramètre.
Obligatoire ? | Oui |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | Template, TemplateSourceFilePath, TemplateExcelFilePath |
Alias | Aucun |
-TemplateName <String>
Spécifie le modèle de propriété à utiliser par son nom. Vous pouvez utiliser ShareGate pour configurer des modèles de propriété pour la liste spécifiée (voir Importer un mappage des propriétés ou Nouveau modèle de propriété). Pour utiliser le modèle intégré "Full Copy", ne spécifiez pas ce paramètre.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | Default, TemplateNameSourceFilePath, TemplateNameExcelFilePath |
Alias | Aucun |
-UserEmail <String>
Spécifie le compte d'utilisateur à partir duquel effectuer la migration. Si le paramètre n'est pas défini, les fichiers de l'utilisateur connecté seront importés. Vous devez être connecté en tant qu'administrateur pour utiliser ce paramètre.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Oui (ByValue, ByPropertyName) |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
-WaitForImportCompletion <SwitchParameter>
Indique que la commande attendra la fin de l'importation en mode azure insane.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
-WhatIf <SwitchParameter>
Indique qu'une vérification préalable sera exécutée au lieu d'une migration. Pour plus d'informations, consultez Exécuter une vérification préalable dans PowerShell.
Obligatoire ? | Non |
Valeur par défaut | Aucune |
Accepte l'entrée du pipeline ? | Non |
Accepte les caractères génériques ? | Non |
Nom de l'ensemble de paramètres | (Tous) |
Alias | Aucun |
"Cet article a été traduit à l'aide de l'intelligence artificielle. En cas de doute, veuillez vous référer à la version originale en anglais."