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-Document
Descripción
El comando para importar documentos y carpetas desde un recurso compartido de archivos a una biblioteca de SharePoint.
Consejos:
Para aprender cómo adaptar tu script
Import-Documentpara realizar una migración incremental, consulta Ejecutar una migración incremental en PowerShell.Para conocer las opciones de copia en tus scripts, consulta Opciones de copia en PowerShell.
Para saber cómo importar contenido de un recurso compartido de archivos a varios OneDrive for Business, consulta Importar desde recurso compartido de archivos a OneDrive for Business con PowerShell.
Ejemplos
Comprobación previa de importación de todos los documentos
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"$dstList = Get-List -Name "mydstlib" -Site $dstSiteImport-Document -SourceFolder "\\mysharedrive\documentsToImport\" -DestinationList $dstList -WhatIf
Importar todos los documentos
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"$dstList = Get-List -Name "mydstlib" -Site $dstSiteImport-Document -SourceFolder "\\mysharedrive\documentsToImport\" -DestinationList $dstList
Importar documentos con una plantilla de propiedad
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"$dstList = Get-List -Name "mydstlib" -Site $dstSiteImport-Document -SourceFolder "\\mysharedrive\documentsToImport\" -DestinationList $dstList -TemplateName "mypropertytemplate"
Especificar carpeta
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"$dstList = Get-List -Name "mydstlib" -Site $dstSiteImport-Document -SourceFolder "\\mysharedrive\documentsToImport\" -DestinationList $dstList -DestinationFolder "MyFolder/MySubFolder"
Nota: Usar -SourceFolder migrará el contenido de tu carpeta, pero no la carpeta en sí. Para migrar la carpeta y su contenido, puedes usar -SourceFilePath. Consulta el ejemplo a continuación.
Especificar rutas de archivos a copiar
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"$dstList = Get-List -Name "mydstlib" -Site $dstSiteImport-Document -DestinationList $dstList -SourceFilePath "\\mysharedrive\documentsToImport\Document1.txt","\\mysharedrive\Folder\Document2.txt"
Nota: -SourceFilePath puede ser un archivo o una carpeta.
Especificar rutas de archivos a copiar (a carpeta de destino)
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"$dstList = Get-List -Name "mydstlib" -Site $dstSiteImport-Document -DestinationList $dstList -SourceFilePath "\\mysharedrive\documentsToImport\Document1.txt","\\mysharedrive\Folder\Document2.txt" -DestinationFolder "MyDestinationFolder"
Importar documentos con Excel
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"$dstList = Get-List -Name "mydstlib" -Site $dstSiteImport-Document -DestinationList $dstList -ExcelFilePath "c:\Users\myUser\Desktop\myExcelFile.xslx"
Nota: Usa este ejemplo para copiar tus documentos basándote en una hoja de cálculo de Excel.
Sintaxis
Import-Document
-DestinationList <List>
-SourceFolder <Uri>
[-TemplateName <String>]
[-DestinationFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-WaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]
Import-Document
-DestinationList <List>
-SourceFolder <Uri>
-Template <PropertyTemplate>
[-DestinationFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-WaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]
Import-Document
-DestinationList <List>
-Template <PropertyTemplate>
-SourceFilePath <Uri[]>
[-SourceFolder <Uri>]
[-DestinationFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-WaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]
Import-Document
-DestinationList <List>
-SourceFilePath <Uri[]>
[-SourceFolder <Uri>]
[-TemplateName <String>]
[-DestinationFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-WaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]
Import-Document
-DestinationList <List>
-ExcelFilePath <String>
[-TemplateName <String>]
[-DestinationFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-WaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]
Import-Document
-DestinationList <List>
-Template <PropertyTemplate>
-ExcelFilePath <String>
[-DestinationFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-WaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]
Parámetros
-CopySettings <CopySettings>
Especifica la configuración de copia.
¿Requerido? | 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 |
-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? | Falso |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Falso |
¿Acepta caracteres comodín? | Falso |
Nombre del conjunto de parámetros | (Todos) |
Alias | Ninguno |
-DestinationList <List>
Especifica la lista de destino.
¿Requerido? | Verdadero |
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 |
-ExcelFilePath <String>
Especifica la ruta del archivo usado para los metadatos. Los formatos compatibles son Excel y CSV.
¿Requerido? | Verdadero |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Falso |
¿Acepta caracteres comodín? | Falso |
Nombre del conjunto de parámetros | TemplateNameExcelFilePath, TemplateExcelFilePath |
Alias | Ninguno |
-MappingSettings <MappingSettings>
Especifica la configuración de asignación.
¿Requerido? | Falso |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Falso |
¿Acepta caracteres comodín? | Falso |
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? | Falso |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Falso |
¿Acepta caracteres comodín? | Falso |
Nombre del conjunto de parámetros | (Todos) |
Alias | Ninguno |
-SourceFilePath <Uri[]>
Especifica la ruta de archivo de origen.
¿Requerido? | Verdadero |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Falso |
¿Acepta caracteres comodín? | Falso |
Nombre del conjunto de parámetros | TemplateSourceFilePath, TemplateNameSourceFilePath |
Alias | Ninguno |
-SourceFolder <Uri>
Especifica la ruta de la carpeta en el origen.
¿Requerido? | Verdadero |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | Falso |
¿Acepta caracteres comodín? | Falso |
Nombre del conjunto de parámetros | Default, Template, TemplateSourceFilePath, TemplateNameSourceFilePath |
Alias | Ninguno |
-TaskName <String>
Especifica un nombre para la tarea.
¿Requerido? | 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 integrada "Full Copy", no especifiques este parámetro.
¿Obligatorio? | Sí |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | No |
¿Acepta caracteres comodín? | No |
Nombre del conjunto de parámetros | Template, TemplateSourceFilePath, TemplateExcelFilePath |
Alias | Ninguno |
-TemplateName <String>
Especifica la plantilla de propiedad que se 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 integrada "Full Copy", no especifiques este parámetro.
¿Obligatorio? | No |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | No |
¿Acepta caracteres comodín? | No |
Nombre del conjunto de parámetros | Default, TemplateNameSourceFilePath, TemplateNameExcelFilePath |
Alias | Ninguno |
-WaitForImportCompletion <SwitchParameter>
Indica que ShareGate Migrate esperará a que se complete la importación de Microsoft 365 desde Azure.
¿Obligatorio? | No |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | No |
¿Acepta caracteres comodín? | No |
Nombre del conjunto de parámetros | (Todos) |
Alias | Ninguno |
-WhatIf <SwitchParameter>
Indica 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? | No |
Valor predeterminado | Ninguno |
¿Acepta entrada de canalización? | No |
¿Acepta caracteres comodín? | No |
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."
