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-Document

Beschreibung

Der Befehl zum Importieren von Dokumenten und Ordnern von einer Dateifreigabe in eine SharePoint-Bibliothek.

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 zurückkehrt. Verwenden Sie stattdessen -NoWaitForImportCompletion, um sofort nach der lokalen Verarbeitung zurückzukehren; in diesem Fall ist das zurückgegebene Ergebnis vorläufig (der Import ist darin noch nicht berücksichtigt). Verwenden Sie Wait-ImportCompletion, oder lassen Sie die aktuelle PowerShell-Sitzung weiterlaufen, um zu erfahren, wann der Import tatsächlich abgeschlossen ist. Der frühere Schalter -WaitForImportCompletion ist jetzt veraltet, da das Warten auf den Abschluss wieder das Standardverhalten ist.

Tipps:

Informationen zur Anpassung Ihres Import-Document-Skripts für eine inkrementelle Migration finden Sie unter Eine inkrementelle Migration in PowerShell ausführen.
Informationen zu Kopieroptionen in Ihren Skripten finden Sie unter Kopieroptionen in PowerShell.
Informationen zum Importieren von Dateifreigabeinhalten in mehrere OneDrive-Konten finden Sie unter Von einer Dateifreigabe zu OneDrive for Business mit PowerShell importieren.

Beispiele

Führen Sie vor dem Import aller Dokumente eine Vorprüfung durch.

$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$dstList = Get-List -Name "mydstlib" -Site $dstSite
Import-Document -SourceFolder "\\mysharedrive\documentsToImport\" -DestinationList $dstList -WhatIf

Importieren Sie alle Dokumente von einer Dateifreigabe in eine SharePoint-Bibliothek.

Import-Document -SourceFolder "\\mysharedrive\documentsToImport\" -DestinationList $dstList

Importieren Sie Dokumente mithilfe einer Eigenschaftenvorlage.

Import-Document -SourceFolder "\\mysharedrive\documentsToImport\" -DestinationList $dstList -TemplateName "mypropertytemplate"

Importieren Sie Dokumente in einen bestimmten Ordner am Ziel.

Import-Document -SourceFolder "\\mysharedrive\documentsToImport\" -DestinationList $dstList -DestinationFolder "MyFolder/MySubFolder"

Hinweis: Die Verwendung von -SourceFolder migriert den Inhalt Ihres Ordners, jedoch nicht den Ordner selbst. Um stattdessen Ihren Ordner samt Inhalt zu migrieren, können Sie -SourceFilePath verwenden. Siehe das folgende Beispiel.

Importieren Sie bestimmte Dateien nach Pfad.

Import-Document -DestinationList $dstList -SourceFilePath "\\mysharedrive\documentsToImport\Document1.txt","\\mysharedrive\Folder\Document2.txt"

Hinweis: -SourceFilePath kann eine Datei oder ein Ordner sein.

Importieren Sie bestimmte Dateien nach Pfad in einen Zielordner.

Import-Document -DestinationList $dstList -SourceFilePath "\\mysharedrive\documentsToImport\Document1.txt","\\mysharedrive\Folder\Document2.txt" -DestinationFolder "MyDestinationFolder"

Importieren Sie Dokumente unter Verwendung einer Excel- oder CSV-Datei für Metadaten.

Import-Document -DestinationList $dstList -ExcelFilePath "c:\Users\myUser\Desktop\myExcelFile.xslx"

Hinweis: Verwenden Sie dieses Beispiel, um Ihre Dokumente basierend auf einer Excel-Tabelle zu importieren.

Importieren Sie Dokumente, ohne auf den Abschluss des Microsoft 365 Azure-Imports zu warten, und verwenden Sie anschließend Wait-ImportCompletion, um zu erfahren, wann der Import abgeschlossen ist.

$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$dstList = Get-List -Name "mydstlib" -Site $dstSite
Import-Document -SourceFolder "\\mysharedrive\documentsToImport\" -DestinationList $dstList -NoWaitForImportCompletion
Wait-ImportCompletion

Syntax

Import-Document
-DestinationList <List>
-SourceFolder <Uri>
[-TemplateName <String>]
[-DestinationFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-NoWaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]

Import-Document
-DestinationList <List>
-SourceFolder <Uri>
-Template <PropertyTemplate>
[-DestinationFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-NoWaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]

Import-Document
-DestinationList <List>
-Template <PropertyTemplate>
-SourceFilePath <Uri[]>
[-SourceFolder <Uri>]
[-DestinationFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-NoWaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]

Import-Document
-DestinationList <List>
-SourceFilePath <Uri[]>
[-SourceFolder <Uri>]
[-TemplateName <String>]
[-DestinationFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-NoWaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]

Import-Document
-DestinationList <List>
-ExcelFilePath <String>
[-TemplateName <String>]
[-DestinationFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-NoWaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]

Import-Document
-DestinationList <List>
-Template <PropertyTemplate>
-ExcelFilePath <String>
[-DestinationFolder <Uri>]
[-NormalMode <SwitchParameter>]
[-NoWaitForImportCompletion <SwitchParameter>]
[-WhatIf <SwitchParameter>]
[-CopySettings <CopySettings>]
[-MappingSettings <MappingSettings>]
[-TaskName <String>]

Parameter

-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 neue Ordner am Ziel 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

-ExcelFilePath <String>

Gibt den Pfad der Datei an, die für Metadaten verwendet wird. Unterstützte Formate sind Excel und CSV.

Erforderlich?	True
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	TemplateExcelFilePath, TemplateNameExcelFilePath
Aliase	None

-NormalMode <SwitchParameter>

Gibt an, dass der normale Modus verwendet werden soll. Hinweis: Insane mode wird standardmäßig immer in PowerShell 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 Quelldateipfad an.

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

-SourceFolder <Uri>

Gibt den Ordnerpfad an der Quelle an.

Erforderlich?	True
Standardwert	None
Pipelineeingabe zulässig?	False
Platzhalterzeichen zulässig?	False
Parametersatzname	Default, Template, TemplateSourceFilePath, TemplateNameSourceFilePath
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 Eigenschaftenvorlage 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, TemplateExcelFilePath
Aliase	None

-TemplateName <String>

Gibt die zu verwendende Eigenschaftenvorlage anhand ihres Namens an. Sie können mit ShareGate Eigenschaftenvorlagen für die angegebene Liste konfigurieren (siehe Importeigenschaftenzuordnung oder Neue Eigenschaftenvorlage). 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, TemplateNameExcelFilePath
Aliase	None

-WhatIf <SwitchParameter>

Gibt an, dass anstelle einer Migration eine Vorprüfung ausgeführt wird. Weitere Informationen finden Sie unter Eine Vorprüfung in PowerShell ausfü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.