Nota: La integración con PowerShell requiere una suscripción Pro o Enterprise de ShareGate Migrate. No está disponible en el plan Essentials.
Comando
Import-BoxDocument
Descripción
El comando para importar documentos de Box a una biblioteca de SharePoint.
Nota: Solo puedes copiar documentos de Box.com con PowerShell.
Consejos:
Para aprender cómo adaptar cualquier script
Import-BoxDocumentpara realizar una migración incremental, consulta Actualización incremental usando PowerShell.Para conocer las opciones de copia disponibles, consulta Opciones de copia en PowerShell.
Si experimentas problemas de rendimiento considerables, consulta Limitación de Box.com.
Ejemplos
Importar todos los documentos
$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
Importar todos los documentos de otro usuario en modo 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
Especificar carpetas de origen y destino
$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"
Especificar rutas de origen para importar
$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"
Importar documentos con una plantilla de propiedad
$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
Importar documentos con asignaciones de propiedades.
$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
En este caso, CustomData1 es un metadato personalizado en ciertos archivos de Box. Deben asignarse explícitamente, ya que Get-PropertyMapping no revisa todos los archivos de Box para encontrar todos tus campos de Box.
Si tus metadatos forman parte de una plantilla de metadatos no global en Box, debes seguir este formato al establecer la asignación de propiedades: templateName_metadataFieldName.
Los metadatos personalizados no asignados terminan en la columna UnmappedCustomMetadata, la cual se puede asignar a un campo de varias líneas de texto en el destino.
PreCheck para importar todos los documentos
$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
Sintaxis
Estos son los conjuntos de parámetros compatibles para el comando 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>]
Parámetros
-Box <BoxInfo>
Especifica el Box de origen.
¿Requerido? | Sí |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Sí (ByValue, ByPropertyName) |
¿Acepta caracteres comodín? | No |
Nombre del conjunto de parámetros | (Todos) |
Alias | Ninguno |
-CopySettings <CopySettings>
Especifica la configuración de copia.
¿Requerido? | No |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Sí (ByValue, ByPropertyName) |
¿Acepta caracteres comodín? | No |
Nombre del conjunto de parámetros | (Todos) |
Alias | Ninguno |
-DestinationFolder <Uri>
Especifica la ruta de la carpeta en el destino. Nota: Este parámetro no puede usarse para crear nuevas carpetas en el destino.
¿Requerido? | No |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | No |
¿Acepta caracteres comodín? | No |
Nombre del conjunto de parámetros | (Todos) |
Alias | Ninguno |
-DestinationList <List>
Especifica la lista de destino.
¿Requerido? | Sí |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Sí (ByValue, ByPropertyName) |
¿Acepta caracteres comodín? | No |
Nombre del conjunto de parámetros | (Todos) |
Alias | Ninguno |
-MappingSettings <MappingSettings>
Especifica la asignación de propiedades.
¿Requerido? | No |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | No |
¿Acepta caracteres comodín? | No |
Nombre del conjunto de parámetros | (Todos) |
Alias | Ninguno |
-NormalMode <SwitchParameter>
Especifica que se debe usar el modo normal.
Nota: Insane mode siempre se usa por defecto en PowerShell.
¿Requerido? | No |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | No |
¿Acepta caracteres comodín? | No |
Nombre del conjunto de parámetros | (Todos) |
Alias | Ninguno |
-SourceFilePath <Uri[]>
Especifica la ruta del archivo de origen.
¿Requerido? | Sí |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | No |
¿Acepta caracteres comodín? | No |
Nombre del conjunto de parámetros | TemplateSourceFilePath, TemplateNameSourceFilePath |
Alias | Ninguno |
-SourceFolder <Uri>
Especifica la ruta de la carpeta en el origen.
¿Requerido? | No |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | No |
¿Acepta caracteres comodín? | No |
Nombre del conjunto de parámetros | Default, Template, TemplateSourceFilePath, TemplateNameSourceFilePath |
Alias | Ninguno |
-TaskName <String>
Especifica un nombre para la tarea.
¿Obligatorio? | Falso |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Falso |
¿Acepta caracteres comodín? | Falso |
Nombre del conjunto de parámetros | (Todos) |
Alias | Ninguno |
-Template <PropertyTemplate>
Especifica la plantilla de propiedad. Para usar la plantilla incorporada "Full Copy", no especifiques este parámetro.
¿Obligatorio? | Verdadero |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Falso |
¿Acepta caracteres comodín? | Falso |
Nombre del conjunto de parámetros | Template, TemplateSourceFilePath, TemplateExcelFilePath |
Alias | Ninguno |
-TemplateName <String>
Especifica la plantilla de propiedad a usar por su nombre. Puedes usar ShareGate para configurar plantillas de propiedad para la lista especificada (consulta Importar asignación de propiedades o Nueva plantilla de propiedad). Para usar la plantilla incorporada "Full Copy", no especifiques este parámetro.
¿Obligatorio? | Falso |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Falso |
¿Acepta caracteres comodín? | Falso |
Nombre del conjunto de parámetros | Default, TemplateNameSourceFilePath, TemplateNameExcelFilePath |
Alias | Ninguno |
-UserEmail <String>
Especifica la cuenta de usuario desde la cual migrar. Si no se establece el parámetro, se importarán los archivos del usuario que ha iniciado sesión. Debes estar conectado como administrador para usar este parámetro.
¿Obligatorio? | Falso |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Verdadero (ByValue, ByPropertyName) |
¿Acepta caracteres comodín? | Falso |
Nombre del conjunto de parámetros | (Todos) |
Alias | Ninguno |
-WaitForImportCompletion <SwitchParameter>
Especifica que el comando esperará a que se complete la importación en modo azure insane.
¿Obligatorio? | Falso |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Falso |
¿Acepta caracteres comodín? | Falso |
Nombre del conjunto de parámetros | (Todos) |
Alias | Ninguno |
-WhatIf <SwitchParameter>
Especifica que se ejecutará una comprobación previa en lugar de una migración. Para más información, consulta Ejecutar una comprobación previa en PowerShell.
¿Obligatorio? | Falso |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Falso |
¿Acepta caracteres comodín? | Falso |
Nombre del conjunto de parámetros | (Todos) |
Alias | Ninguno |
"Este artículo fue traducido utilizando inteligencia artificial. En caso de duda, consulta la versión original en inglés."