注: PowerShellとの連携には、ShareGate MigrateのProまたはEnterpriseサブスクリプションが必要です。Essentialsプランでは利用できません。
コマンド
Copy-Content
説明
コンテンツを、あるSharePointのリストまたはライブラリから別のリストまたはライブラリへコピーするコマンドです。
注: Insane modeが既定で使用されるため(-NormalModeが指定されていない限り)、既定ではMicrosoft 365のAzureインポートが完了するまでコマンドは値を返さず待機します。ローカル処理の後すぐに値を返すようにするには、代わりに-NoWaitForImportCompletionを使用してください。この場合、返される結果は暫定的なものです(インポートはまだ反映されていません)。インポートが実際に完了したタイミングを知るには、Wait-ImportCompletionを使用するか、現在のPowerShellセッションを実行したままにしてください。完了を待機する動作が既定の動作に戻ったため、以前の-WaitForImportCompletionスイッチは非推奨になりました。
ヒント:
Copy-Contentスクリプトを差分移行として実行できるように調整する方法については、PowerShellで差分移行を実行するを参照してください。PowerShellでコピー オプションを使用する方法については、PowerShellでのコピー オプションを参照してください。
例
コピー元リストのすべてのコンテンツをコピー先リストにコピーする。
$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
特定のコピー元ビューからコンテンツをコピーする。
Copy-Content -SourceList $srcList -DestinationList $dstList -SourceView "My View"
既存のプロパティ テンプレートを名前で指定してコンテンツをコピーする。
Copy-Content -SourceList $srcList -DestinationList $dstList -TemplateName "mypropertytemplate"
注: この例では、コピー元とコピー先に対してすでに作成されているテンプレートを名前で呼び出しています。PowerShellで新しいテンプレートを定義する方法については、New Property Templateを参照してください。
特定のコピー元フォルダーからコピー先フォルダーにコンテンツをコピーする。
Copy-Content -SourceList $srcList -DestinationList $dstList -SourceFolder "MyFolder" -DestinationFolder "MyFolder/MySubFolder"
注: フォルダーとその中のコンテンツを移行するには、後の例で示すように、代わりに-SourceFilePathを使用してください。
メタデータ用にExcelまたはCSVファイルを使用してコンテンツをコピーする。
Copy-Content -SourceList $srcList -DestinationList $dstList -ExcelFilePath "c:\\Users\\myUser\\Desktop\\myExcelFile.xslx"
注: この例を使用して、Excelスプレッドシートに基づいてコンテンツをコピーします。
パスを指定して特定のファイルをコピーする。
Copy-Content -SourceList $srcList -DestinationList $dstList -SourceFilePath "Document1.txt","Folder/Document2.txt"
注: -SourceFilePathには、ファイル、フォルダー、またはドキュメント セットを指定できます。このパスは、常にスクリプトで指定するライブラリからの相対パスになります。
パスを指定して特定のファイルをコピー先フォルダーにコピーする。
Copy-Content -SourceList $srcList -DestinationList $dstList -SourceFilePath "Document1.txt","Folder/Document2.txt" -DestinationFolder "MyDestinationFolder"
IDを指定して特定の項目をコピーする。
Copy-Content -SourceList $srcList -DestinationList $dstList -SourceItemId 2,6,100
IDを指定して特定の項目をコピー先フォルダーにコピーする。
Copy-Content -SourceList $srcList -DestinationList $dstList -SourceItemId 2,6,100 -DestinationFolder "MyDestinationFolder"
すべてのコンテンツをコピーする前に事前チェックを実行する。
Copy-Content -SourceList $srcList -DestinationList $dstList -WhatIf
コピー元とコピー先の両方がSharePoint Onlineである場合に、すべてのコンテンツをコピーし、ファイルに適用された秘密度ラベルを含める。
Copy-Content -SourceList $srcList -DestinationList $dstList -IncludeContentSensitivityLabel
Microsoft 365のAzureインポートの完了を待たずにコンテンツをコピーし、その後Wait-ImportCompletionを使用して完了したタイミングを確認する。
$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
構文
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
パラメーター
-CopySettings <CopySettings>
コピー設定を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | True (ByValue; ByPropertyName) |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-DestinationFolder <Uri>
コピー先のフォルダー パスを指定します。注: このパラメーターを使用してコピー先に新しいフォルダーを作成することはできません。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-DestinationList <List>
コピー先のリストを指定します。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-ExcelFilePath <String>
メタデータに使用するファイルのパスを指定します。対応する形式はExcelおよびCSVです。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | TemplateNameExcelFilePath, TemplateExcelFilePath |
エイリアス | None |
-IncludeContentSensitivityLabel <SwitchParameter>
コンテンツ(ドキュメント ライブラリに保存されているファイル。フォルダーを除く)に適用された秘密度ラベルが、保持されている秘密度ラベルのマッピングを使用してコピー先にコピーされることを指定します。コピー元とコピー先の両方がSharePoint Onlineである必要があります。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-MappingSettings <MappingSettings>
マッピング設定を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-NormalMode <SwitchParameter>
ノーマル モードを使用することを指定します。
注: Insane modeはPowerShellで既定で常に使用されます。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-NoWaitForImportCompletion <SwitchParameter>
コマンドがAzure Insane modeのインポートの完了を待たずに、ローカル処理後に返されることを指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-SourceFilePath <Uri[]>
コピー元のファイル パスを指定します。-SourceFilePathは155個を超えるファイル パスには対応していません。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | TemplateNameSourceFilePath, TemplateSourceFilePath |
エイリアス | None |
-SourceFolder <Uri>
コピー元のフォルダー パスを指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | Default, TemplateNameSourceFilePath, Template, TemplateSourceFilePath |
エイリアス | None |
-SourceItemId <Int32[]>
コピー元の項目IDを指定します。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | TemplateNameSourceItemId, TemplateSourceItemId |
エイリアス | None |
-SourceList <List>
コピー元のリストを指定します。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-SourceView <String>
タイトル、ファイル名、またはビューのURLを使用して、コピー元のビューを指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | Default, Template |
エイリアス | None |
-TaskName <String>
タスクの名前を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-Template <PropertyTemplate>
プロパティ テンプレートを指定します。組み込みの「Full Copy」テンプレートを使用する場合は、このパラメーターを指定しないでください。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | Template, TemplateExcelFilePath, TemplateSourceFilePath, TemplateSourceItemId |
エイリアス | None |
-TemplateName <String>
プロパティ テンプレートを名前で指定します。ShareGateを使用して、指定したリストのプロパティ テンプレートを構成できます(Import Property MappingまたはNew Property Templateを参照)。組み込みの「Full Copy」テンプレートを使用する場合は、このパラメーターを指定しないでください。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | Default, TemplateNameExcelFilePath, TemplateNameSourceFilePath, TemplateNameSourceItemId |
エイリアス | None |
-WhatIf <SwitchParameter>
移行の代わりに事前チェックが実行されることを指定します。詳細については、PowerShellで事前チェックを実行するを参照してください。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
この記事はAIによって翻訳されています。ご不明な点がある場合は、英語の原文をご確認ください。