SharePoint Online/OneDrive 移行のカスタム機能

SharePoint Online/OneDrive 移行に複数のカスタム機能が提供されています。機能を使用するには、以下の情報を参照してください。

    AllowUseNotExistChoice 値が以下の 2 件の条件を満たす場合、移行先の移行済みオブジェクトに選択肢列の値を追加するかどうかを定義します。

列設定で、移行元オブジェクトの選択肢列の値が削除されます。

列設定で移行先の選択肢列に構成された列の値が、移行元の削除された列の値と同じではありません。

既定では、この機能は無効になっています。Fly は、移行先の移行されたオブジェクトに選択肢列の値を追加しません。移行先の移行されたオブジェクトの選択肢列の値は空白になります。オブジェクトが移行されたが、オブジェクトの設定にエラーが存在することを示す警告メッセージが報告されます。

移行先の移行されたオブジェクトに選択肢列の値を追加する場合は、カスタム機能 セクションに "AllowUseNotExistChoice=true" 文字列を追加して、この機能を有効にすることができます。

    EnsureUserWithLoginName 移行ポリシーですべてのユーザー プロパティ オプションが無効になっている場合、ユーザー マッピングに含まれていないユーザーをマッピングするためにユーザー プリンシパル名 (UPN) を使用するかどうかを定義します。既定では、これらのユーザーを正常に移行できるようにするため、ユーザーのマッピングに UPN が使用されます。

これらのユーザーのマッピングに UPN を使用しない場合は、EnsureUserWithLoginName=false 文字列を追加して、この機能を無効にすることができます。

    ExcludeWorkflowRelated ワークフロー履歴リストとワークフロー タスク リストを含むワークフロー関連リストの移行範囲と、移行におけるワークフロー関連リストの内容を定義します。(ワークフロー関連リストのコンテンツには、ワークフローに関連するコンテンツと、ワークフローに関連しないコンテンツが含まれます。)

既定では、Fly は移行パフォーマンスを向上させるために、ワークフロー関連リストを移行しません。

ワークフロー関連リストとワークフロー関連リストのコンテンツを移行する場合は、カスタム機能 セクションに ExcludeWorkflowRelated=0 文字列を追加できます。移行パフォーマンスが低下します。

*注意: ワークフロー履歴リストのデータは移行できません。

ExcludeWorkflowRelated=2 文字列を追加して、ワークフロー関連のリストと、リスト内のワークフローに関連しないコンテンツのみを移行することもできます。リスト内のワークフローに関連するコンテンツは移行されず、移行のパフォーマンスが向上します。

以前の移行ジョブで上記の機能文字列値のいずれかを構成して、現在の移行ジョブでワークフロー関連リストを移行しない場合は、機能文字列値を 1 に変更することができます。

    GetRetentionLabelRetryDelaySeconds 保持ラベルが適用された移行元オブジェクトを新規作成された移行先サイト コレクションに移行する際に、移行先テナントで Fly が保持ラベルを取得するまでの待機時間を定義します。

既定では、Fly は保持ラベルを 3 回取得し、毎回 3 秒を待機します。保持ラベルが 3 回取得されなかった場合、オブジェクトが移行できますが、保持ラベルの移行は失敗します。

待機時間を更新する場合、GetRetentionLabelRetryDelaySeconds=" " 文字列を追加し、目的の時間を値として入力します。単位は です。例: GetRetentionLabelRetryDelaySeconds=10

    IsAutoMapAssociateGroupUnderWebLevel (SharePoint Online 移行でのみ使用可能) SharePoint グループ タイプを使用して、移行元サイト、リスト、フォルダーの所有者、メンバー、閲覧者グループを対応する移行先グループにマッピングするかどうかを定義します。この機能は、サイト コレクション間のマッピングには使用できません。

既定では、この機能は無効になっています。これらの移行元グループは、表示名に基づいて対応する移行先グループにマッピングされます。移行先に移行元グループと同じ表示名のグループが存在しない場合、移行元グループは移行先に新しいグループとして作成されます。

SharePoint グループ タイプを使用してこれらのグループを対応する移行先グループにマッピングする場合は、カスタム機能 セクションに "IsAutoMapAssociateGroupUnderWebLevel=true" 文字列を追加して、この機能を有効にすることができます。移行先に移行元グループと同じ表示名のグループが存在する場合、Fly は表示名に基づいてこれらの移行元グループを移行先にマッピングします。同じ表示名のグループが存在しない場合、Fly はグループ タイプに基づいてこれらの移行元グループを移行先にマッピングします。

    IsCheckAdminUrl プロジェクト マッピングの移行元・移行先サイト コレクション URL のドメイン名が、サービス アカウントまたはアプリ プロファイルに構成されている SharePoint センター管理 URL と同じかどうかをチェックするかどうかを定義します。これは、移行元・移行先のサイト コレクションが、サービス アカウントまたはアプリ プロファイルと同じテナント内にあるかどうかを確認します。

既定では、この機能は有効になっています。Fly は移行をチェックします。サイト コレクションのいずれかがサービス アカウントまたはアプリ プロファイルと同じテナントにない場合、移行ジョブは失敗します。

移行でチェックを行わない場合は、カスタム機能 IsCheckAdminUrl=false 文字列を追加して、この機能を無効にすることができます。

    IsFindLabelWhenNotConfigLabelMapping 移行元オブジェクトに適用された秘密度ラベル (ラベル A) が、選択したラベル マッピングで構成された移行元秘密度ラベルと一致しない場合に、移行元秘密度ラベルと同じ名前の秘密度ラベルを移行先オブジェクトに適用するかどうかを定義します。既定は、この場合に、移行元秘密度ラベルと同じ名前の秘密度ラベルは移行先オブジェクトに適用されます。

移行元秘密度ラベルと同じ名前の秘密度ラベルを移行先オブジェクトに適用しない場合、カスタム機能 セクションに IsFindLabelWhenNotConfigLabelMapping=false 文字列を追加して、この機能を無効にすることができます。機能の無効化後、秘密度ラベル (ラベル A) が適用されているすべてのオブジェクトの移行は失敗となります。

    IsIgnoreRestoreImageTagsValueCauseItemError 以下の場合に SP-RestoreImageTagsValueCauseItemError エラー コードを無視するかどうかを定義します。

移行元オブジェクトの イメージ タグ 列に値が存在し、移行先に イメージ タグ 列が存在しない場合、Fly が移行先でその列を作成できないため、移行で列の移行はスキップされます。既定では、Fly はこの列にエラー コードをレポートするだけではなく、オブジェクトが移行されたが、オブジェクトの イメージ タグ 列値の移行は失敗したことを示すため、SP-RestoreImageTagsValueCauseItemError エラー コードをオブジェクトにもレポートします。

移行レポートの SP-RestoreImageTagsValueCauseItemError エラー コードを無視する場合、カスタム機能 セクションに IsIgnoreRestoreImageTagsValueCauseItemError=true 文字列を追加することができます。移行後、Fly はエラー コードを移行元列にのみレポートします。

    IsKeepSourceAssociateGroupTitle (SharePoint Online 移行でのみ使用可能) 移行中に移行元のサイト コレクション、サイト、リスト、フォルダーの所有者、メンバー、閲覧者グループのタイトルを移行先に保持するかどうかを定義します。

既定では、この機能は無効になっています。これらの移行元グループのタイトルは、対応する移行先グループのタイトルに置き換えられます。

これらの移行元グループのタイトルを移行先に保持する場合は、カスタム機能 セクションに IsKeepSourceAssociateGroupTitle=true 文字列を追加して、この機能を有効にすることができます。

    IsKeepSourceListTitle プロジェクト マッピングで構成された移行先リストが存在しない場合、Fly は構成された移行先リストを新しいものとして直接作成します。この機能は、移行元リスト名を移行先新規作成されたリストの名前として使用するかどうかを定義します。

既定では、この機能は無効になっています。移行先リストが存在しない場合、Fly は構成された移行先リスト URL のリスト名を、新規作成されたリストの名前として使用します。

移行元リスト名を移行先新規作成されたリストの名前として使用する場合は、カスタム機能 セクションに IsKeepSourceListTitle=true 文字列を追加して、この機能を有効にすることができます。

    IsMigrateMIPProtectionTemplateAsLabel ファイルに適用された保護テンプレートを秘密度ラベルとして移行するかどうかを定義します。既定では、この機能は無効になっています。ファイルに適用された保護テンプレートは移行されません。

移行ポリシーの ファイルの秘密度ラベルを管理する方法を選択します セクションで選択したオプションに基づいてファイルに適用された保護テンプレートを移行する場合、カスタム機能 セクションに IsMigrateMIPProtectionTemplateAsLabel=true 文字列を追加して、この機能を有効にすることができます。

    IsMigrateRetentionLabel フォルダー / ファイル / アイテムの保持ラベルを移行先に移行するかどうかを定義します。既定では、オブジェクトに保持ラベルが適用されている場合、Fly はオブジェクトに適用された保持レベルをオブジェクトと同時に移行します。

オブジェクトに適用された保持レベルを移行しない場合、カスタム機能 セクションに IsMigrateRetentionLabel=false 文字列を追加します。

    IsReMigrateUsePlaceholderObject 移行元オブジェクトが移行され、これらのオブジェクトの一部のユーザー / グループ プロパティが移行先のプレースホルダー アカウントに置き換えられました。これらのユーザー/ グループのユーザー マッピングを構成した後、増分移行ジョブを実行して移行先のプレースホルダー アカウントをアクティブな移行先のユーザーまたはグループに置き換えた場合、オブジェクトに対して更新がないため移行できません。

これらのオブジェクトを移行する場合は、カスタム機能 セクションに IsReMigrateUsePlaceholderObject=true 文字列を追加して、この機能を有効にすることができます。

    IsRepairExportedManifestFiles 不安定なネットワークまたはデータ自体の問題によって生成された従来と異なるデータを移行するかどうかを定義します。例えば、マニフェストで同じバージョンを 2 つ持つデータ。既定では、Fly はデータの修復を試行して、データを移行先に移行します。

この機能を有効にすることを推奨します。データを修復・移行しない場合、カスタム機能 セクションに IsRepairExportedManifestFiles=false 文字列を追加して、この機能を無効にすることができます。これらの従来と異なるデータの移行は失敗となります。

    IsRestoreImageTags (SharePoint Online 移行でのみ使用可能) 移行元イメージの [イメージ タグ] 列の値を移行するかどうかを定義します。既定では、移行元イメージの [イメージ タグ] 列の値は移行されません。

移行元イメージの [イメージ タグ] 列の値を移行する場合は、カスタム機能 セクションに IsRestoreImageTags=true 文字列を追加して、この機能を有効にすることができます。

    IsSkipGroupHomePage (SharePoint Online 移行でのみ使用可能) Microsoft 365 グループに関連付けられたサイト コレクションのホーム ページを移行するかどうかを定義します。

既定では、この機能は有効になっています。Microsoft 365 グループに関連付けられたサイト コレクションのホーム ページはスキップされ、これらのホーム ページの Web パーツは移行先に移行されません。

Microsoft 365 グループに関連付けられたサイト コレクションのホーム ページを移行する場合、 カスタム機能 セクションに IsSkipGroupHomePage=false 文字列を追加して、この機能を無効にすることができます。移行後、移行先のホーム ページで [新規] をクリックすると、一部の機能が表示されないことに注意してください。

    IsSkipMasterPageLibrary マスター ページ タイプのリスト テンプレートを移行先に移行するかどうかを定義します。既定では、テンプレートの移行はスキップされます。

テンプレートを移行する場合、カスタム機能 セクションに IsSkipMasterPageLibrary=false 文字列を追加します。

    IsSkipOneDriveAnyoneSharedLink OneDrive サイトのすべてのユーザーと共有されているリンクを移行先に移行するかどうかを定義します。既定では、OneDrive サイトのすべてのユーザーと共有されているリンクは移行先に移行され、移行先の OneDrive の所有者にメールが送信されます。

すべてのユーザーと共有されているリンクを移行しない場合、カスタム機能 セクションに IsSkipOneDriveAnyoneSharedLink=true 文字列を追加できます。

    IsTrimLabelNameSpace 移行中に、移行元と移行先の秘密度ラベルの先頭と末尾のスペースを削除するかどうかを定義します。既定では、スペースは削除されません。

移行中に秘密度ラベルの先頭と末尾のスペースを削除する場合、カスタム機能 セクションに IsTrimLabelNameSpace=true 文字列を追加することができます。

    PreserveNullValue 移行元フォルダー / ファイル / アイテムの現在の列値が空の場合、移行先のフォルダー / ファイル / アイテムの列値を空の状態にするかどうかを定義します。

既定では、この機能は有効に設定されています。移行先のフォルダー / ファイル / アイテムの列の値は空の状態になります。

移行先で移行されたフォルダー / ファイル / アイテムの列値を空の状態にしたくない場合は、カスタム機能 セクションに PreserveNullValue=false 文字列を追加して、この機能を無効にすることができます。移行元フォルダー / ファイル / アイテムに列値があり、その値が移行前に削除された場合、最後の列値が移行先の移行されたフォルダー / ファイル / アイテムに追加されます。

    ReadSensitivityLabelFromPDFFile PDF ファイルに適用された秘密度ラベルを処理するかどうかを定義します。既定では、この機能は無効になっています。移行中に PDF ファイルに適用された秘密度ラベルを処理せず、移行後にファイルにアクセスできなくなる可能性があります。

PDF ファイルに適用された秘密度ラベルを処理するには、カスタム機能 セクションに ReadSensitivityLabelFromPDFFile=true 文字列を追加して、この機能を有効にすることができます。

*注意: Microsoft API 制限により、Fly SharePoint REST API のみを使用して、PDF ファイルが保存されているライブラリに表示されている秘密度ラベルを取得します。秘密度ラベルがライブラリに表示されていない場合、Fly は移行時にこれらの秘密度ラベルを処理できません。

    RemoveConflictingFileBeforeOverwrite 移行先には、移行元ファイルと同じ相対 URL を持つが、固有 ID が異なるか、移行元ファイルと同じ固有 ID を持つが、相対 URL が異なるファイルが存在場合は、移行元ファイルを移行する前に競合する移行先ファイルをバックアップして削除するかどうかを定義します。

既定ではこの機能は無効に設定されています。移行元ファイルと移行先ファイルの相対 URL や固有 ID が同じ場合は、移行できません。

移行ポリシーで構成された 上書きする または 最終更新日時に従って上書きする コンテンツ レベルの競合解決を使用して移行元ファイルを移行する場合は、カスタム機能 セクションに RemoveConflictingFileBeforeOverwrite=true 文字列を追加して、この機能を有効にします。移行元ファイルを移行する前に、移行先で競合ファイルをバックアップして削除します。

*注意: バックアップされたファイルは filename-shortguid_bak.extension に名前変更されます。

*注意: この機能が有効になっており、移行元接続または移行先接続に Fly アプリ プロファイル / カスタム アプリ プロファイル / 委任アプリ プロファイルのみが構成されている場合、移行後、ファイルが共有されている移行先ユーザーにファイル場所の変更に関するメール通知が送信されます。

*注意: この機能を有効にすると、移行先ファイルの変更日時が移行元ファイルの変更日時より後であっても、移行先ファイルはバックアップされ、削除されます。

    RestoreManagedNavigationSetting サイト コレクションの移行元管理ナビゲーション設定を移行先に移行するかどうかを定義します。

既定では、この機能は無効になっています。サイト コレクションの移行元管理ナビゲーション設定は移行先に移行されません。Fly は、サイト コレクションの移行先ナビゲーション設定を保持します。

サイト コレクションの移行元管理ナビケーション設定を移行する場合は、カスタム機能 セクションに RestoreManagedNavigationSetting=true 文字列を追加して、この機能を有効にすることができます。移行パフォーマンスが低下します。

    RetryTimesOfThrottlingError 移行時にジョブが Microsoft 365 によってスロットルされた場合に、Fly の再試行回数を定義します。

既定では、ジョブが Microsoft 365 によってスロットルされた場合に、Fly 5 回再試行します。5 回再試行しても、ジョブはまだスロットルされている場合、ジョブは失敗となります。

再試行回数を更新する場合、RetryTimesOfThrottlingError=" " 文字列を追加し、正の整数を値として入力します。例: RetryTimesOfThrottlingError=10

    SearchUsedTermSetInWeb 移行元テナントのすべてのグローバル用語グループを移行するかどうかを定義します。既定では、移行元サイト コレクションの管理されたメタデータ列に使用されている用語セットのみは移行されます。

移行元テナントのすべてのグローバル用語グループを移行する場合、カスタム機能 セクションに SearchUsedTermSetInWeb=false 文字列を追加することができます。

    TermSetIdsCanNotBeSearched この機能文字列を構成して、Nintex フォーム コントロールでのみ使用される用語セットを移行先に移行します。構成しない場合は、Nintex フォーム コントロールに関連する Nintex フォームの移行が失敗します。

移行先に移行する用語セットを定義するには、カスタム機能 セクションに TermSetIdsCanNotBeSearched 文字列を TermSetIdsCanNotBeSearched=Guid1;Guid2;Guid3 の形式で追加します。

Guid は用語セットの一意識別子を指します。用語セットの一意識別子を見つけるには、SharePoint 管理センター > コンテンツ サービス > 用語ストア に移動し、目的の用語セットをクリックすると、用語セットの一意識別子が右ペインに表示されます。複数の Guid を構成する場合は、Guid をセミコロン (;) で区切ります。

この文字列を構成されている場合、移行ポリシーで Managed Metadata Service オプションを選択すると、文字列で定義された用語セットが移行先に移行されます。Managed metadata service オプションの選択を解除する場合は、構成された用語セットと同じ階層および名前を持つ用語セットが移行先に存在することを確認します。文字列で定義された用語セットは、移行で移行先の用語セットにマッピングされます。

    TrimWhiteSpaceForObjectName Fly がフォルダー / ファイル名の前後にスペースをトリミングするかどうかを定義します。

既定ではこの機能は無効に設定されています。移行元フォルダー / ファイル名の前後に、移行先で許可されていない余分なスペースがある場合、フォルダー / ファイルの移行に失敗します。

移行ジョブでスペースをトリミングする場合は、カスタム機能 セクションに "IsRemoveShareLink=true" 文字列を追加して、この機能を有効にすることができます。

    ValidateFileSize 移行中に移行元からダウンロードされたファイルのサイズを、移行先に表示されるファイルのサイズと比較するかどうかを定義します。

既定では、この機能は有効に設定されています。ダウンロードされたファイルのサイズと移行先に表示されるファイルのサイズの偏差が ValidateFileSizeErrorInByte カスタム機能で構成された許容偏差を超過している場合、ファイルの移行は失敗します。

移行元からダウンロードされたファイルのサイズを移行元に表示されるファイルのサイズと比較しない場合、カスタム機能 セクションに ValidateFileSize=false 文字列を追加して、この機能を無効にすることができます。

*注意: ダウンロードされたファイルのサイズと移行元に表示されるファイル サイズが異なる場合、ダウンロードされた移行元ファイルが壊れている可能性があります。この機能を無効にすると、Fly はファイル サイズを比較せずに壊れたファイルを移行します。この場合、移行後にファイルが開けない可能性があります。そのため、この機能の無効化を推奨しません。

    ValidateFileSizeErrorInByte ValidateFileSize カスタム機能を有効にする際に、移行元からダウンロードされたファイルのサイズと移行先に表示されるファイルのサイズとの許容偏差を定義します。

既定では、許容偏差は 5 バイトです。許容偏差をカスタマイズする場合、カスタム機能 セクションに ValidateFileSizeErrorInByte=" " 文字列を追加して、希望の数字を値として入力します。単位は バイト です。