次の方法で共有

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 を使用する必要があります。

試用版の使用

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

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

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

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

標準/非試用版の使用

コンテナーの種類は、Azure サブスクリプション ID とリージョン グループを含む Azure 課金プロファイルを使用して作成することもできます。 このコンテナーの種類は標準の状態であり、課金対象です。 標準状態でコンテナーの種類を作成するには、次のものが必要です。

  • Azure サブスクリプションとリソース グループが Azure portal に存在する必要があります
  • アプリの登録は、Microsoft Entra ID で作成する必要があります
  • 各開発者テナントは、標準状態で最大 5 つのコンテナーの種類を作成できます。 作成するには、次の PowerShell コマンドレットを使用します。
New-SPOContainerType
[–ContainerTypeName <ContainerTypeName>]
[-OwningApplicationId <OwningApplicationId>]
[-AzureSubscriptionId <AzureSubscriptionId>]
[-ResourceGroup <ResourceGroup>]
[-Region <Region>]

注:

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

コンテナーの種類の構成

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

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

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

コンテナーの種類の表示

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

Get-SPOContainerType

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 を呼び出すことによって、コンテナーの種類のアクセス許可を定義します。

コンテナーの種類の削除

開発者管理者は、試用版の状態でのみコンテナーの種類を削除できます。 試用版の状態でコンテナーの種類を削除するには、削除されたコンテナー コレクションからを含め、最初にコンテナーの種類のすべてのコンテナーを削除する必要があります。 コンテナーを削除するには、「 テナント管理者の使用」を参照してください。すべてのコンテナーが削除されると、開発者管理者は、次の PowerShell コマンドレットを使用してコンテナーの種類を削除できます。

Remove-SPOContainerType
[-ContainerTypeId <ContainerTypeId>]