SharePoint アドインのテナントと展開スコープTenancies and deployment scopes for SharePoint Add-ins

SharePoint のテナンシーは、SharePoint ファームまたは SharePoint Online 内の一連のサイト コレクションです。A SharePoint tenancy is a set of site collections in either a SharePoint farm or in SharePoint Online. SharePoint Online では、サイト コレクションは 1 つの顧客アカウントに属します。In SharePoint Online, the site collections belong to a single customer account. SharePoint ファームでは、サイト コレクションを、1 つの SharePoint Web アプリケーション内のすべてのサイト コレクションまたはそれらのサブセットにすることも、ファーム内の複数の Web アプリケーションの一連のサイト コレクションにすることもできます。In a SharePoint farm, the site collections can be all the site collections in a SharePoint web application or a subset of them, or it can be a set of site collections from across multiple web applications in the farm. SharePoint Web アプリケーションの場合と同様に、テナンシーには SharePoint アドインのアドイン カタログを含めることができます。A tenancy can have a SharePoint add-in catalog just as a SharePoint web application can.

テナンシーとアドイン スコープTenancies and add-in scope

SharePoint アドインには、アドイン スコープがあります。A SharePoint Add-in has an add-in scope. 使用可能な 2 つのアドインのスコープは、Web スコープとテナント スコープです。The two possible add-in scopes are web scope or tenant scope. この違いはアドインの固有の特性ではなく、開発者がアドインのスコープを決めることもできません。The difference is not an intrinsic property of the add-in, and you, the developer, do not decide what the scope of your add-in is. アドインのインストール方法の副次的な結果としてテナント管理者が決定します。The decision is made by tenant administrators as a side effect of how the add-in is installed.

アドインは、テナンシーのアドイン カタログにアップロードされると、すぐにテナンシー内の Web サイトに Web サイト単位でインストールできるようになります。After an add-in is uploaded to the add-in catalog of a tenancy, it is immediately available to be installed on websites within the tenancy on a website-by-website basis. このようにインストールされるアドインには Web スコープがあります。Add-ins that are installed this way have web scope.

ただし、テナント管理者にはもう 1 つの選択肢があります。Tenant administrators have another option, however. テナント管理者は、テナンシー内の Web サイトのサブセットにアドインをバッチ インストールすることもできます。They can choose to batch install the add-in to a subset of websites within the tenancy. このようにインストールされるアドインにはテナント スコープがあります。Add-ins that are installed in this way have tenant scope. テナント管理者は、管理パスのリスト、サイト テンプレートのリスト、またはサイト コレクションのリストを使用して、アドインをインストールする Web サイトを指定できます。The tenant admin can specify which websites the add-in is installed to by means of a list of managed paths, a list of site templates, or a list of site collections. バッチ インストールされたアドインは、テナント管理者のみがアンインストールできます。An add-in that has been batch-installed can only be uninstalled by a tenant administrator. テナント管理者がアドインをアンインストールすると、アドインはテナンシー内のすべての Web サイトからアンインストールされます。When the tenant admin uninstalls the add-in, it is uninstalled from every website in the tenancy. バッチ インストールされたアドインを Web サイトごとにアンインストールすることはできません。Users can't uninstall a batch-installed add-in on a website-by-website basis. 同じ原則が、バッチ インストールされたアドインの更新にも適用されます。つまり、テナント管理者だけがアドインを更新でき、インストール先のテナンシー内のすべての Web サイトでバッチ更新されます。The same principle applies to updating a batch-installed add-in: only a tenant administrator can do it, and it is batch-updated on every website in the tenancy where it is installed.

アプリ Web を含むアプリがバッチ インストールされた場合、アドイン Web が 1 つだけ作成され、アドインがインストールされるすべてのホスト Web サイトによってそのアドイン Web が共有されます。If an add-in that includes an add-in web is batch-installed, only one add-in web is created, and it is shared by all the host websites on which the add-in is installed. アドイン Web は組織のアドイン カタログのサイト コレクションに配置されます。The add-in web is located in the site collection of the organization's add-in catalog.

テナンシー内で新しいサイト コレクションを作成すると、バッチ インストール済みのアドインが自動的に新しいサイト コレクションにインストールされます。When new site collections are created in the tenancy, add-ins that were previously batch-installed are automatically installed on the new site collection.

注意

アドイン スコープをフィーチャー スコープと混同しないでください。Add-in scope should not be confused with Feature scope. フィーチャー スコープは、フィーチャー内の要素の展開場所を決定します。Feature scope determines where the elements in a Feature are deployed. その候補には、ファームWeb アプリケーションサイト (つまり、サイト コレクション)、および Web が挙げられます。The possibilities include Farm, WebApplication, Site (that is, site collection), and Web. Web のみが SharePoint アドイン内のフィーチャー (ホスト Web フィーチャーとアドイン パッケージ内の .wsp 内部のフィーチャーの両方) に対して許可されます。Only Web is permitted for Features in SharePoint Add-ins (both host web features and features inside a .wsp in an add-in package).

アドイン スコープはアドイン アクセス許可レベルとも混同しないでください。Add-in scope should also not be confused with add-in permission levels. SharePoint アドインは、リスト、Web、サイト コレクション、およびテナンシーのレベルで SharePoint コンテンツの全部または一部のパーツに対するアクセス許可を要求できます。SharePoint Add-ins can request permissions to all or selected parts of SharePoint content at the levels of list, web, site collection, and tenancy. テナント スコープでアドインをインストールすると、それ以外の方法では付与されないアクセス許可が付与されず、SharePoint セキュリティ モデルのキー プロビジョンもキャンセルされません。Installing an add-in with tenant scope does not give it permissions that it would not otherwise have, nor does it cancel key provisions of the SharePoint security model. アドインのアクセス許可の詳細については、「SharePoint でのアドインのアクセス許可」を参照してください。For more information about add-in permissions, see Add-in permissions in SharePoint.

テナント スコープ アドインの制限事項Limitations of tenant-scoped add-ins

次の種類のアドインは、バッチ インストールされている場合は正常に機能しません。The following types of add-ins will not work correctly when batch-installed:

  • リボンのカスタム アクションが含まれるアドイン (メニュー アイテムとして展開されるカスタム アクションは許可されます)Add-ins that contain a custom action for the ribbon (custom actions that are deployed as menu items are allowed)
  • アドイン パーツが含まれるアドインAdd-ins that contain an add-in part

また、SharePoint Online の Office 365 Small Business Premium バージョンでは、テナント スコープを持つインストールは行えません。In addition, note again that installation with tenant scope is not possible in the Office 365 Small Business Premium version of SharePoint Online.

テナンシー内の複数の Web サイトでアドインをインストール、アンインストール、および更新する方法How to install, uninstall, and update an add-in on multiple websites in a tenancy

アドインを Office ストアからインストールするかアドイン カタログからインストールするかに関係なく、テナント管理者は、以下の手順を実行して、テナンシー内の複数の Web サイトにアドインをインストール、アンインストール、および更新できます。Regardless of whether an add-in is installed from the Office Store or from an add-in catalog, tenant admins can install it to multiple websites in a tenancy, uninstall it, and update it by using the following procedures.

複数の Web サイトに SharePoint アドインをインストールするにはTo install a SharePoint Add-in to multiple websites

  1. 会社のカタログ Web サイトの [サイト コンテンツ] ページに移動します。Go to the Site Contents page of the corporate catalog website.

  2. [アドインの追加] を選択し、他の SharePoint Web サイトでの場合と同じように、アドインをインストールします。Select Add an add-in, and install the add-in just as you would on any other SharePoint website.

  3. アドインがインストールされたら、[サイト コンテンツ] ページ内のアドインへのリンクの上にカーソルを移動します。After the add-in is installed, hover over the link to the add-in on the Site Contents page. [...] リンクが表示されます。A "..." link appears.

  4. リンクを選択すると、吹き出しが表示されます。Select the link, and a callout appears.

  5. メニューの [ 展開] を選択します。Select Deployment on the menu.

  6. 表示される展開 UI を使用して、アドインをインストールするサイト コレクションを指定します。管理パス、サイト テンプレート、または URL でフィルター処理できます。フィルターには論理 "OR" 関係があります。つまり、アドインは、1 つ以上の任意のフィルターを渡すすべてのサイト コレクションの集合にインストールされます。Use the deployment UI that opens to specify the site collections to which you want the add-in installed. You can filter by managed paths, site templates, or URLs. The filters have a logical "OR" relationship: the add-in is installed to the union of all the site collections that pass any one or more of the filters.

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

バッチ インストールした SharePoint アドインをアンインストールするにはTo uninstall a batch-installed SharePoint Add-in

  1. 会社のカタログ Web サイトの [サイト コンテンツ] ページに移動します。Go to the Site Contents page of the corporate catalog website.

  2. [サイト コンテンツ] ページ内のアドインへのリンクの上にカーソルを移動します。Hover over the link to the add-in on the Site Contents page. [...] リンクが表示されます。A "..." link appears.

  3. リンクを選択すると、吹き出しが表示されます。Select the link, and a callout appears.

  4. 吹き出しの [ 削除] を選択します。Select Remove on the callout.

バッチ インストールした SharePoint アドインを更新するにはTo update a batch-installed SharePoint Add-in

  1. 会社のカタログ Web サイトの [サイト コンテンツ] ページに移動します。Go to the Site Contents page of the corporate catalog website. アドインで利用できる更新プログラムがある場合は、アドインの横にメッセージが表示されます。If there is an update available for an add-in, a message appears next to the add-in. アドインを更新するリンクも表示されます。There will be a link to update the add-in.

  2. リンクを選択してアドインを更新します。Select the link to update the add-in.

  3. アドインのアクセス許可を承認するように求めるプロンプトが表示されたら、[信頼する] を選択します。When you are prompted to approve the permission requests of the add-in, select Trust It.

関連項目See also