注: PowerShellとの連携には、ShareGate MigrateのProまたはEnterpriseサブスクリプションが必要です。Essentialsプランでは利用できません。
コマンド
Import-BoxDocument
説明
Boxのドキュメントを SharePoint ライブラリにインポートするコマンドです。
注: Box.comのドキュメントは、PowerShellを使用してのみコピーできます。
注: 既定ではInsane modeが使用されるため(-NormalMode を指定した場合を除く)、このコマンドはMicrosoft 365のAzureインポートが完了するまで待ってから結果を返します。ローカル処理の完了後すぐに制御を返したい場合は、代わりに -NoWaitForImportCompletion を使用してください。その場合、返される結果は暫定的なものであり、インポートの内容はまだ反映されていません。インポートが実際に完了したタイミングを確認するには、Wait-ImportCompletion を使用するか、現在のPowerShellセッションを起動したままにしてください。以前の -WaitForImportCompletion スイッチは、完了を待つ動作が再び既定の挙動になったため、非推奨となりました。
ヒント:
Import-BoxDocumentスクリプトを増分移行用に調整する方法については、PowerShell で増分移行を実行するを参照してください。利用可能なコピーオプションについては、PowerShell のコピー オプションを参照してください。
パフォーマンスに大きな問題が発生する場合は、「Box.comのスロットリング」を参照してください。
例
すべてのドキュメントをインポートする。
$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
管理者モードで、別のユーザーのすべてのドキュメントをインポートする。
$box = Connect-Box -Email [email protected] -Admin
Import-BoxDocument -Box $box -UserEmail [email protected] -DestinationList $dstList
コピー元とコピー先のフォルダーを指定する。
Import-BoxDocument -Box $box -SourceFolder "MyFolder/DocumentsToImport" -DestinationList $dstList -DestinationFolder "MyFolder/MySubFolder"
インポートするコピー元のパスを指定する。
Import-BoxDocument -Box $box -DestinationList $dstList -SourceFilePath "MyFolder/DocumentsToImport/Document1.docx", "MyFolder/DocumentsToImport/Document2.docx"
プロパティ テンプレートを使用してドキュメントをインポートする。
$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
プロパティ マッピングを使用してドキュメントをインポートする。
$mappings = Get-PropertyMapping -Box $box -DestinationList $dstList
$mappings = Set-PropertyMapping -MappingSettings $mappings -Source "CustomData1" -Destination "CustomData1"
Import-BoxDocument -Box $box -DestinationList $dstList -MappingSettings $mappings
注: CustomData1は、特定のBoxファイルに含まれるカスタムメタデータです。Get-PropertyMappingはすべてのBoxファイルを走査してBoxフィールドを検出するわけではないため、これらは明示的にマッピングする必要があります。メタデータがBox内の非グローバルなメタデータ テンプレートの一部である場合は、プロパティ マッピングの設定時に templateName_metadataFieldName の形式に従ってください。マッピングされなかったカスタムメタデータは UnmappedCustomMetadata 列に格納され、移行先では複数行テキストのフィールドにマッピングできます。
すべてのドキュメントをインポートする前に、事前チェックを実行する。
Import-BoxDocument -Box $box -DestinationList $dstList -WhatIf
Microsoft 365のAzureインポートの完了を待たずにドキュメントをインポートし、その後 Wait-ImportCompletion を使用して完了のタイミングを確認する。
$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
構文
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>]
パラメーター
-Box <BoxInfo>
コピー元のBoxを指定します。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | True (ByValue; ByPropertyName) |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-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 |
-MappingSettings <MappingSettings>
マッピング設定を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | 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 |
パラメーターセット名 | Template, TemplateSourceFilePath |
エイリアス | None |
-SourceFolder <Uri>
コピー元のフォルダーパスを指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-TaskName <String>
タスクの名前を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-Template <PropertyTemplate>
プロパティ テンプレートを指定します。組み込みの「Full copy」テンプレートを使用する場合は、このパラメーターを指定しないでください。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | Template, TemplateSourceFilePath |
エイリアス | None |
-TemplateName <String>
名前を指定して、使用するプロパティ テンプレートを指定します。ShareGateを使用すると、指定したリストのプロパティ テンプレートを構成できます(「Import Property Mapping」または「New-PropertyTemplate」を参照)。組み込みの「Full copy」テンプレートを使用する場合は、このパラメーターを指定しないでください。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | Default, TemplateNameSourceFilePath |
エイリアス | None |
-UserEmail <String>
移行元となるユーザーアカウントを指定します。このパラメーターを設定しない場合、ログインしているユーザーのファイルがインポートされます。このパラメーターを使用するには、管理者として接続している必要があります。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | True (ByValue; ByPropertyName) |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-WhatIf <SwitchParameter>
移行の代わりに事前チェックを実行することを指定します。詳細については、「PowerShell で What If を使って事前チェックを実行する」を参照してください。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
この記事はAIによって翻訳されています。ご不明な点がある場合は、英語の原文をご確認ください。