SharePoint 埋め込みコンテナーの種類

コンテナーの種類は SharePoint Embedded リソースであり、SharePoint Embedded アプリケーションとコンテナーのセットとの間の関係、アクセス権限、課金アビリティを定義します。また、コンテナーの種類は、コンテナーのセットに対する動作を定義します。

各コンテナーの種類は、所有アプリケーションと呼ばれる 1 つの SharePoint Embedded アプリケーションと強く結合されています。所有するアプリケーション開発者は、コンテナーの種類の作成と管理を担当します。 SharePoint Embedded では、所有するアプリケーションとコンテナーの種類の間に 1 対 1 の関係が義務付けられています。

コンテナーの種類は、各コンテナーインスタンスで不変プロパティ (ContainerTypeID) として表され、SharePoint Embedded エコシステム全体で次のように使用されます。

アクセス許可: SharePoint Embedded アプリケーションをコンテナーの種類に関連付けて、その種類のコンテナーインスタンスにアクセスする必要があります。関連付けられると、アプリケーションはその型のすべてのコンテナーインスタンスにアクセスできます。実際のアクセス権は、application-ContainerTypeID アクセス許可設定によって決まります。既定では、所有するアプリケーションには、厳密に結合されているコンテナーの種類のすべてのコンテナーインスタンスに対するフルアクセス権があります。 SharePoint Embedded Authorization の詳細については、こちらをご覧ください。
簡単な探索: コンテナーの種類は試用目的で作成できるため、開発者は SharePoint Embedded アプリケーション開発を探索し、その機能を無料で評価できます。
課金: 試用以外の目的のコンテナーの種類は課金対象であり、Azure サブスクリプションで作成する必要があります。コンテナーの使用状況は従量制課金されます。測定と SharePoint Embedded 課金エクスペリエンスの詳細について説明します。
構成可能な動作: コンテナー型は、その型のすべてのコンテナーインスタンスに対して選択した動作を定義します。コンテナーの種類の構成の設定について詳しくは、こちらをご覧ください。

注:

作成時に作成するコンテナーの種類の目的を指定する必要があります。目的によっては、Azure サブスクリプション ID を指定する必要がある場合と必要ない場合があります。試用版用に設定されたコンテナーの種類は、運用環境用に変換することも、その逆に変換することもできません。
Standardコンテナーとパススルーコンテナーの種類は、作成後に変換できません。標準のコンテナーの種類を変換して課金をパススルーする場合、またはその逆を行う場合は、コンテナーの種類を削除して再作成する必要があります。
コンテナーの種類を構成するには、最新バージョンの SharePoint PowerShell を使用する必要があります。 SharePoint Embedded のWindows PowerShellに関するアクセス許可と最新の情報については、「SharePoint Embedded Management Shell の概要」のドキュメントを参照してください。

コンテナーの種類の作成

SharePoint Embedded には、作成できる 2 つの異なるコンテナーの種類があります。

試用版コンテナーの種類
Standard コンテナーの種類

SharePoint Embedded コンテナーの種類を作成するための前提条件

次のSharePoint Online 管理シェルを使用して、新しいコンテナーの種類が作成されます。

最新バージョンのSharePoint Online 管理シェルをダウンロードしてインストールする
スタート画面からSharePoint Online 管理シェルを開き、「sharepoint」と入力し、[SharePoint Online 管理シェル] を選択します。
テナントに関連付けられている管理者資格情報を指定して、 Connect-SPOService コマンドレットを使用して SPO サービスに接続します。 Connect-SPOService の使用方法については、リンクされたドキュメントを参照してください。

テナントの要件

Microsoft 365 テナントでは、SharePoint のアクティブなインスタンスが必要です。
SharePoint 埋め込みコンテナーの種類とコンテナーを認証するユーザーは、Entra ID (メンバーとゲスト) に存在する必要があります

注:

コンテナーに格納されている Microsoft Office ドキュメントで共同作業するには、Office ライセンスは必要ありません。

役割とアクセス許可

SharePoint Embedded の課金関係を設定する管理者は、Azure サブスクリプションに対する所有者または共同作成者のアクセス許可を持っている必要があります。
管理課金コマンドレットを操作するには、SharePoint Embedded Administrator または Global 管理ロールが必要です。

Azure のサブスクリプション

標準の課金コンテナーの種類の場合、グローバル管理者または SharePoint Embedded Administrator は次のように設定する必要があります。

既存の SharePoint テナント
テナント内の Azure サブスクリプション
Azure サブスクリプションにアタッチされているリソースグループ

試用版コンテナーの種類

コンテナーの種類は、試用版/開発目的で作成でき、Azure 課金プロファイルにはリンクされません。これにより、開発者は SharePoint Embedded アプリケーション開発を探索し、その機能を無料で評価できます。試用版コンテナーの種類の場合、開発者テナントは、使用しているテナントと同じです。各開発者は、テナントの試用版の状態で一度に 1 つのコンテナーの種類のみを持つことができます。試用版コンテナーの種類は最大 30 日間有効ですが、この期間内はいつでも削除できます。

試用目的でコンテナーの種類を作成するには、次のことができます。

SharePoint Embedded Visual Studio Code 拡張機能を使用して、コンテナーの種類をわずか数手順で作成します。 Visual Studio Code 拡張機能によって、コンテナーの種類が登録され、コンテナーが自動的に作成されます。
SharePoint PowerShell を使用します。次のコマンドレットを実行するには、SharePoint Embedded 管理者またはグローバル管理者である必要があります。 SharePoint 管理者の場合は、SharePoint Embedded 管理ロールを自分に付与して、これらのコマンドレットを実行します。
```
New-SPOContainerType [–TrialContainerType] [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [<CommonParameters>]
```

試用版コンテナーの種類には、次の制限が適用されます。

コンテナーの種類のコンテナーは最大 5 つ作成できます。これには、アクティブなコンテナーとごみ箱内のコンテナーが含まれます。
各コンテナーには、最大 1 GB のストレージ領域があります。
コンテナーの種類は 30 日後に期限切れになり、そのコンテナーの種類の既存のコンテナーへのアクセスは削除されます。
試用版の新しいコンテナーの種類を作成するには、試用版の状態で既存のコンテナーの種類のすべてのコンテナーを完全に削除する必要があります。これには、削除されたコンテナーコレクション内のコンテナーが含まれます。
コンテナーの種類は、開発者テナントで動作するように制限されています。他の使用しているテナントにデプロイすることはできません。

Standard コンテナーの種類 (試用不可)

SharePoint Embedded の標準コンテナーの種類は、アプリケーションとそのコンテナー間の関係、アクセス権、課金プロファイルを定義します。アプリケーションがコンテナーと対話する方法 (アクセス許可を含む) が確立され、試用以外の目的で課金プロファイルに関連付けられます。各テナントには、一度に 25 種類のコンテナーを使用できます。

課金プロファイル

SharePoint Embedded は従量課金制の従量課金制 (PAYG) オファリングです。つまり、使用した分だけ料金を支払います。 SharePoint Embedded には、SharePoint Embedded アプリケーションを開発しているテナントがそれぞれのコンテナーの種類に応じて選択できる 2 つの課金モデルが用意されており、独自のビジネス要件に合わせて調整できます。 2 つの課金モデルは、Standardとパススルー課金です。

Standard コンテナーの種類 - 課金プロファイル

標準請求プロファイルでは、すべての従量課金ベースの料金が、アプリケーションを所有または開発するテナントに直接課金されます。開発者テナントの管理者は、標準コンテナーの種類を作成するときに、有効な課金プロファイルを確立する必要があります。

Standard

各開発者テナントは、1 つの試用版コンテナーの種類と 4 つの標準コンテナーの種類または 5 つの標準コンテナーの種類で構成される、最大 5 つのコンテナーの種類を作成できます。 Standardコンテナーの種類は、New-SPOContainerType コマンドレットを使用して作成されます。

標準コンテナーの種類を作成するには、次のものが必要です。

SharePoint PowerShell を使用します。このコマンドレットを実行するには、SharePoint Embedded 管理者またはグローバル管理者である必要があります。 SharePoint 管理者の場合は、SharePoint Embedded 管理ロールを自分に付与して、これらのコマンドレットを実行します。
通常の課金には、Azure portalに Azure サブスクリプションとリソースグループが存在する必要があります。
アプリの登録は、Microsoft Entra ID で作成する必要があります。

Azure 課金プロファイルを使用して標準のコンテナーの種類を作成するには、次のコマンドレットを使用します。

New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [<CommonParameters>]

コンテナーの種類が作成されたら、Azure 課金プロファイルを追加します。

Add-SPOContainerTypeBilling –ContainerTypeId <ContainerTypeId> -AzureSubscriptionId <AzureSubscriptionId> -ResourceGroup <ResourceGroup> -Region <Region>

注:

SharePoint Embedded の課金関係を設定するユーザーまたは管理者は、Azure サブスクリプションに対する所有者または共同作成者のアクセス許可を持っている必要があります。

すべてのコンテナーの種類には、所有アプリケーションが必要です。

1 つの所有アプリで所有できるコンテナーの種類は一度に 1 つだけです。

Azure サブスクリプションは、任意の数のコンテナーの種類にアタッチできます。

上記のコマンドレットが SubscriptionNotRegistered エラーで失敗した場合は、 Microsoft.Syntex がサブスクリプションのリソースプロバイダーとして登録されていないためです。コマンドレットは、リソースプロバイダーの登録要求を代わりに送信しますが、完了するまで数分かかります。 5 ~ 10 分待ってから、コマンドレットが成功するまでやり直してください。

Standard コンテナーの種類 - パススルー課金

パススルー課金では、従量課金ベースの料金は、SharePoint Embedded アプリケーション (消費テナント) を使用するために登録されたテナントに直接課金されます。開発者テナントの管理者は、パススルー SharePoint Embedded コンテナーの種類を作成するときに Azure 課金プロファイルを設定する必要はありません。

顧客に直接課金されるコンテナーの種類の場合は、フラグ -IsPassThroughBillingを使用します。顧客に直接課金されるコンテナーの種類の場合、課金プロファイルをアタッチする必要はありません。

パススルー課金の標準コンテナーの種類を作成するには、次のコマンドレットを使用します。

New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [-IsPassThroughBilling] [<CommonParameters>]

コンテナーの種類が使用中のテナントに登録されたら、使用しているテナント管理者 (SharePoint 管理またはグローバル管理) は、SharePoint Embedded アプリケーションを使用するために、使用しているテナントに課金プロファイルを設定する必要があります。

テナントを使用して課金プロファイルを設定する

Microsoft 365 管理センターで、[セットアップ] を選択し、[課金とライセンス] セクションを表示します。 [従量課金制サービスのアクティブ化] を選択します。
[ Go to Pay as you go services]\(サービスに移動\) を選択します。
[Syntex サービス] で [アプリ] を選択し、[アプリと SharePoint Embedded] を選択します

[注]Syntex サービスで構成されたサブスクリプションには、Azure 課金ポータルでの従量課金が反映されます。
アプリのみの認証トークンを使用してコンテナーの種類を登録します。

コンテナーの種類の構成

開発者管理者は、作成された SharePoint Embedded コンテナーの種類に対して選択した設定を構成できます。次の表に、使用可能な設定の一覧を示します。

Settings	説明
ApplicationRedirectUrl	アプリケーションのファイルのリダイレクト先の URL を指定します。
CopilotEmbeddedChatHosts	SharePoint Embedded アプリケーションの宣言型エージェントエクスペリエンスを使用できるホスト URL を追加します。
DiscoverabilityDisabled	SharePoint Embedded アプリケーションのコンテンツを Microsoft 365 エクスペリエンス全体で表示するかどうかを決定します。
SharingRestricted	ロールベースのアクセス権を使用して、SharePoint Embedded コンテナーの共有アクセス許可を構成します。オープン共有モデルと制限付き共有モデルの両方をサポートします。制限の厳しい共有が true に設定されている場合、コンテナー内のファイルを共有できるのはマネージャーと所有者だけです。

Set-SPOContainerType コマンドレットを使用すると、管理者はアプリケーションリダイレクト URL を更新できます。 Set-SPOContainerTypeConfiguration コマンドレットを使用すると、管理者はホスト URL を追加し、コンテナーの種類に対して Microsoft 365 コンテンツの検出可能性と共有設定を設定できます。この設定は、コンテナーの種類のすべてのコンテナーインスタンスに適用されます。

例 1

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -DiscoverabilityDisabled $false

例 1 では、このコンテナーの種類の検出可能性をオンにします。このコンテナーの種類内で作成されたすべてのコンテンツは、microsoft 365 エクスペリエンスで検出できます。これには、office.com、onedrive.com、推奨ファイル、その他のインテリジェントな検出エクスペリエンスが含まれます。

例 2

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -SharingRestricted $false

例 2 では、このコンテナーの種類のオープン共有モデルをオンにします。編集アクセス許可を持つコンテナーメンバーとゲストユーザーは、コンテナーの種類内に作成されたファイルを共有できます。

例 3

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -CopilotEmbeddedChatHosts "https://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com"

次の使用例は、ID 4f0af585-8dcc-0000-223d-661eb2c604e4を使用してコンテナーの種類のホスト URL を設定します。

コンテナーの種類の表示

開発者管理は、Get-SPOContainerType を使用してテナントで作成したすべての SharePoint Embedded コンテナーの種類を表示できます。このコマンドレットは、テナント内の SharePoint Embedded Application 用に作成されたコンテナーの種類の一覧を取得して返します。

Get-SPOContainerType [<CommonParameters>]

Get-SPOContainerType コマンドレットの出力例

ContainerTypeId     : 4f0af585-8dcc-0000-223d-661eb2c604e4
ContainerTypeName   : ContosoLegal
OwningApplicationId : a735e4af-b86e-0000-93ba-1faded6c39e1
Classification      : Standard
AzureSubscriptionId : 564e9025-f7f5-xxx9-9ddd-4cdxxxx1755
ResourceGroup       : prod-resources
Region              : EastUS

コンテナーの種類の更新

開発者管理者は、 Set-SPOContainerType を使用して、テナント内の SharePoint Embedded コンテナーの種類を更新できます。このコマンドレットは、試用版、標準、または直接顧客に請求されるコンテナーの種類の 1 つ以上のプロパティ値を変更します。これを使用して、コンテナーの種類名や課金の詳細などの基本情報を更新できます。

基本情報を更新するには、SharePoint Embedded 管理者である必要があります。課金情報を変更するには、コンテナーの種類に関連付けられている既存の課金サブスクリプションと新しい課金サブスクリプションの両方に対する所有者または共同作成者のアクセス権が必要です。

次のプロパティを更新できません:コンテナーの種類 ID と所有アプリケーション ID。

例 1

Set-SPOContainerType -ContainerTypeId da1d89b3-b4cf-4c0a-8e1c-0d131c57544f -OwningApplicationId 12a9d93c-18d7-46a0-b43e-28d20addd56a - ContainerTypeName 'Red Container Type'

例 1 では、コンテナーの種類名を 'Red Container Type' に設定します

例 2

Set-SPOContainerType -ContainerTypeId da1d89b3-b4cf-4c0a-8e1c-0d131c57544f –Azure Subscription 12a9d93c-18d7-46a0-b43e-28d20addd56a -ResourceGroup RG200

例 2 では、コンテナーの種類の課金プロファイルが更新されます。

コンテナーの種類の登録

コンテナーを作成して操作するには、コンテナーの種類を [使用しているテナント] に登録する必要があります。所有アプリケーションは、登録 API を呼び出すことによって、コンテナーの種類のアクセス許可を定義します。

コンテナーの種類の削除

開発者管理者は、試用版と標準の両方のコンテナーの種類を削除できます。コンテナーの種類を削除するには、まず、削除されたコンテナーコレクションのコンテナーを含め、そのコンテナーの種類のすべてのコンテナーを削除する必要があります。コンテナーを削除するには、「テナント管理の使用」を参照してください。すべてのコンテナーが削除されると、開発者管理者は、Remove-SPOContainerTypeを使用してコンテナーの種類を削除できます。

Remove-SPOContainerType [-ContainerTypeId <ContainerTypeId>]

SharePoint 埋め込みメーター

サポートされている従量課金制メーターの詳細については、 SharePoint Embedded のメーターに関する記事を参照してください。

Last updated on 2025-10-09