SharePoint アドインのテナントと展開スコープ

  • [アーティクル]

SharePoint のテナンシーは、SharePoint ファームまたは SharePoint Online 内の一連のサイト コレクションです。 SharePoint Online では、サイト コレクションは 1 つの顧客アカウントに属します。 SharePoint ファームでは、サイト コレクションを、1 つの SharePoint Web アプリケーション内のすべてのサイト コレクションまたはそれらのサブセットにすることも、ファーム内の複数の Web アプリケーションの一連のサイト コレクションにすることもできます。 SharePoint Web アプリケーションの場合と同様に、テナンシーには SharePoint アドインのアドイン カタログを含めることができます。

テナンシーとアドイン スコープ

SharePoint アドインには、アドイン スコープがあります。 使用可能な 2 つのアドインのスコープは、Web スコープとテナント スコープです。 この違いはアドインの固有の特性ではなく、開発者がアドインのスコープを決めることもできません。 アドインのインストール方法の副次的な結果としてテナント管理者が決定します。

アドインは、テナンシーのアドイン カタログにアップロードされると、すぐにテナンシー内の Web サイトに Web サイト単位でインストールできるようになります。 このようにインストールされるアドインには Web スコープがあります。

ただし、テナント管理者にはもう 1 つの選択肢があります。 テナント管理者は、テナンシー内の Web サイトのサブセットにアドインをバッチ インストールすることもできます。 このようにインストールされるアドインにはテナント スコープがあります。 テナント管理者は、管理パスのリスト、サイト テンプレートのリスト、またはサイト コレクションのリストを使用して、アドインをインストールする Web サイトを指定できます。 バッチ インストールされたアドインは、テナント管理者のみがアンインストールできます。 テナント管理者がアドインをアンインストールすると、アドインはテナンシー内のすべての Web サイトからアンインストールされます。 バッチ インストールされたアドインを Web サイトごとにアンインストールすることはできません。 同じ原則が、バッチ インストールされたアドインの更新にも適用されます。つまり、テナント管理者だけがアドインを更新でき、インストール先のテナンシー内のすべての Web サイトでバッチ更新されます。

アプリ Web を含むアプリがバッチ インストールされた場合、アドイン Web が 1 つだけ作成され、アドインがインストールされるすべてのホスト Web サイトによってそのアドイン Web が共有されます。 アドイン Web は組織のアドイン カタログのサイト コレクションに配置されます。

テナンシー内で新しいサイト コレクションを作成すると、バッチ インストール済みのアドインが自動的に新しいサイト コレクションにインストールされます。

注:

アドイン スコープをフィーチャー スコープと混同しないでください。 フィーチャー スコープは、フィーチャー内の要素の展開場所を決定します。 その候補には、ファーム、Web アプリケーション、サイト (つまり、サイト コレクション)、および Web が挙げられます。 Web のみが SharePoint アドイン内のフィーチャー (ホスト Web フィーチャーとアドイン パッケージ内の .wsp 内部のフィーチャーの両方) に対して許可されます。

アドイン スコープはアドイン アクセス許可レベルとも混同しないでください。 SharePoint アドインは、リスト、Web、サイト コレクション、およびテナンシーのレベルで SharePoint コンテンツの全部または一部のパーツに対するアクセス許可を要求できます。 テナント スコープでアドインをインストールすると、それ以外の方法では付与されないアクセス許可が付与されず、SharePoint セキュリティ モデルのキー プロビジョンもキャンセルされません。 アドインのアクセス許可の詳細については、「SharePoint でのアドインのアクセス許可」を参照してください。

テナント スコープ アドインの制限事項

次の種類のアドインは、バッチ インストールされている場合は正常に機能しません。

  • リボンのカスタム アクションが含まれるアドイン (メニュー アイテムとして展開されるカスタム アクションは許可されます)
  • アドイン パーツが含まれるアドイン

また、SharePoint Online の Office 365 Small Business Premium バージョンでは、テナント スコープを持つインストールは行えません。

テナンシー内の複数の Web サイトでアドインをインストール、アンインストール、および更新する方法

アドインを Office ストアからインストールするかアドイン カタログからインストールするかに関係なく、テナント管理者は、以下の手順を実行して、テナンシー内の複数の Web サイトにアドインをインストール、アンインストール、および更新できます。

複数の Web サイトに SharePoint アドインをインストールするには

  1. 会社のカタログ Web サイトの [サイト コンテンツ] ページに移動します。

  2. [アドインの追加] を選択し、他の SharePoint Web サイトでの場合と同じように、アドインをインストールします。

  3. アドインがインストールされたら、[サイト コンテンツ] ページ内のアドインへのリンクの上にカーソルを移動します。 [...] リンクが表示されます。

  4. リンクを選択すると、吹き出しが表示されます。

  5. メニューの [ 展開] を選択します。

  6. 開いた展開 UI を使用して、アドインをインストールするサイト コレクションを指定します。 管理パス、サイト テンプレート、または URL でフィルター処理できます。 フィルターには論理的な "OR" 関係があります。アドインは、1 つ以上のフィルターを渡すすべてのサイト コレクションの和集合にインストールされます。

  7. [ OK] をクリックします。

バッチ インストールした SharePoint アドインをアンインストールするには

  1. 会社のカタログ Web サイトの [サイト コンテンツ] ページに移動します。

  2. [サイト コンテンツ] ページ内のアドインへのリンクの上にカーソルを移動します。 [...] リンクが表示されます。

  3. リンクを選択すると、吹き出しが表示されます。

  4. 吹き出しの [ 削除] を選択します。

バッチ インストールした SharePoint アドインを更新するには

  1. 会社のカタログ Web サイトの [サイト コンテンツ] ページに移動します。 アドインで利用できる更新プログラムがある場合は、アドインの横にメッセージが表示されます。 アドインを更新するリンクも表示されます。

  2. リンクを選択してアドインを更新します。

  3. アドインのアクセス許可を承認するように求めるプロンプトが表示されたら、[信頼する] を選択します。

関連項目