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 課金エクスペリエンスの詳細について説明します。
• 構成可能な動作。 コンテナー型は、その型のすべてのコンテナー インスタンスに対して選択した動作を定義します。 コンテナーの種類の構成の設定について詳しくは、こちらをご覧ください。

注:

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

試用版の使用

コンテナーの種類は、試用版/開発目的で作成でき、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/非試用版の使用

標準のコンテナーの種類は課金プロファイルにリンクされます。これは、通常の課金または直接コンシューマーへの課金にすることができます。 各開発者テナントは、最大 5 種類の標準コンテナーを作成できます。 Standardコンテナーの種類は、New-SPOContainerType コマンドレットを使用して作成されます。 通常の課金があるコンテナーの種類の場合は、 Add-SPOContainerTypeBilling コマンドレットを使用して課金プロファイルを作成します。 顧客への直接請求を含むコンテナーの種類の場合は、フラグ -IsPassThroughBillingを使用します。 顧客に直接課金されるコンテナーの種類については、課金プロファイルを添付する必要はありません。

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

• 通常の課金には、Azure portalに Azure サブスクリプションとリソース グループが存在する必要があります。
• アプリの登録は、Microsoft Entra IDで作成する必要があります

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

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

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

注:

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

請求済みの標準コンテナーの種類である顧客への直接の作成には、次のコマンドレットを使用します。

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

コンテナーの種類の構成

開発者管理は、この PowerShell コマンドレットを使用して作成された SharePoint Embedded コンテナーの種類で選択した設定を設定できます。

このコマンドレットを使用すると、管理者はコンテナーの種類に 対して Microsoft 365 コンテンツの検出可能性 と 共有 設定を設定できます。 この設定は、コンテナーの種類のすべてのコンテナー インスタンスに適用されます

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

コンテナーの種類の表示

開発者管理は、テナントで作成したすべての SharePoint Embedded コンテナーの種類を、Get-SPOContainerTypeを使用して表示できます。 このコマンドレットは、テナント内の 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

コンテナーの種類の登録

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

コンテナーの種類の削除

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

Remove-SPOContainerType [-ContainerTypeId <ContainerTypeId>]