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. Standardとパススルー コンテナーの種類は、一度作成すると変換できません。 標準のコンテナーの種類を変換して課金をパススルーする場合、またはその逆を行う場合は、コンテナーの種類を削除して再作成する必要があります。
3. コンテナーの種類を構成するには、最新バージョンの SharePoint PowerShell を使用する必要があります。 SharePoint Embedded のWindows PowerShellに関するアクセス許可と最新の情報については、「SharePoint Embedded Management Shell の概要」のドキュメントを参照してください。

コンテナーの種類の作成

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

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

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

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

1. 最新バージョンのSharePoint Online 管理シェルをダウンロードしてインストールする
2. スタート画面からSharePoint Online 管理シェルを開き、「sharepoint」と入力し、[SharePoint Online 管理シェル] を選択します。
3. テナントに関連付けられている管理者資格情報を指定して、 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 の標準コンテナーの種類は、アプリケーションとそのコンテナー間の関係、アクセス権、課金プロファイルを定義します。 アプリケーションがコンテナーと対話する方法 (アクセス許可を含む) が確立され、試用以外の目的で課金プロファイルに関連付けられます。 各テナントには、一度に 5 つのコンテナーの種類を指定できます。

課金プロファイル

SharePoint Embedded は、従量課金制の従量課金制 (PAYG) オファリングです。これは、使用した分だけ支払うことを意味します。 SharePoint Embedded には、SharePoint Embedded アプリケーションを開発しているテナントがそれぞれのコンテナーの種類に応じて選択できる 2 つの課金モデルが用意されており、独自のビジネス要件に合わせて調整できます。 2 つの課金モデルは、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 アプリケーションを使用するために、使用しているテナントに課金プロファイルを設定する必要があります。

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

1. Microsoft 365 管理センターで、[セットアップ] を選択し、[課金とライセンス] セクションを表示します。 [従量課金制サービスのアクティブ化] を選択します。

   

2. [ Go to Pay as you go services]\(サービスに移動\) を選択します。

3. [Syntex サービス] で [アプリ] を選択し、[アプリと SharePoint Embedded] を選択します

   

   [注]Syntex サービスで構成されたサブスクリプションには、Azure 課金ポータルでの使用料金が反映されます。

4. アプリのみの認証トークンを使用してコンテナーの種類を登録します。

コンテナーの種類の構成

開発者管理は、この 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>]

SharePoint 埋め込みメーター

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