Office アドインを既存の COM または VSTO アドインと互換性のあるものにする

既存の COM アドインまたは VSTO アドインがある場合は、Office Web アドインでほぼ同等の機能を構築できるため、ソリューションを Office on the web や Mac などの他のプラットフォームで実行できます。このシナリオでは、2 つのアドインは "同等" と呼ばれ、Office Web アドインのマニフェストを使用して、Windows コンピューター上のユーザーが使用できるアドインを制御できます (または、ユーザーに選択を与えます)。

注:

COM アドインと VSTO アドインは Windows にのみインストールできるため、この記事では、COM アドインと VSTO アドインをまとめて "Windows 専用" アドインと呼びます。

一般に、アドインは、次の条件が満たされた場合にのみ同等として扱う必要がありますが、アドインがこれらの条件を満たしていないという例外的なシナリオが同等として扱われる場合があります。

どちらも同じ開発者によって作成されます。通常は、統合マニフェストの "developer" プロパティまたはアドインのみのマニフェストの ProviderName 要素で指定されたエンティティです。
どちらも同じ Office アプリケーションまたはアプリケーションにインストールするように設計されており、主に重複する機能で同じワークロードに対処します。
パブリック名と、コントロール名やアイコンを含むユーザーインターフェイスが同一または非常に似ています。

重要

同等のアドイン機能は、次のプラットフォームとアプリケーションでサポートされています。 COM、VSTO、XLL アドインは他のプラットフォームにはインストールできないため、これらのプラットフォームでは、この記事で後述するマニフェストマークアップは無視されます。

Windows 上の Excel、Word、PowerPoint (バージョン 1904 以降)
サポートされている Exchange サーバーのバージョンに対するクラシック Outlook on Windows (バージョン 2102 以降)
- Exchange Online
- Exchange Server サブスクリプションエディション (SE)
- Exchange 2019 累積的な更新プログラム 10 以降 (KB5003612)
- Exchange 2016 累積的な更新プログラム 21 以降 (KB5003611)

重要

COM アドインと VSTO アドインは、新しい Outlook on Windows ではサポートされていません。これらのアドインは、従来の Outlook on Windows デスクトップクライアントで引き続きサポートされています。詳細については、「 Windows 上の新しい Outlook 用 Outlook アドインを開発する」を参照してください。

Windows 専用アドインと Office アドインにはまったく同じ機能がない場合があるため、考慮する必要があるシナリオは 3 つあります。

Office アドインには、対応する Windows 専用アドインで使用できる機能がすべて用意されているわけではありません。このシナリオでは、Windows 専用アドインがインストールされている Windows コンピューターで Office アドインを非表示にするように構成する必要があります。
Office アドインは、対応する Windows 専用アドインよりも多くの機能を提供します。このシナリオでは、 Windows 専用アドインの存在を検出して非表示にするように Office アドインを構成する必要があります。
どちらのアドインも、すべてのユーザーが他のアドインよりも優れているとは見なされません。このシナリオでは、 Windows コンピューター上の各ユーザーに、どのアドインを非表示にするかを選択できるように Office アドインを構成する必要があります。

Windows 専用アドインの名前を取得する

Office アドインのマニフェストを構成する前に、まず、次の手順で Windows レジストリ内の Windows 専用アドインの名前を特定する必要があります。

Windows 専用アドインがインストールされている任意のコンピューターで Windows レジストリエディターを開きます。
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\<Office アプリケーション>\Addins または HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\<Office アプリケーション>\Addins に移動します。ここで、<Office アプリケーション>は Excel、Outlook、PowerPoint、またはWordです。たとえば、 をHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Excel\Addinsします。
必要な Windows 専用アドインに関連付けられているレジストリキーの名前をコピーします。名前では大文字と小文字が区別されることに注意してください。

Office アドインを非表示にする

Office アドインを構成して、同等の Windows 専用アドインが既にユーザーのコンピューターにインストールされている場合、Office on Windows では Office アドインの代わりに Windows 専用アドインを実行できます。 Windows 専用アドインがアンインストールされた場合、次にホスト Office アプリケーションが起動されると、Office アドインが自動的にアクティブ化されます。 Office アドインの後に Windows 専用アドインがインストールされている場合、Office アプリケーションが再起動されると、Office アドインは非表示になります。詳細については、「 Office アドインが非表示の場合のユーザーの動作」を参照してください。

マニフェストを構成する

重要

Excel、Outlook、PowerPoint、Wordに適用されます。

Office アドインと Windows 専用アドインの間の互換性を有効にするには、「Windows 専用アドインの名前を取得する」セクションで取得した名前を使用して、Office アドインのマニフェストで同等の Windows 専用アドインを特定します。次に、Office on Windows では、Office アドインの代わりに Windows 専用アドインが使用されます (両方がインストールされている場合)。構成は、使用されているマニフェストの種類によって異なります。

Microsoft 365 の統合マニフェスト
アドインのみのマニフェスト

次の例は、Windows 専用アドインを同等のアドインとして指定するマニフェストの部分を示しています。 "alternates.prefer.comAddin.progId" プロパティの値は、Windows 専用アドインを識別します。

注:

プロパティは "comAddin" と呼ばれますが、実際には、アドインが COM か VSTO かに関係なく、任意の Windows 専用アドインを参照します。同様に、"progId" という用語は通常、COM アドインにのみ関連付けられますが、マニフェストでは Windows 専用アドインの名前を参照します。

"extensions" [
  ...
  "alternates" [
    {
      "prefer": {
        "comAddin": {
          "progId": "ContosoAddin"
        }
      }
    }
  ]
]

ヒント

Outlook Web アドインのマニフェストで alternates.prefer プロパティを指定できない場合は、代わりにグループポリシーを構成する必要があります。これは Outlook にのみ適用されます。ガイダンスについては、「Outlook アドインのグループポリシー設定を構成する」を参照してください。

次の例は、Windows 専用アドインを同等のアドインとして指定するマニフェストの部分を示しています。 ProgId 要素の値は Windows 専用アドインを識別し、EquivalentAddins 要素は終了VersionOverridesタグの直前に配置する必要があります。

注:

"ProgId" という用語は通常、COM アドインにのみ関連付けられますが、マニフェストでは、アドインが COM か VSTO かに関係なく、Windows 専用アドインの名前を参照します。

重要

COM アドインと VSTO アドインの両方の <Type> 要素の値として "COM" を使用します。

<VersionOverrides>
  ...
  <EquivalentAddins>
    <EquivalentAddin>
      <ProgId>ContosoAddin</ProgId>
      <Type>COM</Type>
    </EquivalentAddin>
  </EquivalentAddins>
</VersionOverrides>

ヒント

カスタム関数を含む Excel アドインとの XLL UDF の互換性については、「カスタム関数を XLL ユーザー定義関数と互換性のあるものにする」を参照してください。
Outlook の場合のみ、コンピューターの管理者は、グループポリシーを使用して同等の Windows 専用アドインを指定できます。ガイダンスについては、「Outlook アドインのグループポリシー設定を構成する」を参照してください。

Outlook アドインのグループポリシー設定を構成する

コンピューターの管理者権限を持つユーザーは、コンピューターに同等の COM または VSTO アドインがインストールされている Outlook Web アドインを非アクティブ化する設定を使用して、Windows 専用アドインを Outlook アドインと同等に構成グループポリシー。これは、Outlook アドインのマニフェストに同等のアドインマークアップがない場合でも実現できます。次に、クラシック Outlook on Windows では、両方がインストールされている場合、Outlook アドインの代わりに Windows 専用アドインが使用されます。ポリシーを構成する手順を次に示します。

ツールのインストール手順に注意して、最新の管理用テンプレートツールをダウンロードします。
ローカルグループポリシーエディター (gpedit.msc) を開きます。
[User Configuration>Administrative Templates>Microsoft Outlook 2016>Miscellaneous] に移動します。
[同等の COM または VSTO アドインがインストールされている Outlook Web アドインを非アクティブ化する] 設定を選択します。
リンクを開いてポリシー設定を編集します。
Outlook Web アドインを非アクティブ化するダイアログで、次の手順を実行します。
1. [値の名前] を Outlook アドインのマニフェストの ID に設定します。アドインのみのマニフェストで、 <ID> 要素の値を使用します。統合マニフェストで、マニフェストのルートにある id プロパティの値を使用します。エントリの周囲に中かっこ{}を追加しないでください。
2. [値] を、同等の Windows 専用アドインの名前に設定します。「Windows 専用アドインの名前を取得する」セクションを参照してください。
3. [ OK] を選択 して、更新プログラムを有効にします。

Office アドインが非表示の場合のユーザーの動作

同等の Windows 専用アドインが指定されている場合、同等の Windows 専用アドインがインストールされている場合、Office on Windows では Office アドインのユーザーインターフェイス (UI) は表示されません。ただし、Office は Office アドインのリボンボタンのみを非表示にし、インストールを妨げるわけではありません。そのため、Office アドインは UI 内の次の場所に引き続き表示されます。

[マイアドイン] の下。
リボンマネージャーのエントリ (Excel、Word、PowerPointのみ)。

注:

マニフェストで同等の Windows 専用アドインを指定しても、Office on the webや Mac などの他のプラットフォームには影響しません。

次のシナリオでは、ユーザーが Office アドインを取得する方法に応じてどうなるかについて説明します。

Office アドインの Microsoft Marketplace の取得

ユーザーが Microsoft Marketplace から Office アドインを取得し、同等の Windows 専用アドインが既にインストールされている場合、Office は次の処理を行います。

Office アドインをインストールします。
リボンの Office アドイン UI を非表示にします。
Windows 専用アドインリボンボタンをポイントするユーザーのコールアウトを表示します。

Office アドインの一元展開

管理者が一元展開を使用して Office アドインをテナントに展開し、同等の Windows 専用アドインが既にインストールされている場合、ユーザーは変更を表示する前に Office を再起動する必要があります。 Office を再起動すると、次のようになります。

Office アドインをインストールします。
リボンの Office アドイン UI を非表示にします。
Windows 専用アドインリボンボタンをポイントするユーザーのコールアウトを表示します。

埋め込まれた Office アドインと共有されるドキュメント

ユーザーが Windows 専用アドインをインストールした後、埋め込み Office アドインを含む共有ドキュメントを取得した場合、ドキュメントを開くと、Office は次の操作を行います。

Office アドインを信頼するようにユーザーに求めるメッセージを表示します。
信頼されている場合は、Office アドインがインストールされます。
リボンの Office アドイン UI を非表示にします。

その他の Windows 専用アドインの動作

Excel、PowerPoint、Word

ユーザーが同等の Windows 専用アドインをアンインストールした場合、Office on Windows は Office アドイン UI を復元します。

Office アドインに同等の Windows 専用アドインを指定すると、Office アドインの更新プログラムの処理が停止されます。 Office アドインの最新の更新プログラムを取得するには、まず Windows 専用アドインをアンインストールする必要があります。

Outlook

対応する Outlook アドインを無効にするには、Outlook の起動時に Windows 専用アドインを接続する必要があります。

その後の Outlook セッション中に Windows 専用アドインが切断された場合、Outlook が再起動されるまで Outlook アドインは無効のままになる可能性があります。

Windows 専用アドインを非表示にする

注:

このセクションで説明するオプションには、次の制限があります。

Excel、PowerPoint、Wordでのみサポートされます。
この機能をサポートする Office の最小バージョンは、サブスクリプション Office on Windows バージョン 2506 (ビルド 19029.20004) です。

マニフェストを構成する

この機能を構成する詳細は、Office アドインで使用されているマニフェストの種類によって異なります。

Microsoft 365 の統合マニフェスト
アドインのみのマニフェスト

Windows 専用アドインを無効にするには、次の手順を実行します。

まだ存在しない場合は、 "extensions.alternates.hide.windowsExtensions" プロパティを作成します。
子 effect プロパティを windowsExtensions プロパティに追加し、その値を disableWithNotification に設定します。
子 "comAddin" プロパティを windowsExtensions プロパティに追加します。
comAddin プロパティに、子progIds配列プロパティを追加します。
非表示にするすべての Windows 専用アドインの名前を progIds 配列に追加します。これらの名前を取得する方法については、「 Windows 専用アドインの名前を取得する」を参照してください。

注:

"com" という文字列は、履歴上の理由から comAddin 名前に含まれています。マニフェストでは、プロパティは COM または VSTO アドインを参照します。同様に、"progIds" という用語は通常、COM アドインにのみ関連付けられますが、VSTO アドインの名前を progIds 配列に含めることもできます。

次の例は、JSON の外観を示しています。

"extensions" [
  {   
    ...
    "alternates": [
      {
        "hide": {
          "windowsExtensions": {
            "effect": "disableWithNotification",
            "comAddin": {
              "progIds": [
                "ContosoAddin"
              ]
            }
          }
        }
      }
    ]
  }
]

Windows 専用アドインを無効にするには、次の手順を実行します。

<VersionOverrides/> 要素の最後の子として EquivalentAddins を作成します。
非表示にする Windows 専用アドインごとに、<EquivalentAddin> 子を追加します。
<EquivalentAddin> 要素ごとに、<ProgId/> と <Type/> 子をその順序で追加します。
<ProgId/> 要素を、非表示にする Windows 専用アドインの名前に設定します。これらの名前を取得する方法については、「 Windows 専用アドインの名前を取得する」を参照してください。
<Type/> 要素を "COM" に設定します。

注:

<Type>値は、履歴上の理由から "COM" ですが、COM または VSTO アドインを参照します。同様に、 <ProgId> 値には、COM アドインの progId または VSTO アドインの名前を指定できます。
< EquivalentAddins> 要素の最後の子として<Effect> 要素を追加し、その値を DisableWithNotification に設定します。

次に例を示します。

<VersionOverrides>
  ...
  <EquivalentAddins>
    <EquivalentAddin>
      <ProgId>ContosoAddin</ProgId>
      <Type>COM</Type>
    </EquivalentAddin>
    <Effect>DisableWithNotification</Effect>
  </EquivalentAddins>
</VersionOverrides>

Windows 専用アドインが非表示の場合のユーザーの動作

Windows 専用アドインが非表示の場合、同等の Office アドインがインストールされている場合、Windows 上の Office ではユーザーインターフェイス (UI) は表示されません。ポップアップダイアログは、これが発生していることをユーザーに通知します。ただし、Office は Windows 専用アドインのみを非表示にし、インストールを妨げるわけではありません。

ユーザーに使用するアドインを選択できるようにする

注:

このセクションで説明するオプションには、次の制限があります。

Excel、PowerPoint、Wordでのみサポートされます。
この機能をサポートする Office の最小バージョンは、サブスクリプション Office on Windows バージョン 2506 (ビルド 19029.20004) です。

マニフェストを構成する

この機能を構成する詳細は、Office アドインで使用されているマニフェストの種類によって異なります。

Microsoft 365 の統合マニフェスト
アドインのみのマニフェスト

ユーザーに非表示にするアドインを選択できるようにするには、次の手順を実行します。

まだ存在しない場合は、 "extensions.alternates.hide.windowsExtensions" プロパティを作成します。
子 effect プロパティを windowsExtensions プロパティに追加し、その値を userOptionToDisable に設定します。
子 "comAddin" プロパティを windowsExtensions プロパティに追加します。
comAddin プロパティに、子progIds配列プロパティを追加します。
同等のすべての Windows 専用アドインの名前を progIds 配列に追加します。これらの名前を取得する方法については、「 Windows 専用アドインの名前を取得する」を参照してください。

注:

次の例は、JSON の外観を示しています。

"extensions" [
  {   
    ...
    "alternates": [
      {
        "hide": {
          "windowsExtensions": {
            "effect": "userOptionToDisable",
            "comAddin": {
              "progIds": [
                "ContosoAddin"
              ]
            }
          }
        }
      }
    ]
  }
]

Windows 専用アドインを無効にするには、次の手順を実行します。

<VersionOverrides/> 要素の最後の子として EquivalentAddins を作成します。
非表示にする Windows 専用アドインごとに、<EquivalentAddin> 子を追加します。
<EquivalentAddin> 要素ごとに、<ProgId/> と <Type/> 子をその順序で追加します。
<ProgId/> 要素を、ユーザーが決定する非表示/表示状態の Windows 専用アドインの名前に設定します。これらの名前を取得する方法については、「 Windows 専用アドインの名前を取得する」を参照してください。
<Type/> 要素を "COM" に設定します。

注:

<Type>値は、履歴上の理由から "COM" ですが、COM または VSTO アドインを参照します。同様に、 <ProgId> 値には、COM アドインの progId または VSTO アドインの名前を指定できます。
<Effect> 要素を <EquivalentAddins> 要素の最後の子として追加し、その値を UserOptionToDisable に設定します。

次に例を示します。

<VersionOverrides>
  ...
  <EquivalentAddins>
    <EquivalentAddin>
      <ProgId>ContosoAddin</ProgId>
      <Type>COM</Type>
    </EquivalentAddin>
    <Effect>UserOptionToDisable</Effect>
  </EquivalentAddins>
</VersionOverrides>

どのアドインを非表示にするかを選択した場合のユーザーの動作

ユーザーに選択肢を与えるマニフェストを構成すると、Office アドインのインストール時に次のようなダイアログが表示されます。ダイアログの [ 詳細情報 ] リンクは、ユーザーが Office アドインのバージョンの競合を解決する際に役立つ情報を提供する次のヘルプページを指しています。

ユーザーが [はい ] を選択し、Office が Windows 専用アドインを正常に無効にして非表示にした場合は、次のようなダイアログが開き、Office アプリケーションを再起動するようにユーザーに通知されます。

ユーザーが [はい ] を選択しても Office が何らかの理由で Windows 専用アドインを無効にできない場合は、次のようなダイアログが開き、Windows 専用アドインを手動で無効にするようにユーザーに勧めます。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-11-07

次の方法で共有

Office アドインを既存の COM または VSTO アドインと互換性のあるものにする

Windows 専用アドインの名前を取得する

Office アドインを非表示にする

マニフェストを構成する

Outlook アドインのグループ ポリシー設定を構成する

Office アドインが非表示の場合のユーザーの動作

Office アドインの Microsoft Marketplace の取得

Office アドインの一元展開

埋め込まれた Office アドインと共有されるドキュメント

その他の Windows 専用アドインの動作

Excel、PowerPoint、Word

Outlook

Windows 専用アドインを非表示にする

マニフェストを構成する

Windows 専用アドインが非表示の場合のユーザーの動作

ユーザーに使用するアドインを選択できるようにする

マニフェストを構成する

どのアドインを非表示にするかを選択した場合のユーザーの動作

関連項目

フィードバック

その他のリソース

Outlook アドインのグループポリシー設定を構成する