注: PowerShellとの連携には、ShareGate MigrateのProまたはEnterpriseサブスクリプションが必要です。Essentialsプランでは利用できません。
コマンド
Import-Document
説明
ファイル共有からドキュメントとフォルダーを SharePoint ライブラリにインポートするコマンドです。
注:(-NormalMode を指定しない限り)既定で Insane mode が使用されるため、このコマンドは戻る前に Microsoft 365 Azure のインポートが完了するのを待ちます。代わりにローカル処理の後すぐに戻るようにするには、-NoWaitForImportCompletion を使用します。この場合、返される結果は暫定的なものであり(インポートはまだそこに反映されていません)、インポートが実際にいつ完了したかを知るには、Wait-ImportCompletion を使用するか、現在の PowerShell セッションを起動したままにしてください。以前の -WaitForImportCompletion スイッチは、完了を待つことが再び既定の動作になったため、非推奨になりました。
ヒント:
Import-Documentスクリプトを増分移行に対応させる方法については、PowerShell で増分移行を実行するを参照してください。スクリプト内のコピーオプションについては、PowerShell のコピーオプションを参照してください。
ファイル共有のコンテンツを複数の OneDrive にインポートする方法については、PowerShell を使用してファイル共有から OneDrive for Business にインポートするを参照してください。
例
すべてのドキュメントをインポートする前にプレチェックを実行します。
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$dstList = Get-List -Name "mydstlib" -Site $dstSite
Import-Document -SourceFolder "\\mysharedrive\documentsToImport\" -DestinationList $dstList -WhatIf
ファイル共有からすべてのドキュメントを SharePoint ライブラリにインポートします。
Import-Document -SourceFolder "\\mysharedrive\documentsToImport\" -DestinationList $dstList
プロパティテンプレートを使用してドキュメントをインポートします。
Import-Document -SourceFolder "\\mysharedrive\documentsToImport\" -DestinationList $dstList -TemplateName "mypropertytemplate"
ドキュメントを移行先の特定のフォルダーにインポートします。
Import-Document -SourceFolder "\\mysharedrive\documentsToImport\" -DestinationList $dstList -DestinationFolder "MyFolder/MySubFolder"
注: -SourceFolder を使用すると、フォルダーの内容は移行されますが、フォルダー自体は移行されません。フォルダーとその内容の両方を移行するには、代わりに -SourceFilePath を使用してください。以下の例を参照してください。
パスを指定して特定のファイルをインポートします。
Import-Document -DestinationList $dstList -SourceFilePath "\\mysharedrive\documentsToImport\Document1.txt","\\mysharedrive\Folder\Document2.txt"
注: -SourceFilePath にはファイルまたはフォルダーを指定できます。
パスを指定して特定のファイルを移行先フォルダーにインポートします。
Import-Document -DestinationList $dstList -SourceFilePath "\\mysharedrive\documentsToImport\Document1.txt","\\mysharedrive\Folder\Document2.txt" -DestinationFolder "MyDestinationFolder"
メタデータに Excel または CSV ファイルを使用してドキュメントをインポートします。
Import-Document -DestinationList $dstList -ExcelFilePath "c:\Users\myUser\Desktop\myExcelFile.xslx"
注: この例を使用して、Excel スプレッドシートに基づいてドキュメントをインポートします。
Microsoft 365 Azure のインポートの完了を待たずにドキュメントをインポートし、完了時期を知るために Wait-ImportCompletion を使用します。
$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
構文
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>]
パラメーター
-CopySettings <CopySettings>
コピー設定を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | True (ByValue, ByPropertyName) |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-DestinationFolder <Uri>
移行先のフォルダーパスを指定します。注: このパラメーターを使用して、移行先に新しいフォルダーを作成することはできません。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-DestinationList <List>
移行先のリストを指定します。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | True (ByValue, ByPropertyName) |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-ExcelFilePath <String>
メタデータに使用するファイルのパスを指定します。サポートされている形式は Excel と CSV です。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | TemplateExcelFilePath, TemplateNameExcelFilePath |
エイリアス | None |
-NormalMode <SwitchParameter>
通常モードを使用することを指定します。注: PowerShell では、既定で常に Insane mode が使用されます。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-NoWaitForImportCompletion <SwitchParameter>
コマンドが、Azure の Insane mode インポートの完了を待たずに、ローカル処理後に戻ることを指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-SourceFilePath <Uri[]>
移行元のファイルパスを指定します。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | TemplateSourceFilePath, TemplateNameSourceFilePath |
エイリアス | None |
-SourceFolder <Uri>
移行元のフォルダーパスを指定します。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | Default, Template, TemplateSourceFilePath, TemplateNameSourceFilePath |
エイリアス | None |
-TaskName <String>
タスクの名前を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-Template <PropertyTemplate>
プロパティテンプレートを指定します。組み込みの „Full copy" テンプレートを使用する場合は、このパラメーターを指定しないでください。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | Template, TemplateSourceFilePath, TemplateExcelFilePath |
エイリアス | None |
-TemplateName <String>
使用するプロパティテンプレートを名前で指定します。ShareGate を使用して、指定したリストのプロパティテンプレートを構成できます(インポートプロパティマッピングまたは新しいプロパティテンプレートを参照)。組み込みの „Full copy" テンプレートを使用する場合は、このパラメーターを指定しないでください。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | Default, TemplateNameSourceFilePath, TemplateNameExcelFilePath |
エイリアス | None |
-WhatIf <SwitchParameter>
移行の代わりにプレチェックが実行されることを指定します。詳細については、PowerShell でプレチェックを実行するを参照してください。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
この記事はAIによって翻訳されています。ご不明な点がある場合は、英語の原文をご確認ください。