メモ
Dynamics 365 GuidesおよびRemote Assistは、2026 年 12 月 31 日以降は使用できなくなります。 詳細については、サポート終了を迎える Dynamics 365 Guides および Remote Assistをご覧ください。
Microsoft Dynamics 365 Guides のコンテンツ移行ツール (パブリック プレビュー) は、Microsoft Dataverseのある環境から別の環境にコンテンツをコピーする Windows PowerShell スクリプトです。 環境にあるすべてのコンテンツ、または特定のタイプのコンテンツ (3D オブジェクト、画像、ビデオなど) を移行できます。 移行が完了すると、両方の環境にコンテンツが表示されます。 ソース環境のコンテンツが変更されることはありません。
このツールは、2 つのMicrosoft Dataverse環境に同時に接続します。 このツールは、ソース環境のコンテンツを読み取り、コピー先の環境に書き込みます。 環境は、同じテナントの一部にすることも、異なるテナントに含めることもできます。
このツールは、商用環境や Microsoft Government Community Cloud (GCC) 環境間の移行をサポートします。
重要
Dynamics 365 Guidesのコンテンツ移行ツール (パブリック プレビュー) を使用すると、プレビュー ツールの使用に関するすべての制限を確認し、受け入れます。 たとえば、Dynamics 365 Guidesおよびその他の Microsoft 商用サービスおよび製品の使用条件とコミットメントは、コンテンツ移行ツールには適用されません。 また、Dynamics 365 テナント間でのデータの移行に関連するすべてのリスクも想定します。 このようなリスクには、セキュリティ、コンプライアンス、プライバシーの保護に関するリスク、データの破損や紛失のリスク、ツールの利用不可や中断のリスクなどが含まれます。
このツールでは、次のタイプの移行がサポートされています。
| 移行のタイプ | 移行されたものは何ですか。 |
|---|---|
| すべてのコンテンツ | アクティブなインスタンスに保存されているコンテンツすべて。 (ガイドに関連付けられているテレメトリ イベントは除外されます。) |
| ガイドおよび関連コンテンツ | アクティブなガイド、それらのガイドに関連する 3D オブジェクト、画像、ビデオ。 ガイドに関連付けられている非アクティブなコンテンツも移行されます。 既存のガイドをすべて一度に移行したり、特定のガイドを選択したりできます。 パッケージ化されたガイドとパッケージ化されていないガイドを組み合わせて移行することはできません。 |
| すべての 3D オブジェクト、画像、ビデオ | インスタンスに保存されている、すべてのアクティブな 3D オブジェクト、画像、ビデオ。 |
| 3D オブジェクトのみ | アクティブな 3D オブジェクトのみ。 既存のすべての 3D オブジェクトを一度に移行したり、3D オブジェクト コレクションに属するすべての 3D オブジェクトを移行したり、特定の 3D オブジェクトを選択して移行したりできます。 |
| 画像のみ | アクティブな画像のみ。 既存の画像をすべて一度に移行したり、特定の画像を選択したりできます。 |
| ビデオのみ | アクティブなビデオのみ。 既存のすべての動画を一度に移行する、または特定の動画を選択することができます。 |
| オブジェクトアンカーのみ | アクティブなオブジェクト アンカーのみ。 既存のすべてのアンカー記号を一度に移行する、または特定のアンカー記号を選択することができます。 |
メモ
- フォルダ構造を環境で作成した場合は、Power Platform のエクスポート/インポート機能を使用して移行できます。 最初にフォルダー、次にコンテンツを移動することで、フォルダーとコンテンツの階層が確実に保持されます。
- Website および Power Apps リンクは、ガイドを移行するときに移行されます。 ただし、Power Appsの場合は、新しい環境にアプリを手動でインポートし、適切な手順でリンクを更新します。
- コンテンツ移行ツールは、スキーマ v3 または v4 に基づくガイドの移行をサポートしていません。 Dynamics 365 Guides ソリューションを最新バージョンに更新しても、スキーマ v3 または v4 に基づくガイドが残っている場合は、手動アップグレードを行います。
- 3D オブジェクト コレクションに属する 3D オブジェクトの場合、親 3D オブジェクトは、システム管理者ロールがないと移行されません。
前提条件
Windows PowerShell スクリプトの実行に使用するコンピューターのシステム管理者。
Windows PowerShell バージョン 5.1.18362.752 以降。
ソース環境と移行先環境の両方で、ソリューション バージョン 700.0.0.x 以降Dynamics 365 Guides使用されます。
ソース環境と宛先環境の両方は、同じメジャー バージョン番号とマイナー バージョン番号を保持している必要があります。
システム管理ロール (推奨) またはオペレーター/著者ロール (必須) のソース環境にサインインするための資格情報が必要です。
システム管理ロール (推奨) または作成者ロール (必須) の宛先環境にサインインするための資格情報が必要です。
また、移行プロセスを始める前に、両方の環境のコンテンツをバックアップすることを強くお勧めします。
ツールのダウンロードおよびスクリプトの実行
Guides のコンテンツ移行ツールをダウンロードします。 圧縮フォルダーがダウンロード フォルダーにダウンロードされます。
Windows エクスプローラーで、zip 形式のフォルダーを選択し、右クリックして Properties を選択>。
プロパティ ダイアログ ボックスにある 全般 タブで、ブロックの解除 チェック ボックスを選択してから 適用 を選択します。
圧縮フォルダーを選択し、コンテンツを展開します。
PowerShell 管理者としてWindows実行します。 Start を選択し、「PowerShell」と入力し、Windows PowerShell を選択してから、Run as administrator を選択します。
展開されたアーカイブで ContentMigrationTool_D365GuidesR2_v700>MigrationToolScripts フォルダーに移動します。
User Account Control メッセージ ボックスで、Yes を選択して、Windows PowerShell がデバイスに変更を加えることを許可します。
Set-ExecutionPolicy RemoteSigned と入力し、Y を選択して、実行ポリシーの変更を許可します。
.\ContentMigrationTool_PublicPreview_Dynamics365Guides.ps1 と入力してから、入力 を選択します。
メモ
文字列の先頭にピリオドを含めてください。
続行するには、任意のキーを選択します。
PowerShell インタラクティブ ログイン ダイアログ ボックスで、ソース環境に接続するには、次の手順に従います。
Deployment Type フィールド グループで、Microsoft 365 オプションを選択します。
可能な組織のリストを表示 チェック ボックスを選択します。
詳細を表示 チェック ボックスを選択します。
オンライン地域フィールドで、環境のオンライン地域を選択します。 環境が GCC 地域にある場合は、北米 2を選択します。 地域がわからない場合は、不明を選択します。
User Name フィールドと Password フィールドに、接続先のMicrosoft Dataverse環境のユーザー名とパスワードを入力します。
[ ログイン] を選択します。 接続する組織を選択しない場合、ツールはソース環境と宛先環境の両方で成功した最後の組織に接続します。 テナントに環境が 1 つしかない場合、Windows PowerShell は既定の環境に自動的に接続します。 この場合、手順 12 にスキップします。
ログイン プロセスの開始ダイアログ ボックスで、接続するソース環境 (組織) を選択します。
[ ログイン] を選択します。
PowerShell インタラクティブ ログイン ダイアログ ボックスで、宛先環境に接続するには、次の手順に従います。
Deployment Type フィールド グループで、Microsoft 365 オプションを選択します。
可能な組織のリストを表示 チェック ボックスを選択します。
詳細を表示 チェック ボックスを選択します。
オンライン地域フィールドで、環境のオンライン地域を選択します。 環境が GCC 地域にある場合は、北米 2を選択します。 地域がわからない場合は、不明を選択します。
User Name フィールドと Password フィールドに、接続先のMicrosoft Dataverse環境のユーザー名とパスワードを入力します。
[ ログイン] を選択します。
ログイン プロセスの開始ダイアログ ボックスで、接続する宛先環境 (組織) を選択します。
[ ログイン] を選択します。
メイン メニュー ページで、対応する番号を入力してオプションを選択してから、入力 を選択します。
ヒント
移行する Guides の選択 ページのように、複数のオプションを選択できる番号付きリストでは、選択した番号をコンマで区切ってから、Enter キーを押します。
選択内容を確認するメッセージが表示されたら、はい と入力してから 入力 を選択します。 アクションをキャンセルするには、いいえと入力してから入力を選択します。