サイト コレクションのアプリ カタログを使用するUse the site collection app catalog

適用対象: Office 365Applies to: Office 365

SharePoint テナント管理者は、サイト コレクションのアプリ カタログを使用して、管理を分散し、SharePoint アドインおよび SharePoint Framework ソリューションの特定のサイトへの展開をスコープ設定することができます。Using site collection app catalogs, SharePoint tenant administrators can decentralize the management and scope the deployment of SharePoint add-ins and SharePoint Framework solutions to specific sites.

サイト コレクションのアプリケーション カタログを使用する理由Why site collection app catalogs

これまでは、すべてのアドインと SharePoint Framework ソリューションをテナント アプリ カタログで集中管理する必要がありました。Previously, all add-ins and SharePoint Framework solutions had to be managed centrally in the tenant app catalog. テナント管理者は組織内の他のユーザーにアクセスを委任できますが、展開されたパッケージはすべてのサイト コレクションで表示できました。While tenant administrators could delegate the access to other people in the organization, a deployed package was visible on all site collections. SharePoint は、アドインと SharePoint Framework ソリューションを特定のサイトにのみ展開する方法をサポートしていませんでした。SharePoint offered no supported way of deploying add-ins and SharePoint Framework solutions only to specific sites.

サイト コレクションのアプリ カタログの導入により、テナント管理者は特定のサイトでアプリ カタログを有効にすることができます。With the introduction of site collection app catalogs, tenant administrators can enable app catalog on the specific sites. これを有効にすると、サイト コレクション管理者は、特定のサイト コレクションでのみ使用できる SharePoint アドインと SharePoint Framework ソリューションを展開できます。Once enabled, site collection administrators can deploy SharePoint add-ins and SharePoint Framework solutions that will be available only in that particular site collection.

次のスキーマは、サイト コレクションのアプリ カタログの使用方法を示しています。The following schema illustrates using site collection app catalogs:

サイト コレクションのアプリ カタログの概念を示すダイアグラム

Office 365 テナントには、テナントのアプリ カタログがあります。In your Office 365 tenant you have a tenant app catalog. このアプリ カタログに展開されるソリューションは、テナント内の任意のサイト コレクションにインストールできます。Solutions deployed to this app catalog, can be installed in any site collection in the tenant. テナント管理者は、特定のサイト コレクションでサイト コレクションのアプリ カタログを有効にするよう選択できます。Tenant administrators can choose to enable site collection app catalogs on specific site collections. サイト コレクションのアプリ カタログに展開されているソリューションは、その特定のサイト コレクションにのみインストールできます。Solutions deployed to the site collection app catalogs can only be installed in that particular site collection.

サポートされている機能Supported capabilities

SharePoint アドインと SharePoint Framework のパッケージの両方をサポートSupport for both SharePoint add-ins and SharePoint Framework packages

テナントのアプリ カタログと同様に、サイト コレクションのアプリ カタログでは、SharePoint アドインと SharePoint Framework ソリューション (.sppkg) の両方を展開できます。In site collection app catalogs, just as in tenant app catalog, you can deploy both SharePoint add-ins and SharePoint Framework solutions (.sppkg).

ソリューション パッケージ内のアセットを含むIncluding assets in solution packages

アセットが含まれる SharePoint Framework ソリューション パッケージは、サイト コレクションのアプリ カタログに展開することができます。SharePoint Framework solution packages that contain assets, can be deployed to site collection app catalogs. 含まれるアセットは、サイト コレクションのアプリ カタログがあるのと同じサイト コレクションの事前構成済みのドキュメント ライブラリに展開されます。Included assets will be deployed to a preconfigured document library in the same site collection as where the site collection app catalog is located. Office 365 Public CDN が構成されている場合、アセットは CDN から処理されます。If the Office 365 Public CDN is configured, assets will be served from the CDN. それ以外の場合、アセットはドキュメント ライブラリから直接処理されます。Otherwise, assets will be served directly from the document library.

テナント スコープの展開Tenant-scoped deployment

サイト コレクションのアプリ カタログへのテナント全体の展開をサポートする SharePoint Framework ソリューションを展開する場合、組織内のすべてのサイトでこのソリューションを使用できるようにするかどうかを尋ねるダイアログ ボックスが表示されます。When deploying SharePoint Framework solutions that support tenant-wide deployment to a site collection app catalog, you will be prompted if you want to make this solution available to all sites in the organization. 言い回しは異なるかもしれませんが、このボックスをチェックすると、ソリューションはアプリ カタログと同じ場所でのみすぐに利用できるようになります。Despite the wording, if you check this box, the solution will be available immediately only in the same site collection as where the app catalog is. 組織内の他のサイト コレクションでは、ソリューションを使用することはできません。Other site collections in your organizations will not be able to use the solution. このオプションをチェックしなかった場合、使用する前にサイトにソリューションを明示的にインストールする必要があります。If you don't check this option, you will have to explicitly install the solution in your site, before you will be able to use it.

現在の制限事項Current limitations

サイト コレクションのアプリ カタログの構成および管理Configure and manage site collection app catalogs

SharePoint Online 管理シェルを使用して、サイト コレクションのアプリ カタログを構成および管理することができます。You can configure and manage site collection app catalogs using the SharePoint Online Management Shell.

注意

テナントでサイト コレクションのアプリ カタログを管理する前に、2017 年 11 月以降の SharePoint Online 管理シェルがインストールされていることを確認してください。Before you can manage site collection app catalogs in your tenant, ensure that you have installed SharePoint Online Management Shell from November 2017 or newer.

また、Office 365 CLI を使用して、SharePoint サイト コレクションのアプリ カタログを管理することもできます。Alternatively, you can use the Office 365 CLI to manage your SharePoint site collection app catalogs. Office 365 CLI は、Windows、MacOS、Linux などのあらゆるプラットフォームで使用できるクロスプラットフォーム コマンド ライン インターフェイスです。The Office 365 CLI is a cross-platform command line interface that can be used on any platform, including Windows, MacOS and Linux.

サイト コレクションのアプリ カタログを作成するCreate a site collection app catalog

注意

SharePoint Online PowerShell を使用する場合は、次のスクリプトを実行する前に、Connect-SPOService コマンドレットを使用して SharePoint Online テナントに接続します。Before running the following script, connect to your SharePoint Online tenant using the Connect-SPOService cmdlet when using the SharePoint Online PowerShell. さらに、テナントのアプリ カタログがテナントに作成されていることを確認します。Also ensure, that you have a tenant app catalog created in your tenant. 作成されていない場合、コマンドレットは次のエラーで失敗します。If you don't, the cmdlet will fail with the following error:

Cannot invoke method or retrieve property from null object. Object returned by the
following call stack is null. "TenantAppCatalog
RootWeb
GetSiteByUrl
new Microsoft.Online.SharePoint.TenantAdministration.Tenant()
"

また、Office 365 CLI を使用している場合は、まず spo connect コマンドを使用してテナントに接続する必要があります。Alternatively, if you are using the Office 365 CLI, you must first connect to your tenant using the spo connect command.

サイト コレクションのアプリ カタログを作成するには、Add-SPOSiteCollectionAppCatalog コマンドレットを使用して、アプリ カタログを作成するサイト コレクションを -Site パラメーターとして渡します。To create a site collection app catalog, use the Add-SPOSiteCollectionAppCatalog cmdlet passing the site collection where the app catalog should be created as the -Site parameter.

# get a reference to the site collection where the
# site collection app catalog should be created
$site = Get-SPOSite https://contoso.sharepoint.com/sites/marketing

# create site collection app catalog
Add-SPOSiteCollectionAppCatalog -Site $site

また、Office 365 CLI を使用している場合は、spo site appcatalog add コマンドを使用しますAlternatively, use the spo site appcatalog add command if you are using the Office 365 CLI

spo site appcatalog add --url https://contoso.sharepoint.com/sites/marketing

このスクリプトを実行すると、Apps for SharePoint ライブラリがサイト コレクションに追加され、そこに SharePoint アドインと SharePoint Framework ソリューションを展開することができます。After executing this script, the Apps for SharePoint library will be added to your site collection where you will be able to deploy SharePoint add-ins and SharePoint Framework solutions.

サイト コレクションのアプリ カタログを無効にするDisable the site collection app catalog

注意

次のスクリプトを実行する前に、SharePoint Online PowerShell 用の Connect-SPOService コマンドレットまたは Office 365 CLI 用の spo connect コマンドを使用して、SharePoint Online テナントに接続します。Before running the following script, connect to your SharePoint Online tenant using the Connect-SPOService cmdlet for the SharePoint Online PowerShell or spo connect command for the Office 365 CLI.

サイト コレクションのアプリ カタログをサイト コレクションで無効にするには、Remove-SPOSiteCollectionAppCatalog コマンドレットを使用して、アプリ カタログを無効にするサイト コレクションを -Site パラメーターとして渡します。To disable the site collection app catalog in your site collection, use the Remove-SPOSiteCollectionAppCatalog cmdlet passing the site collection where the app catalog should be disabled as the -Site parameter. または、サイト コレクションの ID がある場合は、代わりに Remove-SPOSiteCollectionAppCatalogById コマンドレットを使用することもできます。Alternatively, if you have your site collection's ID, you can use the Remove-SPOSiteCollectionAppCatalogById cmdlet instead.

注意

名前にかかわらず、Remove-SPOSiteCollectionAppCatalog および Remove-SPOSiteCollectionAppCatalogById コマンドレットによって、サイト コレクションのアプリ カタログがサイト コレクションから削除されることはありません。Despite the naming, the Remove-SPOSiteCollectionAppCatalog and Remove-SPOSiteCollectionAppCatalogById cmdlets don't remove the site collection app catalog from the site collection. 代わりに、サイト コレクションに展開されているソリューションを展開または使用できないようにするため、サイト コレクションを無効にします。Instead, they disable it so that it's not possible to deploy or use any solutions deployed in it.

# get a reference to the site collection in which
# the site collection app catalog should be disabled
$site = Get-SPOSite https://contoso.sharepoint.com/sites/marketing

# disable the site collection app catalog
Remove-SPOSiteCollectionAppCatalog -Site $site

また、Office 365 CLI を使用している場合は、spo site appcatalog remove コマンドを使用しますAlternatively, use the spo site appcatalog remove command if you are using the Office 365 CLI

spo site appcatalog remove --url https://contoso.sharepoint.com/sites/marketing

このスクリプトを実行した後も、Apps for SharePoint ライブラリはサイト コレクションに表示されたままになりますが、サイト コレクションに展開されているどのソリューションも展開や使用ができなくなります。After executing this script, the Apps for SharePoint library will be still visible in your site collection, but you will not be able to deploy or use any solutions deployed in it.

考慮事項Considerations

ガバナンスGovernance

現時点では、サイト コレクションのアプリ カタログが有効になっているテナントで、すべてのサイト コレクションのリストを表示することはできません。Currently, it's not possible to list all site collections in the tenant that have the site collection app catalog enabled.

セキュリティSecurity

サイト コレクションのアプリ カタログにソリューションを展開する前に、サイト コレクション管理者は、これらのソリューションが組織のポリシーを満たしていることを確認する必要があります。Before deploying solutions to site collection app catalogs, site collection administrators should verify that these solutions meet organizational policies. サイト コレクションのアプリ カタログにインストールされているソリューションは、これらの特定のサイト コレクションでのみ使用できますが、テナント内の他のサイトからのリソースにアクセスできる可能性があります。このため、管理者は、展開しようとしているソリューションが意図したとおりに機能することを確認する必要があります。Although solutions installed in site collection app catalogs can only be used in these particular site collections, they can potentially access resources from other sites in the tenant so administrators should ensure that the solutions they are about to deploy work as intended.

関連項目See also

  • [サイト コレクションのアプリ カタログを管理する](https://support.office.com/ja-JP/article/Manage-the-Site-Collection-App-Catalog-928b9b61-a9de-4563-a7d1-6231aa9d4d19)[Manage the Site Collection App Catalog](https://support.office.com/en-us/article/Manage-the-Site-Collection-App-Catalog-928b9b61-a9de-4563-a7d1-6231aa9d4d19)
  • Office 365 CLIOffice 365 CLI