Hinweis: Für die PowerShell-Integration ist ein ShareGate Migrate Pro- oder Enterprise-Abonnement erforderlich. Sie ist im Essentials-Plan nicht verfügbar.

Befehl

Import-BoxDocument

Beschreibung

Der Befehl zum Importieren von Box-Dokumenten in eine SharePoint-Bibliothek.

Hinweis: Sie können Box.com-Dokumente nur mit PowerShell kopieren.

Hinweis: Da standardmäßig der Insane mode verwendet wird (sofern nicht -NormalMode angegeben ist), wartet der Befehl, bis der Microsoft 365 Azure-Import abgeschlossen ist, bevor er ein Ergebnis zurückgibt. Verwenden Sie stattdessen -NoWaitForImportCompletion, damit der Befehl sofort nach der lokalen Verarbeitung zurückkehrt. In diesem Fall ist das zurückgegebene Ergebnis vorläufig, da der Import darin noch nicht berücksichtigt ist. Verwenden Sie Wait-ImportCompletion, oder lassen Sie die aktuelle PowerShell-Sitzung geöffnet, um zu erfahren, wann der Import tatsächlich abgeschlossen ist. Der frühere Parameter -WaitForImportCompletion ist jetzt veraltet, da das Warten auf den Abschluss wieder das Standardverhalten ist.

Tipps:

Informationen dazu, wie Sie ein Import-BoxDocument-Skript für eine inkrementelle Migration anpassen, finden Sie unter Eine inkrementelle Migration in PowerShell ausführen.
Informationen zu den verfügbaren Kopieroptionen finden Sie unter Kopieroptionen in PowerShell.
Wenn erhebliche Leistungsprobleme auftreten, finden Sie weitere Informationen unter Box.com-Drosselung.

Beispiele

Alle Dokumente importieren.

$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

Alle Dokumente eines anderen Benutzers im Administratormodus importieren.

$box = Connect-Box -Email [email protected] -Admin
Import-BoxDocument -Box $box -UserEmail [email protected] -DestinationList $dstList

Quell- und Zielordner angeben.

Import-BoxDocument -Box $box -SourceFolder "MyFolder/DocumentsToImport" -DestinationList $dstList -DestinationFolder "MyFolder/MySubFolder"

Zu importierende Quellpfade angeben.

Import-BoxDocument -Box $box -DestinationList $dstList -SourceFilePath "MyFolder/DocumentsToImport/Document1.docx", "MyFolder/DocumentsToImport/Document2.docx"

Dokumente mit einer Eigenschaftsvorlage importieren.

$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]
Import-BoxDocument -Box $box -SourceFolder "MyFolder/DocumentsToImport" -DestinationList $dstList -Template $propertyTemplate

Dokumente mit Eigenschaftszuordnungen importieren.

$mappings = Get-PropertyMapping -Box $box -DestinationList $dstList
$mappings = Set-PropertyMapping -MappingSettings $mappings -Source "CustomData1" -Destination "CustomData1"
Import-BoxDocument -Box $box -DestinationList $dstList -MappingSettings $mappings

Hinweis: CustomData1 ist benutzerdefinierte Metadaten für bestimmte Box-Dateien. Diese müssen explizit zugeordnet werden, da Get-PropertyMapping nicht alle Box-Dateien durchsucht, um alle Ihre Box-Felder zu finden. Wenn Ihre Metadaten Teil einer nicht globalen Metadatenvorlage in Box sind, verwenden Sie beim Festlegen der Eigenschaftszuordnung folgendes Format: templateName_metadataFieldName. Nicht zugeordnete benutzerdefinierte Metadaten landen in der Spalte UnmappedCustomMetadata, die am Ziel einem Feld für mehrzeiligen Text zugeordnet werden kann.

Vor dem Importieren aller Dokumente eine Vorabprüfung durchführen.

Import-BoxDocument -Box $box -DestinationList $dstList -WhatIf

Dokumente importieren, ohne auf den Abschluss des Microsoft 365 Azure-Imports zu warten, und anschließend mit Wait-ImportCompletion prüfen, wann er abgeschlossen ist.

$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 -NoWaitForImportCompletion
Wait-ImportCompletion

Syntax

Import-BoxDocument
-Box <BoxInfo>
-DestinationList <List>
[-UserEmail <String>]
[-DestinationFolder <Uri>]
[-SourceFolder <Uri>]
[-TemplateName <String>]
[-NormalMode <SwitchParameter>]
[-NoWaitForImportCompletion <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>]
[-NoWaitForImportCompletion <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>]
[-NoWaitForImportCompletion <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>]
[-NoWaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]

Parameter

-Box <BoxInfo>

Gibt die Quell-Box an.

Erforderlich?	True
Standardwert	None
Pipelineeingabe zulässig?	True (ByValue; ByPropertyName)
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-CopySettings <CopySettings>

Gibt die Kopiereinstellungen an.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	True (ByValue; ByPropertyName)
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-DestinationFolder <Uri>

Gibt den Ordnerpfad am Ziel an. Hinweis: Dieser Parameter kann nicht verwendet werden, um am Ziel neue Ordner zu erstellen.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-DestinationList <List>

Gibt die Zielliste an.

Erforderlich?	True
Standardwert	None
Pipelineeingabe zulässig?	True (ByValue; ByPropertyName)
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-MappingSettings <MappingSettings>

Gibt die Zuordnungseinstellungen an.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-NormalMode <SwitchParameter>

Gibt an, dass der normale Modus verwendet werden soll. Hinweis: Insane mode wird in PowerShell standardmäßig immer verwendet.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-NoWaitForImportCompletion <SwitchParameter>

Gibt an, dass der Befehl nach der lokalen Verarbeitung zurückkehrt, ohne auf den Abschluss des Azure Insane mode-Imports zu warten.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-SourceFilePath <Uri[]>

Gibt den Pfad der Quelldatei an.

Erforderlich?	True
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	Template, TemplateSourceFilePath
Aliase	None

-SourceFolder <Uri>

Gibt den Ordnerpfad an der Quelle an.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-TaskName <String>

Gibt einen Namen für die Aufgabe an.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-Template <PropertyTemplate>

Gibt die Eigenschaftsvorlage an. Um die integrierte Vorlage "Full copy" zu verwenden, geben Sie diesen Parameter nicht an.

Erforderlich?	True
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	Template, TemplateSourceFilePath
Aliase	None

-TemplateName <String>

Gibt die zu verwendende Eigenschaftsvorlage anhand ihres Namens an. Sie können mit ShareGate Eigenschaftsvorlagen für die angegebene Liste konfigurieren (siehe Import Property Mapping oder New-PropertyTemplate). Um die integrierte Vorlage "Full copy" zu verwenden, geben Sie diesen Parameter nicht an.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	Default, TemplateNameSourceFilePath
Aliase	None

-UserEmail <String>

Gibt das Benutzerkonto an, von dem aus migriert werden soll. Wenn dieser Parameter nicht festgelegt ist, werden die Dateien des angemeldeten Benutzers importiert. Sie müssen als Administrator verbunden sein, um diesen Parameter verwenden zu können.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	True (ByValue; ByPropertyName)
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

-WhatIf <SwitchParameter>

Gibt an, dass anstelle einer Migration eine Vorabprüfung ausgeführt wird. Weitere Informationen finden Sie unter What If verwenden, um in PowerShell eine Vorabprüfung durchzuführen.

Erforderlich?	False
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	(All)
Aliase	None

Dieser Artikel wurde mit künstlicher Intelligenz übersetzt. Bei Unklarheiten konsultieren Sie bitte die englische Originalversion.