ソリューションのアップグレードまたは更新

既存の管理ソリューションを更新する必要がある場合があります。 ソリューションを更新するには、次の手順に従います:

1. 開発環境でアンマネージド ソリューションを開き、新しいものを作成するか、必要な既存のコンポーネントを追加および削除します。

2. ソリューションを管理ソリューションとしてエクスポートする場合は、バージョン番号を大きくします。 詳細: 更新のバージョン番号について

   

3. ターゲット環境にアップグレードまたは更新を適用する

ターゲット環境にアップグレードまたは更新を適用する

更新済ソリューションをインポートする手順は、いくつか異なるオプションが取得されることを除けば、新しい管理ソリューションをインストールする場合と同じです。 他から取得したソリューションを更新している場合は、どのオプションを選択する必要があるかについてソリューション発行者からのガイダンスが必要です。

1. Power Apps にサインインし、必要なターゲット環境を選択して、左側のナビゲーションから ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。

2. コマンド バーで インポート を選択します。

3. ソリューション パッケージの選択 ページで、参照 を選択し、更新するソリューションが含まれている圧縮 (.zip または .cab) ファイルを検索します。

4. 次へ を選択します。

5. このページには、このソリューション パッケージには、インストール済のソリューションの更新が含まれています という黄色バーが表示されます。 このソリューションをアップグレードするには、次へ を選択します。 追加のオプションを表示するには、高度な設定 を展開して、次に、次のソリューション アクション オプションから選択します。

   • アップグレード これは、既定のオプションであり、ソリューションが最新バージョンにアップグレードされ、すべての古いパッチが 1 つの手順でロールアップされます。 古いソリューションのバージョンに関連付けられているコンポーネントのうち、新しいソリューションのバージョンに含まれていないコンポーネントは削除されます。 このオプションは、インポートしたソリューションに含まれなくなったコンポーネントの削除がされ、最終的な構成状態とインポートしたソリューションとの整合性が保証されるため、このオプションを選択することを確実にします。

   • アップグレードのステージ このオプションを選択するとソリューションが最新のバージョンにアップグレードされます。しかし、ソリューションのアップグレードを適用するまでは、以前のバージョンおよび関連するパッチの削除が保留されます。 このオプションは、古いソリューションと新しいソリューションの両方を同時にシステムにインストールする場合にのみ選択します。これにより、ソリューションのアップグレードを完了する前にデータを移行することができます。 アップグレードを適用すると、古いソリューションと、新しいソリューションに含まれていないコンポーネントが削除されます。

   • 更新 このオプションを選択すると、既存のソリューションを上書きします。 新しいソリューションに含まれていないコンポーネントは削除されず、システムに残ります。 ソース環境でコンポーネントが削除された場合、ソース環境と宛先環境が異なる場合があることに注意してください。 このオプションは、通常、アップグレード方法よりも短い時間で終了するため、最高のパフォーマンスを発揮します。

6. インポート アクション後に以下のオプションを有効にするかどうかを決定します。

   • ソリューションが含むプラグインのステップとフローを有効化する
     このオプションを選択すると、ソリューションに含まれるプラグインと Power Automate フローが有効になります。

7. インポート を選択します。

   

8. ソリューションのインポートが完了するまで、しばらくかかる場合があります。 正常に完了した場合、結果を確認し、閉じる を選択できます。

管理されたカスタマイズは常に公開された状態でインポートされるため、このシナリオではインポート後にカスタマイズを公開する必要はありません。

ソリューションのアップグレードを完了する アップグレードのステージングを選択した場合、またはシステムでアップグレード完了時に問題が発生した場合は、元のソリューションがまだシステムにインストールされていることと、基本ソリューションと同じソリューション名に _更新 が付加された新しいソリューションがあることが確認できます。 アップグレードを完了するには、ソリューションの一覧から基本のソリューションを選択し、 ソリューションのアップグレードを適用する を選択します。 このアンインストールによって、すべての古いパッチと基本ソリューションをアンインストールし、_アップグレード ソリューションを古い基本ソリューションと同じ名前に変更します。 元のソリューションに含まれていたコンポーネントと _アップグレード ソリューションに含まれていないパッチは、この処理の一環として削除されます。

注意

プラットフォームの最近の変更により、シングル ステップ アップグレード プロセスが最適化され、一時的な _Upgrade ソリューションを使用したり、元のソリューションでアンインストール操作を使用したりする必要がなくなりました。

更新のバージョン番号について

ソリューションのバージョンの形式は major.minor.build.revision です。 更新プログラムには、上位のソリューションよりも高いメジャー、マイナー、ビルド、リビジョン番号が必要です。 たとえば、基本ソリューション バージョン 3.1.5.7 の場合、小規模な更新プログラムであればバージョン 3.1.5.8、またはもう少し重要な更新プログラムであればバージョン 3.1.7.0 のようになります。 大幅に重要な更新は、バージョン 3.2.0.0 である可能性があります。

ターゲット環境からマネージド コンポーネントを削除する

マネージド コンポーネントを環境から削除したい場合があります。 マネージド コンポーネントを環境から削除するために実行できるソリューション アクションには、2 つあります。

• ソリューションをアップグレード (推奨) します。 管理ソリューションが作成された開発環境で、コンポーネントを含まないようにソリューションを更新します。 つまり、列、グラフ、フォームなどのコンポーネントをソリューションから削除してから、管理対象としてエクスポートします。 次に、管理ソリューションをターゲット環境にインポートする際、アップグレードにソリューション アクションを選択します。 このアクションにより、コンポーネントが削除されます (ターゲット環境にコンポーネントに依存する他のコンポーネントがない場合)。
• 管理ソリューションを削除します。 このアクションにより、ソリューション内のすべてのコンポーネントが削除されます。 管理ソリューションがインポートされた環境で、マネージド コンポーネントを含む管理ソリューションを削除します。 これは、Power Apps のソリューション エリアから実行します。

  警告

  管理ソリューションを削除すると、管理ソリューションにあるすべてのコンポーネント、さらには関連データが削除されます。 管理ソリューションを削除する前に、細心の注意を払ってください。

カスタマイズ オプションを上書きする

カスタマイズを上書きするオプションは、Microsoft Power Platform CLI pac solution import コマンドを使用する場合、または OverwriteUnmanagedCustomizations オプションを ImportSolution または ImportSolutionAsync メッセージと使用する場合に、クラシック インポート エクスペリエンスで使用できます。 詳細: ImportSolutionRequest クラス、ImportSolution アクション、または ImportSolutionAsync アクション。

重要

カスタマイズを上書き (推奨されません) を選択すると、このソリューションに含まれるコンポーネントで以前実行された管理されていないカスタマイズがすべて上書きされるか削除されます。 このオプションは、マージに対応しているコンポーネントには影響しません (フォーム、サイトマップ、リボン、アプリ、アプリモジュール)。 置き換えをする既存のソリューションに、その他の優位性を持つ管理ソリューションを持つコンポーネントがある場合は、このソリューションはこのオプションの影響を受けません。

参照

管理ソリューション内での階層化 ソリューションコンポーネントの追加
ソリューション修正プログラムの作成
開発者向け: クローン、パッチ、アップグレード

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。