Hinweis: Für die PowerShell-Integration ist ein ShareGate Migrate Pro- oder Enterprise-Abonnement erforderlich. Sie ist im Essentials-Plan nicht verfügbar.
Befehl
Copy-Content
Beschreibung
Der Befehl zum Kopieren von Inhalten von einer SharePoint-Liste oder -Bibliothek zu einer anderen.
Hinweis: Da standardmäßig der Insane Mode verwendet wird (sofern nicht -NormalMode angegeben ist), wartet der Befehl standardmäßig, 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 bisherige Schalter -WaitForImportCompletion ist jetzt veraltet, da das Warten auf den Abschluss wieder das Standardverhalten ist.
Tipp:
Wie Sie Ihr
Copy-Content-Skript für eine inkrementelle Migration anpassen, erfahren Sie unter Eine inkrementelle Migration in PowerShell ausführen.Wie Sie Kopieroptionen mit PowerShell verwenden, erfahren Sie unter Kopieroptionen in PowerShell.
Beispiele
Kopieren Sie den gesamten Inhalt von einer Quellliste in eine Zielliste.
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite"
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$srcList = Get-List -Name "mysrclist" -Site $srcSite
$dstList = Get-List -Name "mydstlist" -Site $dstSite
Copy-Content -SourceList $srcList -DestinationList $dstList
Kopieren Sie Inhalte aus einer bestimmten Quellansicht.
Copy-Content -SourceList $srcList -DestinationList $dstList -SourceView "My View"
Kopieren Sie Inhalte mithilfe einer vorhandenen Eigenschaftsvorlage, indem Sie diese über ihren Namen aufrufen.
Copy-Content -SourceList $srcList -DestinationList $dstList -TemplateName "mypropertytemplate"
Hinweis: In diesem Beispiel wird eine bereits für Quelle und Ziel erstellte Vorlage verwendet und über ihren Namen aufgerufen. Wie Sie eine neue Vorlage in PowerShell definieren, erfahren Sie unter Neue Eigenschaftsvorlage.
Kopieren Sie Inhalte von einem bestimmten Quellordner in einen Zielordner.
Copy-Content -SourceList $srcList -DestinationList $dstList -SourceFolder "MyFolder" -DestinationFolder "MyFolder/MySubFolder"
Hinweis: Um einen Ordner und dessen Inhalt zu migrieren, verwenden Sie stattdessen -SourceFilePath, wie in einem späteren Beispiel gezeigt.
Kopieren Sie Inhalte mithilfe einer Excel- oder CSV-Datei für Metadaten.
Copy-Content -SourceList $srcList -DestinationList $dstList -ExcelFilePath "c:\\Users\\myUser\\Desktop\\myExcelFile.xslx"
Hinweis: Verwenden Sie dieses Beispiel, um Ihre Inhalte basierend auf einer Excel-Tabelle zu kopieren.
Kopieren Sie bestimmte Dateien anhand des Pfads.
Copy-Content -SourceList $srcList -DestinationList $dstList -SourceFilePath "Document1.txt","Folder/Document2.txt"
Hinweis: -SourceFilePath kann eine Datei, ein Ordner oder ein Dokumentset sein. Der Pfad bezieht sich immer auf die Bibliothek, die Sie in Ihrem Skript angeben.
Kopieren Sie bestimmte Dateien anhand des Pfads in einen Zielordner.
Copy-Content -SourceList $srcList -DestinationList $dstList -SourceFilePath "Document1.txt","Folder/Document2.txt" -DestinationFolder "MyDestinationFolder"
Kopieren Sie bestimmte Elemente anhand der ID.
Copy-Content -SourceList $srcList -DestinationList $dstList -SourceItemId 2,6,100
Kopieren Sie bestimmte Elemente anhand der ID in einen Zielordner.
Copy-Content -SourceList $srcList -DestinationList $dstList -SourceItemId 2,6,100 -DestinationFolder "MyDestinationFolder"
Führen Sie einen Pre-Check aus, bevor Sie den gesamten Inhalt kopieren.
Copy-Content -SourceList $srcList -DestinationList $dstList -WhatIf
Kopieren Sie den gesamten Inhalt und schließen Sie auf Dateien angewendete Vertraulichkeitsbezeichnungen ein, wenn sowohl Quelle als auch Ziel SharePoint Online sind.
Copy-Content -SourceList $srcList -DestinationList $dstList -IncludeContentSensitivityLabel
Kopieren Sie Inhalte, ohne auf den Abschluss des Microsoft 365 Azure-Imports zu warten, und verwenden Sie anschließend Wait-ImportCompletion, um zu erfahren, wann er abgeschlossen ist.
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite"
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$srcList = Get-List -Name "mysrclist" -Site $srcSite
$dstList = Get-List -Name "mydstlist" -Site $dstSite
Copy-Content -SourceList $srcList -DestinationList $dstList -NoWaitForImportCompletion
Wait-ImportCompletion
Syntax
Copy-Content
-SourceList <List>-DestinationList <List>[-TemplateName <String>][-SourceView <String>][-SourceFolder <Uri>][-IncludeContentSensitivityLabel <SwitchParameter>][-DestinationFolder <Uri>][-NormalMode <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>][-WhatIf <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-TaskName <String>]
Copy-Content
-SourceList <List>-DestinationList <List>-ExcelFilePath <String>[-TemplateName <String>][-IncludeContentSensitivityLabel <SwitchParameter>][-DestinationFolder <Uri>][-NormalMode <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>][-WhatIf <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-TaskName <String>]
Copy-Content
-SourceList <List>-DestinationList <List>-SourceFilePath <Uri[]>[-TemplateName <String>][-SourceFolder <Uri>][-IncludeContentSensitivityLabel <SwitchParameter>][-DestinationFolder <Uri>][-NormalMode <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>][-WhatIf <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-TaskName <String>]
Copy-Content
-SourceList <List>-SourceItemId <Int32[]>-DestinationList <List>[-TemplateName <String>][-IncludeContentSensitivityLabel <SwitchParameter>][-DestinationFolder <Uri>][-NormalMode <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>][-WhatIf <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-TaskName <String>]
Copy-Content
-Template <PropertyTemplate>-SourceList <List>-DestinationList <List>[-SourceView <String>][-SourceFolder <Uri>][-IncludeContentSensitivityLabel <SwitchParameter>][-DestinationFolder <Uri>][-NormalMode <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>][-WhatIf <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-TaskName <String>]
Copy-Content
-Template <PropertyTemplate>-SourceList <List>-DestinationList <List>-ExcelFilePath <String>[-IncludeContentSensitivityLabel <SwitchParameter>][-DestinationFolder <Uri>][-NormalMode <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>][-WhatIf <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-TaskName <String>]
Copy-Content
-Template <PropertyTemplate>-SourceList <List>-DestinationList <List>-SourceFilePath <Uri[]>[-SourceFolder <Uri>][-IncludeContentSensitivityLabel <SwitchParameter>][-DestinationFolder <Uri>][-NormalMode <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>][-WhatIf <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-TaskName <String>]
Copy-Content
-Template <PropertyTemplate>-SourceList <List>-SourceItemId <Int32[]>-DestinationList <List>[-IncludeContentSensitivityLabel <SwitchParameter>][-DestinationFolder <Uri>][-NormalMode <SwitchParameter>][-NoWaitForImportCompletion <SwitchParameter>][-WhatIf <SwitchParameter>][-CopySettings <CopySettings>][-MappingSettings <MappingSettings>][-TaskName <String>]
Get-Command Copy-Content -SyntaxParameters
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? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | (All) |
Aliase | None |
-ExcelFilePath <String>
Gibt den Pfad der für Metadaten verwendeten Datei an. Unterstützte Formate sind Excel und CSV.
Erforderlich? | True |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | TemplateNameExcelFilePath, TemplateExcelFilePath |
Aliase | None |
-IncludeContentSensitivityLabel <SwitchParameter>
Gibt an, dass auf Inhalte angewendete Vertraulichkeitsbezeichnungen (Dateien, die in Dokumentbibliotheken gespeichert sind; Ordner sind ausgeschlossen) anhand der gespeicherten Zuordnung von Vertraulichkeitsbezeichnungen an das Ziel kopiert werden. Sowohl Quelle als auch Ziel müssen SharePoint Online sein.
Erforderlich? | False |
Standardwert | None |
Pipelineeingabe zulässig? | False |
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 Quelldateipfad an. -SourceFilePath funktioniert nicht für mehr als 155 Dateipfade.
Erforderlich? | True |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | TemplateNameSourceFilePath, 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 | Default, TemplateNameSourceFilePath, Template, TemplateSourceFilePath |
Aliase | None |
-SourceItemId <Int32[]>
Gibt die Quellelement-ID an.
Erforderlich? | True |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | TemplateNameSourceItemId, TemplateSourceItemId |
Aliase | None |
-SourceList <List>
Gibt die Quellliste an.
Erforderlich? | True |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | (All) |
Aliase | None |
-SourceView <String>
Gibt die Quellansicht anhand des Titels, des Dateinamens oder der URL der Ansicht an.
Erforderlich? | False |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | Default, Template |
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, TemplateExcelFilePath, TemplateSourceFilePath, TemplateSourceItemId |
Aliase | None |
-TemplateName <String>
Gibt die zu verwendende Eigenschaftsvorlage anhand ihres Namens an. Sie können ShareGate verwenden, um Eigenschaftsvorlagen für die angegebene Liste zu konfigurieren (siehe Importieren der Eigenschaftszuordnung oder Neue Eigenschaftsvorlage). 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, TemplateNameExcelFilePath, TemplateNameSourceFilePath, TemplateNameSourceItemId |
Aliase | None |
-WhatIf <SwitchParameter>
Gibt an, dass anstelle einer Migration ein Pre-Check ausgeführt wird. Weitere Informationen finden Sie unter Einen Pre-Check 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.